8.2.6 Applying the system hierarchy
You can use IM Configuration Management to apply the agent configuration in the edited configuration definition information to all agents in the system hierarchy.
For the agent configuration, the following methods for applying the system hierarchy are available:
-
Differential distribution method
The configuration definition information is deleted from or distributed to only those hosts that have been changed in the current agent configuration. For hosts that have been deleted, the configuration definition information is deleted. For hosts that have been added to the agent configuration, the configuration definition information is distributed to the hosts and higher manager hosts. This enables the system hierarchy to be applied without affecting the monitoring of the hosts that are unchanged in the agent configuration. Note that the manager host's JP1/Base version must be 11-10 or later.
-
Batch distribution method (with deletion of the configuration)
The configuration definition information is deleted from all hosts in the current agent configuration, and then the configuration definition information is distributed to all hosts in the newly defined agent configuration.
-
Batch distribution method (without deletion of the configuration)
The configuration definition information is distributed to all hosts in the newly defined agent configuration without deleting the configuration definition information.
The following shows how to specify the methods for applying the system hierarchy.
-
Differential distribution method
To use the differential distribution method, specify it in the settings for the distribution of the configuration definition information in JP1/Base.
-
Batch distribution method
To use the batch distribution method, specify it in the settings for the distribution of the configuration definition information in JP1/Base. In the following setting conditions, specify either with deletion of the configuration or without deletion of the configuration.
-
Batch distribution method (with deletion of the configuration)
To use the batch distribution method (with deletion of the configuration), disable the restrictions on viewing and operating business groups, and specify APPLY_CONFIG_TYPE as 00000000 in the common definition information.
-
Batch distribution method (without deletion of the configuration)
To use the batch distribution method (without deletion of the configuration), enable the restrictions on viewing and operating business groups, or specify APPLY_CONFIG_TYPE as 00000001 in the common definition information.
-
For details about the methods for distributing configuration definition information in JP1/Base, see the JP1/Base User's Guide. For details about the restrictions on viewing and operating business groups, see 5.19 Setting reference and operation restrictions on business groups in the JP1/Integrated Management 3 - Manager Configuration Guide. For details about the APPLY_CONFIG_TYPE settings in the common definition information, see Apply-IM-configuration-method definition file (jp1cf_applyconfig.conf) in Chapter 2. Definition Files in the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
If an agent configuration is applied after the system hierarchy has been defined and synchronized between the integrated manager and a base manager, the information under the base manager is cleared. In this case, you must synchronize the system hierarchy again.
- Organization of this subsection
(1) System hierarchy application methods
To apply the configuration definition information in the system hierarchy, perform the following:
-
For an agent configuration
In the Edit Agent Configuration window, from the Operation menu, select Apply Agent Configuration.
For details, see 3.2.4(3) Applying a system hierarchy to a system managed by IM Configuration Management in the JP1/Integrated Management 3 - Manager Configuration Guide.
-
For a remote monitoring configuration
In the Edit Remote Monitoring Configuration window, from the Operation menu, select Apply Remote Monitoring Configuration.
To use a remote monitoring configuration, you must apply an agent configuration beforehand. When you apply an agent configuration, even if no agents exist on the hosts other than the manager hosts in that configuration, apply that configuration.
To apply the system hierarchy, you must obtain update rights. For details, see 8.2.5(1) Obtaining update rights.
(2) General procedure for applying the system hierarchy with IM Configuration Management
The figure below shows the flow of processing when applying configuration definition information with IM Configuration Management.
|
If an agent configuration is applied, the configuration definition file (jbs_route.conf) is overwrite-saved on a host on which IM Configuration Management is running. If you want to save the file contents before they are replaced, you must take a backup by saving the file under another name or by other means.
If an agent configuration is applied, the jbsrt_distrib command is executed on the manager on which IM Configuration Management is running. In this case, the configuration definition information is deleted from all agents in the system hierarchy, and the edited configuration definition information is distributed. For this reason, the same agent cannot be monitored from multiple manager hosts.
When a remote monitoring configuration is applied, Remote is added to the IM configuration types for the remotely monitored hosts.
If there is an agent host or remotely monitored host for which the system hierarchy cannot be applied, the host name is displayed in the dialog box.
The result of applying a system hierarchy are shown in a dialog box. Also, you can check the new system hierarchy on the IM Configuration page of the IM Configuration Management window. If processing failed, the affected host is represented by an error-status icon in the tree display area of the IM Configuration page. To view further details, click the Basic Information button in the node display area of the IM Configuration page.