Configuring the ESP Web Services Provider

Use the esp_wsp.xml and axs2.xml configuration files to configure the ESP Web Services Provider.

1. In the %ESP_HOME%\wsp\esp_wsp.xml file, enable the ESP Web Services Provider by setting <webService enabled ="true">.
2. Set the port number for the SOAP server to which you are connecting the ESP Web Services Provider, the protocol, and if you are using HTTPS protocol, specify the keystore type, file, and password. For example:

   <webService enabled="true">
   	<soapPort>9090</soapPort>
   	<protocol>http</protocol>
   	<Security>
   		<Keystore>
   			<Type>JKS</Type>
   			<File>keystore.jks</File>
   			<Password></Password>
   		</Keystore>
   	</Security>
   </webService>

   The ESP Web Services Provider ignores the security section if you are using HTTP protocol.

3. In your Web service client code, specify values for the authType and cred parameters. Valid values and syntax are:

   Authentication Type	Parameters and Values
   RSA	authType=rsa cred=keystore:user:password Note: For the keystore parameter, enter the full path to the keystore file. If you are using Windows, surround the file path in single quotation marks.
   Username/Password	authType=user cred=user:password
   Kerberos	authType=kerberos cred=user:service:cache Note: For the Kerberos parameter, enter the full path to the Kerberos cache file. If you are using Windows, surround the file path in single quotation marks.

   See the %ESP_HOME%\examples\java\wspexample\src\com\sybase\esp\wsp\example\WSPExample.java file for an example of Web service client code.

4. (If Kerberos authentication is enabled on the ESP Server) In the %ESP_HOME%\wsp\esp_wsp.bat or $ESP_HOME/wsp/esp_wsp.sh script, add:

   -Djava.security.krb5.realm=<RealmName> -Djava.security.krb5.kdc=<ServerName> 

5. In the %ESP_HOME%\wsp\webapps\axis2\WEB-INF\conf\axis2.xml file, set the HTTP and HTTPS listening ports for the SOAP server. For example:
   HTTP:

   <transportReceiver name="http" class="org.apache.axis2.transport.http.AxisServletListener">
                 <parameter name="port">8080</parameter>
          </transportReceiver>

   HTTPS:

   <transportReceiver name="https" class="org.apache.axis2.transport.http.AxisServletListener"> 
                 <parameter name="port">8443</parameter> 
          </transportReceiver>

• Use the esp_wsp.bat or esp_wsp.sh file to start the SOAP server.
• You can access the ESP Web Service Provider WSDL through http://<hostname>:<port>/espws/services/ESPWebService?wsdl.
• To expose a project as a Web service using the ESP Web Services Provider, set the Web Service Enabled option in the ccr file to true and stop and remove the project from the node, then redeploy (add) the project. You can also restart the cluster server instead of redeploying the project.