3.4.11 Setup required to upgrade the version of JP1/AJS3 - Web Console

If you perform upgrade installation of JP1/AJS3 - Web Console to upgrade it from a version earlier than 13-00 to 13-00 or a later version, the settings in the settings files on the Web Console server are reset to the default values. Therefore, if the settings of the setup items listed in the following table were changed in a version earlier than 13-00, you must manually respecify the settings after installing JP1/AJS3 - Web Console. Note that the files that were used in a version earlier than 13-00 are backed up to the JP1/AJS3-installation-folder\sys\bk folder.

The following table lists the setup items that you must respecify after upgrading the version of JP1/AJS3 - Web Console.

Table 3‒10: Setup items you must respecify after upgrading the version
No.	Setup item	Settings files		Reference
No.	Setup item	Earlier than version 13-00	Version 13-00 and later	Reference
1	The host name of the Web Console server was changed	HTTP server definition file (`httpsd.conf`)		(1)
2	SSL communication was enabled	HTTP server definition file (`httpsd.conf`)		(2)
3	The number of the port used to accept connection requests from web browsers was changed (if SSL communication is not used)	HTTP server definition file (`httpsd.conf`)		(3)
4	The number of the port used for internal management of the J2EE server was changed	User properties file for J2EE server (`usrconf.properties`)		(4)
5	The number of the port used for communication between the HTTP and J2EE servers was changed	Worker definition file (`workers.properties`) User properties file for J2EE server (`usrconf.properties`)	HTTP server definition file (`httpsd.conf`) User properties file for J2EE server (`usrconf.properties`)	(5)
6	The maximum Java heap size was changed	Option definition file for J2EE server (`usrconf.cfg`)		(6)

Organization of this subsection

(1) The host name of the Web Console server was changed
(2) SSL communication was enabled
(3) The number of the port used to accept connection requests from web browsers was changed
(4) The number of the port used for internal management of the J2EE server was changed
(5) The number of the port used for communication between the HTTP and J2EE servers was changed
(6) The maximum Java heap size was changed

(1) The host name of the Web Console server was changed

If the host name of the Web Console server was changed, then you must respecify the settings in the HTTP server definition file (httpsd.conf).

For details about the HTTP server definition file (httpsd.conf), see 3.4.5 Details on the settings in the HTTP server definition file (httpsd.conf).

The following table lists the settings that you must respecify.

Table 3‒11: Settings you must respecify if the host name of the Web Console server was changed
No.	Setting items	Description
1	`ServerName` `host-name-of-Web-Console-server`	For `host-name-of-Web-Console-server`, set the value that was set before the version was upgraded.
2	`# ServerName` `host-name-of-Web-Console-server`	You must respecify this item if SSL communication was enabled. Uncomment the line of the `<VirtualHost>` entry, and then, for `host-name-of-Web-Console-server`, set the value that was set before the version was upgraded.

To Page Top

(2) SSL communication was enabled

If SSL communication was enabled, then you must respecify the settings in the HTTP server definition file (httpsd.conf).

For details about the HTTP server definition file (httpsd.conf), see 3.4.5 Details on the settings in the HTTP server definition file (httpsd.conf).

The following table lists the settings that you must respecify.

Table 3‒12: Settings you must respecify if SSL communication was enabled
No.	Setting items		Description
1	`#LogFormat "%t %{version}c %{cipher}c %{clientcert}c" hws_ssl`		Uncomment the line.
2	`#CustomLog "\|\"\"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/sbin/rotatelogs2.exe\" \"C:/Program Files/HITACHI/JP1AJS3WEB/uCPSB/httpsd/logs/ssl\" 10240 8\"" hws_ssl`		Uncomment the line.
3	`Listen` `port-number-for-the-reception-of-connection-requests-from-web-browser`		Comment out the line by adding a hash mark (`#`) at the beginning of the line.
4	`#Listen` `port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication`		Uncomment the line, and then, for `port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication`, set the value that was set before the version was upgraded.
5	`#<VirtualHost *:port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication>` to `#</VirtualHost>`		Uncomment this and subsequent lines up to the end-tag line, and then respecify the settings of the lines as follows.
6		`#<VirtualHost *:port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication>`	For `port-number-for-the-reception-of-connection-requests-from-web-browser-during-SSL-communication`, set the value that was set before the version was upgraded.
7		`# SSLCertificateFile "JP1/AJS3-Web-Console-installation-folder/uCPSB/httpsd/conf/ssl/server/name-of-server-certification-file"`	For `JP1/AJS3-Web-Console-installation-folder` and `name-of-server-certification-file`, set the value that was set before the version was upgraded. If intermediate certificate files were used for SSL communication, open the server certificate and intermediate certificates with a text editor. Then, copy the content of the intermediate certificates to the server certificate so that the server certificate contains the following items in the indicated order: Server certificates Intermediate certificates Cross signed root certificates^#
8		`# SSLCertificateKeyFile "JP1/AJS3-Web-Console-installation-folder/uCPSB/httpsd/conf/ssl/server/name-of-private-key-file"`	For `JP1/AJS3-Web-Console-installation-folder` and `name-of-private-key-file`, set the value that was set before the version was upgraded.

#: This item is required only when you use a cross signed root certificate.

To Page Top

(3) The number of the port used to accept connection requests from web browsers was changed

If SSL communication was not used and the number of the port used to accept connection requests from web browsers was changed, then you must respecify the settings in the HTTP server definition file (httpsd.conf).

For details about the HTTP server definition file (httpsd.conf), see 3.4.5 Details on the settings in the HTTP server definition file (httpsd.conf).

The following table lists the settings that you must respecify.

Table 3‒13: Settings you must respecify if the number of the port used to accept connection requests from web browsers was changed
No.	Setting items	Description
1	`Listen` `port-number-for-the-reception-of-connection-requests-from-web-browser`	For `port-number-for-the-reception-of-connection-requests-from-web-browser`, set the value that was set before the version was upgraded.

To Page Top

(4) The number of the port used for internal management of the J2EE server was changed

If the number of the port used for internal management of the J2EE server was changed, then you must respecify the settings in the user properties file for J2EE server (usrconf.properties).

For details about the user properties file for J2EE server (usrconf.properties), see 3.4.6 Details on the settings in the user properties file for J2EE server (usrconf.properties).

The following table lists the settings that you must respecify.

Table 3‒14: Settings you must respecify if the number of the port used for internal management of the J2EE server was changed
No.	Setting items	Description
1	`ejbserver.http.port=port-number-for-the-internal-management-of-J2EE-server`	For `port-number-for-the-internal-management-of-J2EE-server`, set the value that was set before the version was upgraded.
2	`#ejbserver.rmi.naming.port=port-number-for-the-internal-management-of-J2EE-server`	Uncomment the line, and then, for `port-number-for-the-internal-management-of-J2EE-server`, set the value that was set before the version was upgraded.

To Page Top

(5) The number of the port used for communication between the HTTP and J2EE servers was changed

If the number of the port used for communication between the HTTP and J2EE servers was changed, then you must respecify the settings in the HTTP server definition file (httpsd.conf) and user properties file for J2EE server (usrconf.properties).

For details about the HTTP server definition file (httpsd.conf), see 3.4.5 Details on the settings in the HTTP server definition file (httpsd.conf).

For details about the user properties file for J2EE server (usrconf.properties), see 3.4.6 Details on the settings in the user properties file for J2EE server (usrconf.properties).

The following table lists the settings that you must respecify.

Table 3‒15: Settings you must respecify if the number of the port used for communication between the HTTP and J2EE servers was changed
No.	Settings files	Setting items	Description
1	HTTP server definition file (`httpsd.conf`)	`ProxyPass /ajs/ http://localhost:port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers/ajs/ timeout=3600 connectiontimeout=30`	For `port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers`, set the value that was set for the `worker.worker1.port` entry in the worker definition file (`workers.properties`)^# before the version was upgraded.
2	HTTP server definition file (`httpsd.conf`)	`ProxyPassReverse /ajs/ http://localhost:port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers/ajs/`	For `port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers`, set the value that was set for the `worker.worker1.port` entry in the worker definition file (`workers.properties`)^# before the version was upgraded.
3	User properties file for J2EE server (`usrconf.properties`)	`webserver.connector.nio_http.port=port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers`	For `port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers`, set the value that was set for the `webserver.connector.ajp13.port` entry before the version was upgraded.

#: This is a file that was used in 12-60 and earlier versions.

To Page Top

(6) The maximum Java heap size was changed

If the maximum Java heap size was changed, then you must respecify the settings in the option definition file for J2EE server (usrconf.cfg).

For details about the option definition file for J2EE server (usrconf.cfg), see 3.4.8 Details on the settings in the option definition file for J2EE server (usrconf.cfg).

The following table lists the settings that you must respecify.

Table 3‒16: Settings you must respecify if the maximum Java heap size was changed
No.	Setting items	Description
1	`add.jvm.arg=-Xmxthe maximum size of Java heap available to applications on the Web Console serverm`	For `the maximum size of Java heap available to applications on the Web Console server`, set the value that was set before the version was upgraded.

To Page Top