Configuring the Unified Web Services (UWS) Server

The Unified Web Services (UWS) server component is a J2EE Web application that uses the Apache Axis web services library. Even if you are connecting to UWS from .NET, you must deploy the server component on a Java application server.

To deploy the UWS server, follow these steps:

1.	Configure a JAVA_HOME environment variable with the operating system. Set JAVA_HOME=C:\Program Files\Business Objects\JavaSDK
2.	Unzip C:\Program Files\Business Objects\BusinessObjects Enterprise 11\Web Services\dsws_webservice_boe\data\dswsBobjeAssembly.zip to C:\Program Files\Business Objects\. This creates a dswsBobjeAssembly directory.
3.	Change directories to the dswsBobjeAssembly directory. cd C:\Program Files\Business Objects\Assemble\dswsBobjeJava\
4.	Build a WAR file by opening a CMD prompt and calling the dswsBobjeAssemblyEn batch file. > dswsBobjeAssemblyEn.bat <MACHINE NETWORK NAME> <AXIS PORT NUMBER> <CMS NAME> Your code might look like this example: > dswsBobjeAssemblyEn.bat DCAKRINSKYO2.crystald.net 8080 DCAKRINSKY02

A successful build will look something like the console output shown in Figure 32.3.

Figure 32.3. Successful UWS build console output.

5.

Copy the WAR file C:\Program Files\Business Objects\Assemble\dswsBobjeJava\dswsboje.war to Tomcat C:\Program Files\Business Objects\Tomcat\webapps. It will be deployed as an application called dswsbobje.

You can test your configuration by calling a URL such as http://dcakrinskyo2.crystald.net:8080/dswsbobje/happydsws.jsp. At the same time, you should test that the WSDL files deployed by the service are correct by looking in the exploded dswsbobje\WEB-INF\classes directory under Tomcat\webapps. Search for soap:address to find the URL for accessing the various services. Sometimes these services will be on machines that differ from the initial connection URL, so you might need to change them from the defaults. Here's the default which corresponds to the preceding implementation:

[View full width]
<soap:address location="http://DCAKRINSKY02.crystald.net:8080/dswsbobje/services/<SERVICE  NAME>"/>

UWS may also be configured to use SSL. This requires that the client application use an X509 public key certificate for communication. More information on setting up this configuration is not in the core documentation; look for it in a documentation update and/or on the support site.