Running a Legacy SOAP Client API

C Running a Legacy SOAP Client API

Users who have created client applications with now deprecated APIs can run these applications after completing the following procedure.

Extract NNC700WSlassic.zip (contained on the Oracle software distribution CD) to a folder on the client computer. This folder provides the [WSClassicClient_HOME}.
Move existing applications, created with the now deprecated provisioning APIs, to the {WSClassicClient_HOME}/sampleSouce folder.
Delete the directory that previously contained client applications.
Go to {WSClassicClient_HOME}/bin.
Edit run.bat, the file that allows you to run client application code, by changing the JAVA_HOME path variable to match the JDK installation path. In addition, edit the SERVER_NAME and SERVER_PORT variables to match the IP address and port number of the Oracle Communications Session Delivery Manager SOAP API Server.

Note:
Client application code now requires JDK 1.6.0 or later; the latest update is recommended.
Edit build.bat by making the same change to the JAVA_HOME path variable.
The following Step, which imports one or more server certificates to a specific JAVA keystore, is required only if the client interface will run over HTTPS. This Step can be safely ignored if client/server transactions will take place over unsecured HTTP.
1. Use FTP to move a copy of a Oracle Communications Session Delivery Manager SOAP API Server public certificate to the JAVA_HOME location on the client computer.
2. The certificate is usually at opt/AcmePacket/NNC700/ssl/nncentral_server.cer on the Net-Net Central Server.
3. Use the JAVA keytool utility to import the public certificate into a specified JAVA keystore. For example,
```
keytool -import -keystore trustedCerts -alias NNC-01 -file nnC01.cer
```
  imports the certificate file, nnC01.cert, into the keystore named trustedCerts; the keystore file will be referenced by the NNC-01 alias.
  
  Note that you will be prompted for the keystore password before the import operation is initiated.
  
  For example:
```
Owner: EMAILADDRESS=test@test.com, CN=172.30.10.120, OU=NmsCore, 
O=Acme Packet Inc., ST=Some-State, C=AU 
Issuer: EMAILADDRESS=test@test.com, CN=172.30.10.120, OU=NmsCore, 
O=Acme Packet Inc., ST=Some-State, C=AU 
Serial number: 8b4d53819b6dfff1 
Valid from: Tue Nov 14 16:04:53 EST 2006 until: Sat Jan 31 16:04:53 EST 
2015 
Certificate fingerprints: 
MD5: 98:DA:F6:04:A8:A0:CA:D4:33:83:2A:3F:CE:C3:FB:CD 
SHA1: F4:BB:72:7D:43:25:56:86:6A:70:55:27:63:96:D2:13:DF:89:B2:68 
Trust this certificate? [no]: y 
Certificate was added to keystore
```
4. Edit run.bat by changing the TRUST_STORE variable to match the location of the JAVA keystore that contains the public certificates of associated Oracle Communications Session Delivery Manager SOAP API Servers.
5. Edit run.bat by changing the TRUST_STORE_PASSWORD to match the password required to access the JAVA keystore containing the Oracle Communications Session Delivery Manager SOAP API Server certificates.
6. Use the JAVA keytool utility to conform the presence of the key in the keystore. For example,
```
keytool -list -v -keystore trustedCerts
```
  provide a verbose display of the contents of the designated JAVA keystore, in this case, trustedCerts.
  
  Note that you will be prompted for the keystore password before the keystore contents are displayed.
  
  Repeat Steps 7a, 7b, and 7e to import additional Net-Net Central Server certificates to the same JAVA keystore.

If present, comment out the following code in your applications:

/* org.apache.axis.client.Stub yourStub = (Stub) emsLevelStub;// add this line 
yourStub._setProperty(org.apache.axis.MessageContext.HTTP_TRANSPORT_VERSION,
org.apache.axis.transport.http.HTTPConstants.HEADER_PROTOCOL_V11);// add this line 

//For the defect: SocketTimeoutException
org.apache.axis.client.Stub s = (Stub) networkLevelStub; s.setTimeout(1800000);
//30 minutes, 30*60*1000 

*/

Edit {WSClassicClient_HOME}/conf/client.properties by changing the value of the session_timeout_ms property to specify a session timeout value, expressed in milliseconds.
Use build.bat to compile the client application.
Use run.bat to run the client application.