Installing the AE Internal Webservice (Tomcat)

The following steps are required for installing and configuring the AE Internal Webservice on a Tomcat application server.

The AE Internal Webservice file is available in the directory IMAGE:WEBSERVICE

Compatibility Matrix:

Incompatible versions are excluded from this view.

	Tomcat 7	Tomcat 8
Java 7
Java 8

To Install the AE Internal Webservice (Tomcat)

Install the Webservice.
- Host
- Assign the role "uc4" to a user by adapting <tomcat>/conf/tomcat-users.xml. Instructions are available on the Tomcat Website.
- Copy the file uc4ws_tomcat.war, rename it into uc4ws.war and paste it into deploy directory of tomcat (<tomcat>/webapps)
- Download the Zip-Distribution of JAX-WS Reference Implementation (RI) from http://search.maven.org/remotecontent?filepath=com/sun/xml/ws/jaxws-ri/2.2.10/jaxws-ri-2.2.10.zip, paste the content of <jaxws>/lib into <tomcat>/webapps/<internal_webservice>/WEB-INF/lib
- After deployment, no error log message should be shown in tomcat-log
- WSDL is available via the following link: http://Server name:Port/uc4ws/uc4ws?wsdl
Configure the Webservice.
- Host
- Call the Configuration WebInterface using the following link:
  http://Server name:Port/uc4ws/admin
- In "Communication Process (host:port)", specify at least one communication process in the format "Server name:Port".
- You can also store a default user and select the operations that he/she can use on the right.
- In the area "Session Handling", determine the connection settings for the Internal Webservice.
  
  Note that the configuration file will be overwritten when you deploy the WAR file again. As a result you will have to redefine your configuration settings. Instead, you can also save a copy of your configuration file (INI file) before you start the deployment and copy it to the folder that includes the web application after the deployment has taken place.