4.5.1 Procedure to change the port number used for communications between JP1/AO and Web browsers

To change the port number used for communications between JP1/AO and Web browsers, you must edit the definition file and register exceptions in the firewall.

For a cluster system, perform the same procedure on both the active server and the standby server.

Before you begin

Make sure that there are no tasks that are waiting or running in JP1/AO.

In the Tasks window, check the tasks. If any tasks are in execution status (In Progress, Waiting for Input, In Progress (with Error), In Progress (Terminating), or Long Running), stop execution of the tasks or wait until the task status changes to the ended status.

To change the port number between JP1/AO and Web browsers (if the communication protocol is HTTP):

Stop the JP1/AO service.

For non-cluster systems:

Execute the hcmds64srv command with the stop option specified.

For cluster systems:

Use the cluster software to bring the service offline.
Change the port number settings by editing the keys in the definition files as follows:
- Listen in Common-Component-installation-folder\uCPSB\httpsd\conf\user_httpsd.conf (in Windows), /opt/HiCommand/Base64/uCPSB/httpsd/conf/user_httpsd.conf (in Linux 6, Linux 7, SUSE Linux 12), or /opt/HiCommand/Base64/uCPSB11/httpsd/conf/user_httpsd.conf (in Linux 8)
  
  Specify the new number in place of 22015 on the following lines:
```
Listen [::]:22015
Listen 22015
```
  In a cluster system, specify the same settings on both the active server and the standby server.
- command.http.port in command_user.properties
  
  The folder that contains the above definition file is different for non-cluster systems and cluster systems.
  
  For non-cluster systems:
  
  JP1/AO-installation-folder\conf or /opt/jp1ao/conf
  
  For cluster systems:
  
  shared-folder-name\jp1ao\conf or shared-folder-name/jp1ao/conf
- server.http.port in config_user.properties
  
  The folder that contains the above definition file is different for non-cluster systems and cluster systems.
  
  For non-cluster systems:
  
  JP1/AO-installation-folder\conf or /opt/jp1ao/conf
  
  For cluster systems:
  
  shared-folder-name\jp1ao\conf or shared-folder-name/jp1ao/conf
If the OS is Windows, execute the hcmds64fwcancel command to register exceptions in the firewall.

If the OS is Linux, register exceptions according to OS specifications. For details about the procedure, see the documentation for the OS.

In a cluster system, perform this step on both the active server and the standby server.
Start the JP1/AO service.

For non-cluster systems:

Execute the hcmds64srv command with the start option specified.

For cluster systems:

Use the cluster software to bring the service online.
Execute the hcmds64chgurl command to update the URL.
If the OS of the JP1/AO server is Windows, change the port number in the URL of the shortcut file to the page displayed by performing the following operation:

From the Start menu, select All Program, JP1_Automatic Operation, and then JP1_AO Login.

To change the port number between JP1/AO and Web browsers (if the communication protocol is HTTPS):

Stop the JP1/AO service.

For non-cluster systems:

Execute the hcmds64srv command with the stop option specified.

For cluster systems:

Use the cluster software to bring the service offline.
Change the port number settings by editing the keys in the definition files as follows:

Listen and VirtualHost host-name:port in Common-Component-installation-folder\uCPSB\httpsd\conf\user_httpsd.conf (in Windows), /opt/HiCommand/Base64/uCPSB/httpsd/conf/user_httpsd.conf (in Linux 6, Linux 7, SUSE Linux 12), or /opt/HiCommand/Base64/uCPSB11/httpsd/conf/user_httpsd.conf (in Linux 8)

Specify the new number in the place of 22016 on the following lines:
```
Listen [::]:22016
Listen 22016
<VirtualHost *:22016>
```
If the OS is Windows, execute the hcmds64fwcancel command to register exceptions in the firewall.

If the OS is Linux, register exceptions according to OS specifications. For details about the procedure, see the documentation for the OS.

In a cluster system, perform this step on both the active server and the standby server.
Start the JP1/AO service.

For non-cluster systems:

Execute the hcmds64srv command with the start option specified.

For cluster systems:

Use the cluster software to bring the service online.
Execute the hcmds64chgurl command to update the URL.
If the OS of the JP1/AO server is Windows, change the port number in the URL of the shortcut file to the page displayed by performing the following operation:

From the Start menu, select All Program, JP1_Automatic Operation, and then JP1_AO Login.

Notes:

If JP1/OA, Hitachi Command Suite products, or Hitachi Ops Center products are installed, the port number of JP1/OA, Hitachi Command Suite products, or Hitachi Ops Center products also changes. For details, see the manual of JP1/OA, Hitachi Command Suite products, or Hitachi Ops Center products.
If you are using JP1/IM monitor startup and you perform a monitor startup of JP1 events before the port number is changed, the monitor startup fails.