jddupdatetree
- Organization of this page
Function
This command creates tree information and link information of the IM management nodes from the IM management node-related files, which are created by the jddcreatetree command, and the IM management node link definition file (imdd_nodeLink_def.conf), which is created manually by users. Additionally, this command retrieves all JP1 events stored in the integrated monitoring database to evaluate the status of each IM management node. Before executing this command, execute the jddsetaccessuser command to set the user ID and password information required for authentication.
This command requests the Intelligent Integrated Management Base to apply the IM management node-related files and waits until the request is completed.
For details about the jddcreatetree command, see jddcreatetree in Chapter 1. Commands.
Format
jddupdatetree -i directory-name [-h logical-host-name]
Execution permission
In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)
In UNIX: Superuser permissions
Storage directory
- In Windows:
-
Manager-path\bin\imdd\
- In UNIX:
-
/opt/jp1imm/bin/imdd/
Arguments
- -i directory-name
-
Specifies the path of the directory that stores files created by the jddcreatetree command. The value can be an absolute path or a relative path from the directory where this command is executed. The value must be enclosed in double quotation marks (") if a space is included.
- -h logical-host-name
-
Specifies the logical host name of JP1/IM if JP1/IM is running in a cluster system.
If this option is omitted, the command assumes the logical host name specified in the JP1_HOSTNAME environment variable. If the JP1_HOSTNAME environment variable is not specified, the command assumes the physical host name.
Notes
-
You cannot execute the jddupdatetree command concurrently multiple times. Doing so results in an error.
-
While the jddupdatetree command is running, you cannot execute the jddcreatetree command. Doing so results in an error.
-
Before you can execute the jddupdatetree command, JP1/IM - Manager and the IM database must be running.
-
Do not stop JP1/IM - Manager or the IM database while the jddupdatetree command is running.
Return values
0 |
Normal termination |
1 |
Normal termination (invalid property) |
2 |
Exclusive locked |
3 |
Invalid argument |
4 |
Invalid logical host name |
5 |
Authentication information used by the Intelligent Integrated Management Base is not set |
6 |
Missing information required for the jddupdatetree command to run |
7 |
No execution permission for the jddupdatetree command |
8 |
The specified directory does not exist |
10 |
IM database service is not running |
11 |
Failed to connect to the Intelligent Integrated Management Base |
12 |
The Intelligent Integrated Management Base could not be authenticated |
13 |
A required file does not exist |
14 |
A required file could not be read |
15 |
A required file hasan invalid format |
16 |
A required file has an invalid description |
17 |
Event information could not be received |
19 |
Information could not be received from the plug-in |
21 |
Master file creation failed |
22 |
Master file alternate failed |
26 |
The user used for authentication has insufficient permissions |
255 |
System error |
Example 1
Specify that files created by the jddcreatetree command are stored in C:\tmp:
$ jddupdatetree -i C:\tmp KAJY02009-I The command (jddupdatetree) has started. KAJY02010-I The command (jddupdatetree) terminates normally.
Example 2
Specify that files created by the jddcreatetree command are stored in C:\tmp and specify a logical host named ronri:
$ jddupdatetree -i C:\tmp -h ronri KAJY02009-I The command (jddupdatetree) has started. KAJY02010-I The command (jddupdatetree) terminates normally.