JETTY and JMS Configuration
The WebClient services are based on Eclipse Jetty, a Java HTTP (Web) server and Java Servlet container.
The WebClient services use the Java Message Service (JMS) to communicate with the underlying COBOL applications.
Jetty Configuration
By default the WebClient service starts on localhost on port 8080 while the WebClient Admin Console starts on localhost on port 8090.
You can change these settings by editing the files webclient/jetty.properties and webclient/admin/jetty.properties under the isCOBOL installation folder. It’s good practice to make a backup copy of these files every time you change them, as they may be overwritten by the installation of an isCOBOL SDK update.
Entry | Meaning |
|---|
jetty.webclient.server.host | IP address or machine name where the service listens for connections. Replace ‘localhost’ by the IP of the current PC if you wish to allow connections from other machines in the network. |
jetty.webclient.server.http | Enable or disable listening on the HTTP protocol |
jetty.webclient.server.http.port | Port number the server listens to for HTTP connections |
Note - If you wish to disable the HTTP protocol, don’t comment jetty.webclient.server.http, but set it to "false". If the entry is commented, the service may not start.
The file jetty.properties contains also entries to enable secure HTTP (HTTPS).
Entry | Meaning |
|---|
jetty.webclient.server.https | Enable or disable listening on the HTTPS protocol |
jetty.webclient.server.https.port | Port number the server listens to for HTTPS connections |
jetty.webclient.server.https.truststore | Location of the truststore file |
jetty.webclient.server.https.truststore.password | Truststore password |
jetty.webclient.server.https.keystore | Location of the keystore file |
jetty.webclient.server.https.keystore.password | Keystore password |
Note - These entries point to a self-signed certificate. You should replace them with a valid certificate released by a certificate authority if you wish to use HTTPS.
JMS Configuration
By default JMS uses the port 34455. You can change this port via the webclient.jmsUrl property on the command line.
The value of this property must be specified in the form "nio://<serverNameOrIp>:<port>".
For example, in order to start WebClient on localhost using the port 12345 for JMS, use this command:
• Windows
cd %ISCOBOL%\bin webcclient.exe -J-Dwebclient.jmsUrl=nio://127.0.0.1:12345 |
• Linux
cd $ISCOBOL/bin ./webcclient -J-Dwebclient.jmsUrl=nio://127.0.0.1:12345 |