Configuration

Web UI application server configuration

The Apache Tomcat web application server supplied with C\Prof is configured using the server.xml file located in the conf directory. If you have used the C\Prof ISPF dialog to install the web server, the server.xml file will have been configured with the options you supplied.

If you need to add or change the behavior of the web server, you can adjust the server.xml file. The structure of this file is described in the Apache Tomcat 8 Configuration Reference. Changes to server.xml will take effect after you have restarted the server.

Changing the web server connection type

Two common changes that may be made to server.xml are to change TCP port numbers, or to switch from unsecured HTTP connections to secure HTTPS connections. These settings are configured using the <Connector> statement. For more information, see The HTTP Connector in the Apache Tomcat 8 Configuration Reference.

Examples using the <Connector> statement can be found below.

HTTP connection

The following example configures the web server to allow unsecured connections on port 9070 using HTTP.

<Connector port="9070" protocol="HTTP/1.1"                              
           connectionTimeout="20000"/>

HTTPS connection

The following example configures the web server to allow secure connections on port 9073 using HTTPS with a SAF keyring for user ID USR1 named CProfKeyring.TXCSRVR:

<!-- Define a SSL/TLS HTTP/1.1 Connector on port 9073 -->                       
<Connector port="9073" maxHttpHeaderSize="8192"                            
      maxThreads="150" minSpareThreads="25" maxSpareThreads="75"           
      enableLookups="false" disableUploadTimeout="true"                    
      SSLEnabled="true"                                                    
      acceptCount="100" scheme="https" secure="true"                       
      clientAuth="false" sslProtocol="TLS"                                 
      sslEnabledProtocols="TLSv1.2,TLSv1.1,TLSv1"                          
      keystorePass="password"                                              
      keystoreType="JCERACFKS"                                             
      keystoreFile="safkeyring://USR1/CProfKeyring.TXCSRVR" />

To create a keyring for the C\Prof Web UI application server, see Generating a keyring and certificate for secure connections.

Note: For more on configuring SSL, see Apache Tomcat 8: SSL/TLS Configuration HOW-TO