jimalhupdate

Organization of this page

Function

This command upgrades the logical host environment after installing JP1/IM - Agent version upgrade.

This command does not set up the following optional functions and data delivery function to multiple manager hosts.

OracleDB exporter
Node exporter for AIX
SAP system monitoring
SQL exporter

If you want to use these functions on a logical host, set up the system manually after using this command.

Format

jimalhupdate VVRRSS
            -h logical-hostname
            -d shared-directory
            -c {online | standby}
            -f set-up-configuration-file
            [-q]

To Page Top

Execution authority

In Windows: Administrator permissions (If the Windows UAC feature is enabled, the command must be executed from the administrator console.)

In Linux: Superuser permissions

To Page Top

Storage destination directory

For Windows: Agent-path\tools\
For Linux: /opt/jp1ima/tools/

To Page Top

Argument

VVRRSS

Specify the version prior to upgrading JP1/IM - Agent in VVRRSS format.

-h logical-hostname

Specifies the logical host name of the target host to be set up.

-d shared-directory

Specifies the directory for the logical host to be created on the shared disk.

-c {online | standby}

Specifies the type of setup for the running system and the standby system in the cluster configuration.

online: Specifies that the running system is to be set up.
standby: Specifies that the standby system is to be set up.

To perform logical host operation in a non-clustered environment, specify online as -c option.

-f set-up-configuration-file

Specifies configuration file of the version upgrade setup command for the logical host that describes whether the service is enabled or disabled.

The path to the file can be either full or relative to the location where the command was executed.

If you are setting up in a clustered environment, use the same setup configuration file for the running system and the standby system.

For more information about configuration file, see Configuration file of the logical host version upgrade setup command (any-file-name) in Chapter 2. Definition Files.

-q

Specifies that the command argument and setup configuration file content are to be checked, and the setup command processing is to be started without user confirmation.

-If you specify the q option: The console does not prompt for confirmation prior to starting the upgrade setup process. (This is the same as typing "y" and pressing Enter in all confirmation messages.)
-If the q option is omitted: The console prompts for confirmation before starting the upgrade setup process.

To Page Top

Return value

`0`	Normal completion
`1`	Abnormal termination

To Page Top

Log output

Output destination

- In Windows

Agent-path\logs\tools\

- In Linux

/opt/jp1ima/logs/tools/

To Page Top

Examples of use

For Windows

jimalhupdate 131000 -h LOGICALHOST01 -d c:\common\dir01 -c online -f c:\work\jpc_lhupdate.properties -q

For Linux

jimalhupdate 131000 -h LOGICALHOST01 -d /common/dir01 -c online -f /work/jpc_lhupdate.properties -q

To Page Top

Notes

Do not run this command more than once at the same time. If the command is executed at the same time, the result may be incorrect even if the command terminates normally.
Be sure to execute this command while all JP1/IM - Agent services are stopped. If it is executed while the service of JP1/IM - Agent is running, the file to be updated may be locked and file update may fail.
Be sure to execute this command without opening the definition file in a text editor or the like. If you execute the command while editing the definition file with a text editor, etc., the file to be updated may be locked and file update may fail.
If the file to be updated is locked by anti-virus software, etc., file update may fail. Make sure that the files to be updated are not subject to anti-virus software.
If the setup process is started and then terminates with an error in the middle of execution, eliminate the cause of the error, perform the procedure shown in Recovery procedure in the event of abnormal termination after the validation pass below, and then re-execute the command to complete the setup process (make sure that all files have been updated).
This command cannot be executed in an environment where a new setup of the logical host has not been completed.

- Recovery procedure in the event of abnormal termination after the validation pass

If the command ends abnormality after the KNBC10117-I message is output on the console, perform the recovery operation as follows:

For Windows

Check if the logical host service to be added to Windows is registered in the version upgrade.

At the command prompt, run services.msc to open management console and verify that the service for the logical host that you want to add is registered. If it is not registered, step 2 does not need to be performed.

The services to be added differ depending on the version prior to the version upgrade. For details, see Configuration file of the logical host version upgrade setup command (any-file-name) in Chapter 2. Definition Files.
Deactivates the service for the logical host registered in Windows.

Release the service from Windows for the service to be used by the logical host.

To remove a logical host service, use the following command:
```
Agent-path\tools\jpc_service -off service-key -h logical-hostname
```
The following shows a sample procedure for deactivating VMware exporter service.
```
Agent-path\tools\jpc_service -off jpc_vmware_exporter -h logical-hostname
```

For Linux

Check whether the logical host service to be added to systemd is registered in the version upgrade.

Execute systemctl list-unit-files command. After the version upgrade, check whether the logical host service to be added is registered. If it is not registered, steps 2 to 4 are not required.

The services to be added differ depending on the version prior to the version upgrade. For details, see Configuration file of the logical host version upgrade setup command (any-file-name) in Chapter 2. Definition Files.
Enable the service to unregister logical host service registered with systemd.

If there is a service on a logical host whose service status is masked, to remove the service for the logical host from systemd, run the following command to enable the service:
```
/opt/jp1ima/tools/jpc_service -on service-key -h logical-hostname
```
The following example shows how to enable VMware exporter service:
```
/opt/jp1ima/tools/jpc_service -on jpc_vmware_exporter -h logical-hostname
```
Remove unit definition file for the logical host to be added in the version upgrade.

Delete the unit definition file for the logical host under /usr/lib/systemd/system.

File name to be deleted: jpc_service-name_logical-hostname.service
Refresh systemd.

Run the following command to refresh systemd:
```
# systemctl daemon-reload
```

To Page Top