7.9.2 Changing the IP address of the host that runs JP1/AJS3

We will explain the procedures for changing the IP address of the host that runs JP1/AJS3 and changing the IP address found from the real host name separately for JP1/AJS3 - Manager, JP1/AJS3 - Agent, JP1/AJS3 - Web Console, and JP1/AJS3 - View.

Organization of this subsection

(1) Notes on changing the IP addresses
(2) Procedure for changing the IP address of JP1/AJS3 - Manager
(3) Procedure for changing the IP address of JP1/AJS3 - Agent
(4) Procedure for changing the IP address of JP1/AJS3 - Web Console
(5) Procedure for changing the IP address of JP1/AJS3 - View

(1) Notes on changing the IP addresses

Changing the IP address found from the real host name refers to changing the hosts file, DNS, jp1hosts information, and jp1hosts2 information to change the IP address that is found as a result of performing name resolution for the execution host name.
When the jp1hosts information or jp1hosts2 information of a host that is running is changed or the IP address of a DNS server is changed, the IP address after the change is applied to JP1/AJS3 after JP1/AJS3 restarts. For this reason, if you change the IP address without stopping JP1/AJS3, communication by using the IP address before the change is attempted, and symptoms such as jobs ending abnormally might occur. Before changing an IP address, stop the JP1/AJS3 services. However, if you are adding new jp1hosts2 information, stopping the JP1/AJS3 services is unnecessary.
For a host that is running, if you want to install or uninstall the IPv4/IPv6 protocol, or to enable or disable the IPv4/IPv6 protocol, stop the JP1/AJS3 services and then perform the operation.

To Page Top

(2) Procedure for changing the IP address of JP1/AJS3 - Manager

Before changing the IP address of JP1/AJS3 - Manager, perform the following.

Preparation

Make sure that the following operations are not performed from another host to the manager host whose IP address is to be changed.

- Logging in or performing operations from JP1/AJS3 - View or JP1/AJS3 - Web Console

- Executing APIs

- Executing remote commands

- Executing remote jobnets

- Executing jobs for which the execution destination of the job is the manager host whose IP address is to be changed

- Controlling the execution order of root jobnets between different scheduler services that use jobnet connectors or connection-destination jobnets of the manager host whose IP address is to be changed
Make sure that queueless jobs are not being executed.

If you change the IP address of the manager host while a queueless job is running on an agent host, the end status of the job becomes Unknown end status on the manager host. To change the IP address, be sure to make sure that queueless jobs are not being executed. In addition, if the end status of a job becomes Unknown end status, check the end status of the job from the queueless log file of the agent host.

The procedure for changing the IP address of JP1/AJS3 - Manager is as follows.

Log off from JP1/AJS3 - View and JP1/AJS3 - Web Console.
Stop the JP1/AJS3 services on the manager host.

For details on JP1/AJS3 services, see 4.2.1 Types of JP1/AJS3 services in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

For details on how to stop JP1/AJS3 services manually, see 6.1.2 Stopping JP1/AJS3 services manually.

In addition, for the JP1/AJS3 services, stop the services on the physical host and all logical hosts.

Perform the following procedure as required.

No.	Condition	Work performed
1	If all of the following are met: You are using the operation restriction function of the Web GUI (Job Portal) of JP1/AJS3 - Web Console. You logged in to the manager host by specifying the IP address.	Back up the operating permission configuration file Before changing the IP address of the manager host, acquire a backup of the operating permission configuration file that is applied to the manager host. For details on the operating permission configuration file, see 15.4.2 Customizing the operation restriction settings for each user in the JP1/Automatic Job Management System 3 Operator's Guide.

No.

Condition

Work performed

If all of the following are met:

You are using the operation restriction function of the Web GUI (Job Portal) of JP1/AJS3 - Web Console.
You logged in to the manager host by specifying the IP address.

Back up the operating permission configuration file

Before changing the IP address of the manager host, acquire a backup of the operating permission configuration file that is applied to the manager host.

For details on the operating permission configuration file, see 15.4.2 Customizing the operation restriction settings for each user in the JP1/Automatic Job Management System 3 Operator's Guide.

Change the IP address of the manager host.

Change the IP address of the manager host.

Note that it must be possible to perform name resolution for the IP address after the change from the other hosts that communicate with the relevant manager host (such as the JP1/AJS3 - View host, the JP1/AJS3 - Web Console server, job-execution-destination agent hosts, and other manager hosts that are the execution sources of remote jobnets, etc.).

Change the hosts files, etc., on those hosts so that the changed IP address is found from the manager host name.

For notes on changing the settings of the hosts file, etc., see (1) Notes on changing the IP addresses.

Perform the following procedure as required.

No.	Condition	Work performed
1	If all of the following are met: You are using the connection-destination host restriction function of JP1/AJS3 - Web Console. The IP address is specified for a manager host for which connection is to be permitted.	Reconfigure the environment-settings file. It is necessary to change the environment-settings file (`ajs3web.conf`). For details on the environment-settings file (`ajs3web.conf`), see 3.4.3 Details on the settings in the environment-settings file (ajs3web.conf) in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 13.3.3 Details on settings in the environment-settings file (ajs3web.conf) in the JP1/Automatic Job Management System 3 Configuration Guide (for Linux).
2	If all of the following are met: An event job has been executed from another manager host to the manager host whose IP address was changed. The option for changing the agent host information to be used for name resolution is not enabled.	Reconfigure name resolution for event jobs. One of the following operations is necessary on the other manager host for which the execution destination of event jobs is the manager host whose IP address was changed. - Restart the JP1/AJS3 services. - Execute the `ajsagtdel` command and the `ajsagtadd` command to reregister the execution agent for which the manager host whose IP address was changed is defined as the execution host to the manager host. Note that, if the option for changing the agent host information to be used for name resolution is enabled, work on other manager hosts is unnecessary. For details on the option for changing the agent host information to be used for name resolution, see 6.3.18 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 15.3.17 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX).

No.

Condition

Work performed

If all of the following are met:

You are using the connection-destination host restriction function of JP1/AJS3 - Web Console.
The IP address is specified for a manager host for which connection is to be permitted.

Reconfigure the environment-settings file.

It is necessary to change the environment-settings file (ajs3web.conf).

For details on the environment-settings file (ajs3web.conf), see 3.4.3 Details on the settings in the environment-settings file (ajs3web.conf) in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 13.3.3 Details on settings in the environment-settings file (ajs3web.conf) in the JP1/Automatic Job Management System 3 Configuration Guide (for Linux).

If all of the following are met:

An event job has been executed from another manager host to the manager host whose IP address was changed.
The option for changing the agent host information to be used for name resolution is not enabled.

Reconfigure name resolution for event jobs.

One of the following operations is necessary on the other manager host for which the execution destination of event jobs is the manager host whose IP address was changed.

- Restart the JP1/AJS3 services.

- Execute the ajsagtdel command and the ajsagtadd command to reregister the execution agent for which the manager host whose IP address was changed is defined as the execution host to the manager host.

Note that, if the option for changing the agent host information to be used for name resolution is enabled, work on other manager hosts is unnecessary.

For details on the option for changing the agent host information to be used for name resolution, see 6.3.18 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 15.3.17 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX).

If necessary, start the services you stopped in step 2.

If you want to connect to the physical host of JP1/AJS3 - Manager by specifying the IP address for Host to connect on the Login screen of JP1/AJS3 - View, be sure to connect by using the IP address corresponding to the physical host name.

Perform the following procedure as required.

No.	Condition	Work performed
1	If all of the following are met: You are using the operation restriction function of the Web GUI (Job Portal) of JP1/AJS3 - Web Console. You logged in by specifying an IP address for Host to connect on the Login screen of JP1/AJS3 - Web Console.	Reconfigure the operating permission configuration file. Log in to Web GUI (Job Portal) by using the IP address after the change of the manager host, and then apply the operating permission configuration file that you backed up. For details on the operating permission configuration file, see 15.4.2 Customizing the operation restriction settings for each user in the JP1/Automatic Job Management System 3 Operator's Guide.
2	If all of the following are met: The unit to be monitored is displayed in the Detail Information area of the Dashboard screen of JP1/AJS3 - Web Console. You logged in by specifying an IP address for Host to connect on the Login screen of JP1/AJS3 - Web Console.	Reconfigure the unit to be monitored. If the conditions are met and you log in to the manager host by using the IP address after the change of the manager host, the unit to be monitored that was displayed in the Detail Information area prior to the IP address change will no longer be displayed. For this reason, after logging in by using the IP address after the change, select the unit you want to monitor in the Set Monitoring Targets dialog box to display the unit to be monitored in the Detail Information area.
3	If all of the following are met: The unit to be monitored is displayed in the summary list of the JP1/AJS3 - View window (Summary Monitor window) of JP1/AJS3 - View. You logged in by specifying an IP address for Host to connect on the Login screen of JP1/AJS3 - View.	Reconfigure unit to be monitored. If the conditions are met and you log in to the manager host by using the IP address after the change of the manager host, the unit to be monitored that was displayed in the summary list will no longer be displayed. For this reason, after logging in by using the IP address after the change, select the unit you want to monitor in the Monitoring Unit Select dialog box to display the unit to be monitored in the summary list.

No.

Condition

Work performed

If all of the following are met:

You are using the operation restriction function of the Web GUI (Job Portal) of JP1/AJS3 - Web Console.
You logged in by specifying an IP address for Host to connect on the Login screen of JP1/AJS3 - Web Console.

Reconfigure the operating permission configuration file.

Log in to Web GUI (Job Portal) by using the IP address after the change of the manager host, and then apply the operating permission configuration file that you backed up. For details on the operating permission configuration file, see 15.4.2 Customizing the operation restriction settings for each user in the JP1/Automatic Job Management System 3 Operator's Guide.

If all of the following are met:

The unit to be monitored is displayed in the Detail Information area of the Dashboard screen of JP1/AJS3 - Web Console.
You logged in by specifying an IP address for Host to connect on the Login screen of JP1/AJS3 - Web Console.

Reconfigure the unit to be monitored.

If the conditions are met and you log in to the manager host by using the IP address after the change of the manager host, the unit to be monitored that was displayed in the Detail Information area prior to the IP address change will no longer be displayed.

For this reason, after logging in by using the IP address after the change, select the unit you want to monitor in the Set Monitoring Targets dialog box to display the unit to be monitored in the Detail Information area.

If all of the following are met:

The unit to be monitored is displayed in the summary list of the JP1/AJS3 - View window (Summary Monitor window) of JP1/AJS3 - View.
You logged in by specifying an IP address for Host to connect on the Login screen of JP1/AJS3 - View.

Reconfigure unit to be monitored.

If the conditions are met and you log in to the manager host by using the IP address after the change of the manager host, the unit to be monitored that was displayed in the summary list will no longer be displayed.

For this reason, after logging in by using the IP address after the change, select the unit you want to monitor in the Monitoring Unit Select dialog box to display the unit to be monitored in the summary list.

To Page Top

(3) Procedure for changing the IP address of JP1/AJS3 - Agent

Before changing the IP address of JP1/AJS3 - Agent, perform the following.

Preparation: Examine to make sure that jobs are not executed from another host to the agent host whose IP address is to be changed.

The procedure for changing the IP address of JP1/AJS3 - Agent is as follows.

Stop the JP1/AJS3 services of the agent host.

For details on JP1/AJS3 services, see 4.2.1 Types of JP1/AJS3 services in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

For details on how to stop JP1/AJS3 services manually, see 6.1.2 Stopping JP1/AJS3 services manually.

In addition, for the JP1/AJS3 services, stop the services on the physical host and all logical hosts.
Change the IP address of the agent host.

Change the IP address of the agent host.

Note that it must be possible to perform name resolution for the IP address of the agent host from the other hosts that communicate with the relevant agent (such as manager hosts that are the execution source of jobs).

Change the hosts files, etc., on those other hosts so that the changed IP address is found from the agent host name.

For notes on changing the settings of the hosts file, etc., see (1) Notes on changing the IP addresses.

Perform the following procedure as required.

No.	Condition	Work performed
1	If all of the following are met: An event job has been executed on the agent host whose IP address was changed. The option for changing the agent host information to be used for name resolution is not enabled.	Reconfigure name resolution for event jobs. One of the following operations is necessary on the manager host for which the event job is defined. - Restart the JP1/AJS3 services. - Execute the `ajsagtdel` command and the `ajsagtadd` command to reregister the execution agent for which the agent host whose IP address was changed is defined as the execution host to the manager host. Note that, if the option for changing the agent host information to be used for name resolution is enabled, work on the manager host is unnecessary. For details on the option for changing the agent host information to be used for name resolution, see 6.3.18 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 15.3.17 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX).
2	If the connection source restriction function is enabled on the manager host that performs communication with the agent whose IP address was changed	Reconfigure the restricting connection sources It is necessary to change the connection permission configuration file. On the connection-destination manager host, change the IP address in the connection permission configuration file for the manager, and then execute the `jajs_pmtcon` command. For details on how to change the IP addresses for which connections are to be permitted, see 7.11.2 Changing the hosts that are permitted to access JP1/AJS3.

No.

Condition

Work performed

If all of the following are met:

An event job has been executed on the agent host whose IP address was changed.
The option for changing the agent host information to be used for name resolution is not enabled.

Reconfigure name resolution for event jobs.

One of the following operations is necessary on the manager host for which the event job is defined.

- Restart the JP1/AJS3 services.

- Execute the ajsagtdel command and the ajsagtadd command to reregister the execution agent for which the agent host whose IP address was changed is defined as the execution host to the manager host.

Note that, if the option for changing the agent host information to be used for name resolution is enabled, work on the manager host is unnecessary.

For details on the option for changing the agent host information to be used for name resolution, see 6.3.18 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 15.3.17 How to set the option for changing the agent information to be used for name resolution in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX).

If the connection source restriction function is enabled on the manager host that performs communication with the agent whose IP address was changed

Reconfigure the restricting connection sources

It is necessary to change the connection permission configuration file.

On the connection-destination manager host, change the IP address in the connection permission configuration file for the manager, and then execute the jajs_pmtcon command.

For details on how to change the IP addresses for which connections are to be permitted, see 7.11.2 Changing the hosts that are permitted to access JP1/AJS3.

If necessary, start the services you stopped in step 1.

To Page Top

(4) Procedure for changing the IP address of JP1/AJS3 - Web Console

Before changing the IP address of JP1/AJS3 - Web Console, perform the following.

Preparation

Make sure that the following operations are not performed from another host to the Web Console server whose IP address is to be changed.

Logging in to or performing operations in JP1/AJS3 - Web Console
Executing APIs

The procedure for changing the IP address of JP1/AJS3 - Web Console is as follows.

Log off from Web GUI.
If the following services are running on the host of JP1/AJS3 - Web Console, stop them.
- The JP1/AJS3 Web Application Server service
- The JP1/AJS3 HTTP Server service
Change the IP address of the host of JP1/AJS3 - Web Console.

Change the IP address of the Web Console server.

Note that it must be possible to perform name resolution for the IP address of the Web Console server from the other hosts that communicate with the relevant server (such as devices that log in from Web GUI.

Change the hosts files, etc., on those hosts so that the changed IP address is found from the host name of the Web Console server.

For notes on changing the settings of the hosts file, etc., see (1) Notes on changing the IP addresses.

Perform the following procedure as required.

No.	Condition	Work performed
1	If the connection source restriction function is enabled on the manager host that performs communication with the Web Console server whose IP address was changed	Reconfigure the restricting connection sources If restricting connection sources are enabled on the manager host to which JP1/AJS3 - Web Console connects, it is necessary to change the connection permission configuration file. On the connection-destination manager host, change the IP address in the manager connection permission configuration file, and then execute the `jajs_pmtcon` command. For details on how to change the IP addresses for which connections are to be permitted, see 7.11.2 Changing the hosts that are permitted to access JP1/AJS3.

If necessary, start the services you stopped in step 2.

To Page Top

(5) Procedure for changing the IP address of JP1/AJS3 - View

The procedure for changing the IP address of JP1/AJS3 - View is as follows.

Log off from JP1/AJS3 - View.
Change the IP address of the JP1/AJS3 - View host.

Perform the following procedure as required.

No.	Condition	Work performed
1	If the connection source restriction function is enabled on the manager host to which JP1/AJS3 - View connects	Reconfigure the restricting connection sources On the connection-destination manager host, change the IP address in the manager connection permission configuration file, and then execute the `jajs_pmtcon` command. For details on how to change the IP addresses for which connections are to be permitted, see 7.11.2 Changing the hosts that are permitted to access JP1/AJS3.

If necessary, start JP1/AJS3 - View and then connect to the Manager host.

If you want to connect to the physical host of JP1/AJS3 - Manager by specifying the IP address for Host to connect on the Login screen of JP1/AJS3 - View, be sure to connect by using the IP address corresponding to the physical host name.

To Page Top