4.6.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 the execution status (In Progress, Waiting for Response, Abnormal Detection, or Terminated), 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:

Stop the JP1/AO service.

For non-cluster systems:

Execute the hcmdssrv command with /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:

The settings to be changed depend on the communication protocol between the JP1/AO and the Web browser.
If the communication protocol is HTTP:
- Listen in Common-Component-installation-folder\httpsd\conf\httpsd.conf
  
  Specify the new number in the place of 23015 in the following lines:
```
Listen 23015
Listen [::]:23015
```
  In a cluster system, make the settings the same on both the active server and the standby server.
- hsso.hostport in Common-Component-installation-folder\conf\hsso.conf
  
  In a cluster system, make the settings the same on both the active server and the standby server.
- command.http.port in command_user.properties
  
  The folder that contains the definition files is different for non-cluster systems and cluster systems.
  
  For non-cluster systems:
  
  JP1/AO-installation-folder\conf
  
  For cluster systems:
  
  shared-folder-name\jp1ao\conf
If the communication protocol is HTTPS:
Listen and VirtualHost host-name:port-number in Common-Component-installation-folder\httpsd\conf\httpsd.conf

Specify the new number in the place of 23016 in the following lines:
```
Listen 23016
Listen [::]:23016
<VirtualHost *:23016>
```
Execute the hcmdsfwcancel command to register exceptions to the firewall.

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

For non-cluster systems:

Execute the hcmdssrv command with the /start option specified.

For cluster systems:

Use the cluster software to bring the service online.
Execute the hcmdschgurl command to update the URL.

Related topics

JP/AO services in the Job Management Partner 1/Automatic Operation Administration Guide
4.7 Procedure to change the URL

To Page Top