jddupdatetree
- Organization of this page
Function
Based on the IM management node-related files acquired with the jddcreatetree command and the IM management node link definition file (imdd_nodeLink_def.conf) defined manually by the user, this command creates information regarding both the IM management node tree and the link between IM management nodes, and evaluates configuration information.
You can specify one of the following two options to designate how you want the system configuration information to be applied. The status of IM management nodes is evaluated differently depending on which option is specified.
If you specify the new and rebuilding mode as a way to apply system configuration information, this command acquires all the JP1 events stored in the integrated monitoring database and evaluates the status of each IM management node. If you specify the configuration change mode as a way to apply system configuration information, the command directly inherits and evaluates information regarding both existing JP1 events and mapping between those JP1 events and IM management nodes, instead of reacquiring all the JP1 events stored in the integrated monitoring database.
Specify the new and rebuilding mode in the following cases:
-
When you create a new configuration
-
When you correct any misconfiguration
-
When you backed up the IM database (jimdbbackup command) and then recovered it (jimdbrecover command)
-
When you unset up the integrated monitoring database (jcodbunsetup command) and set it up again (jcodbsetup command)
-
When the intelligent integrated management database is backed up (execute jimgndbbackup command) and recovered (execute jimgndbrestore command)
-
When you upgraded JP1/IM - Manager in the environment where the Intelligent Integrated Management Base was used
Specify the configuration change mode in the following case:
-
When a managed target of the Intelligent Integrated Management Base is added, removed, or modified in addition to correction of misconfiguration
For details about how to apply system configuration information, see 3.5.7 Modes of applying system configuration information in the JP1/Integrated Management 3 - Manager Overview and System Design Guide.
Before executing this command, execute the jddsetaccessuser command to set the user ID and password information required for authentication.
For details about the jddcreatetree command, see jddcreatetree in Chapter 1. Commands.
This command requests the Intelligent Integrated Management Base to apply the IM management node-related files and waits until the request is completed.
Format
jddupdatetree -i directory-name [{-r|-c}] [-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.
- -r|-c
-
Specifies an option that determines how system configuration information will be applied.
- -r
-
Specify this option when you want to apply system configuration information in the new and rebuilding mode. You cannot specify this option along with the -c option. In this mode, system configuration information is applied in almost the same manner as in version 12-10 or earlier.
- -c
-
Specify this option when you want to apply system configuration information in configuration change mode. You cannot specify this option along with the -r option.
- -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 and jddupdatesuggestion commans are 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.
-
When neither the -r option nor the -c option is specified, system configuration information is applied according to the setting specified for the jp1.imdd.simt.updateMode property in the Intelligent Integrated Management Base definition file (imdd.properties).
When you newly install JP1/IM - Manager, change (configuration change mode) is set for this property. When you upgrade from version 12-10 or earlier, nothing is defined for this property. In this case, it is assumed that reconfigure (new and rebuilding mode) is set. We advise you to change this setting to suit your operational needs.
-
If a registered JP1 event is included while the host mapping function for the problem source in the integrated monitoring DB is disabled, mapping between the JP1 event and the IM management node might fail, and the warning message KAJY02022-W might be output. For details regarding mapping between a JP1 event and an IM management node, see 3.9.1 Evaluations using JP1 events in the JP1/Integrated Management 3 - Manager Overview and System Design Guide.
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 has an 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 |
22 |
Master file alternate failed |
26 |
The user used for authentication has insufficient permissions |
27 |
There are suggestion definitions that are not mapped to any of the IM management nodes |
28 |
Failed to create suggestion-related master files# |
29 |
Failed to replace the suggestion-related master files# |
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.
Example 3
Execute the command with the new and rebuilding mode specified as a way to apply system configuration information:
$ jddupdatetree -i C:\tmp -r KAJY02009-I The command (jddcreatetree) has started. KAJY02010-I The command (jddcreatetree) terminate normally.
Example 4
Execute the command with the configuration change mode specified as a way to apply system configuration information:
$ jddupdatetree -i C:\tmp -c KAJY02009-I The command (jddcreatetree) has started. KAJY02010-I The command (jddcreatetree) terminates normally.