Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


3.4.5 Details on the settings in the HTTP server definition file (httpsd.conf)

This subsection describes the details on the format of settings and the items to be set in the HTTP server definition file (httpsd.conf).

Organization of this subsection

(1) File storage folder

The following shows the folder storing the httpsd.conf file.

JP1/AJS3-Web-Console-installation-folder\uCPSB\httpsd\conf

(2) File-editing procedure

The following describes the procedure for editing the httpsd.conf file. If you are operating in a cluster environment, follow the edit procedure to set the same definitions for the secondary node as those set for the primary node.

  1. Stop the JP1/AJS3 HTTP Server service.

  2. Back up the httpsd.conf file, and store the backup file in any folder.

  3. Open the httpsd.conf file by using a text editor.

  4. Modify the definitions to be changed.

  5. Save the httpsd.conf file by using UTF-8 encoding.

  6. Start the JP1/AJS3 HTTP Server service.

(3) When the setting takes effect

When the JP1/AJS3 HTTP Server service starts

(4) Format

The following shows the format of settings in the httpsd.conf file:

(omitted)
  
ServerRoot "JP1/AJS3-Web-Console-installation-folder/uCPSB/httpsd"
  
ServerName host-name-of-Web-Console-server
DocumentRoot "JP1/AJS3-Web-Console-installation-folder/uCPSB/httpsd/htdocs"
  
(omitted)
  
Listen port-number-for-the-reception-of-connection-requests-from-web-browser
#Listen [::]:port-number-for-the-reception-of-connection-requests-from-web-browser
SSLDisable
  
#Listen port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication
#Listen [::]:port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication
#<VirtualHost *:port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication>
#  ServerName host-name-of-Web-Console-server
#  SSLEnable
#  SSLCertificateFile "JP1/AJS3-Web-Console-installation-folder/uCPSB/httpsd/conf/ssl/server/name-of-server-certification-file"
#  SSLCertificateKeyFile "JP1/AJS3-Web-Console-installation-folder/uCPSB/httpsd/conf/ssl/server/name-of-private-key-file"
#  AllowEncodedSlashes On
#</VirtualHost>
  
Include "JP1/AJS3-Web-Console-installation-folder/uCPSB/CC/web/redirector/mod_jk.conf"
  
Include "JP1/AJS3-Web-Console-installation-folder/uCPSB/CC/web/redirector/mod_jk.conf"

Note that lines beginning with a hash mark (#) are comment lines.

(5) Setting items

The following describes the items to be set.

(a) JP1/AJS3 - Web Console installation folder

The installation folder for JP1/AJS3 - Web Console is set automatically.

You do not need to change this setting at setup.

(b) Host name of Web Console server

The host name of a Web Console server is set automatically.

If you have changed the host name of the Web Console server, change this setting manually.

(c) Port number for the reception of connection requests from a web browser

When not using SSL communication, specify the port number of the port at which the Web Console server receives connection requests from the web browser. The default is 22252.

If you have changed the port number for the reception of connection requests from the web browser, change the port number setting.

(d) Port number for the reception of connection requests from a web browser during SSL communication

When using SSL encryption for communication between the Web Console server and a web browser, specify the port number of the port at which the Web Console server receives connection requests from the web browser. The default is 22253.

To enable SSL communication, delete the hash mark (#) at the beginning of the definition line. If you have changed the port number for the reception of SSL communication from the web browser from the default setting, change the port number setting.

For details, see 21.4 Setting up the communication using SSL.

(e) Name of server certification file

When using SSL encryption for communication between the Web Console server and web browser, specify the name of the server certification file obtained from the CA. The default is httpsd.pem.

To enable SSL communication, delete the hash mark (#) at the beginning of the definition line, and then change the default setting to the name of the server certification file.

For details, see 21.4 Setting up the communication using SSL.

(f) Name of private key file

When using SSL encryption for communication between the Web Console server and web browser, specify the name of the private key file. The default is httpsdkey.pem.

To enable SSL communication, delete the hash mark (#) at the beginning of the definition line, and then change the default setting to the name of the private key file.

For details, see 21.4 Setting up the communication using SSL.

(6) Note

If a setting is invalid, the JP1/AJS3 HTTP Server service cannot start.