jddupdatetree

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 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.2.7 Modes of applying system configuration information in the JP1/Integrated Management 2 - 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.

To Page Top

Format

jddupdatetree -i directory-name [{-r|-c}] [-h logical-host-name]

To Page Top

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

To Page Top

Storage directory

In Windows:

Manager-path\bin\imdd\

In UNIX:

/opt/jp1imm/bin/imdd/

To Page Top

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.

To Page Top

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.4.1 Evaluations using JP1 events in the manual JP1/Integrated Management 2 - Manager Introduction and Design Guide.

• Execute the jddupdatetree command in new and rebuilding mode in the following cases:

  • 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)

To Page Top

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
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

To Page Top

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.

To Page Top

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.

To Page Top

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.

To Page Top

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.

To Page Top