3.4.8 Distributing agent properties as a batch
Agent properties can be distributed as a batch to any services with the same product name and data model version. This feature has the following benefits:
-
When managing multiple agents of the same type, you can define the same settings for each agent as a batch
-
When you add a new agent, it can be configured with the same settings as existing agents.
The following table lists the nodes whose properties can be distributed as a batch.
Service |
Node name |
Description |
---|---|---|
Agent Collector and Remote Monitor Collector |
JP1 Event Configurations |
These nodes contain the properties that define the conditions for issuing JP1 events. For details, see 12. Linking with the Integrated Management Product JP1/IM for Operation Monitoring. |
Detail Records |
These nodes contain the properties that define how performance data is recorded. For details, see 4. Managing Operation Monitoring Data. |
|
Interval Records |
||
Log Records |
||
Restart Configurations |
These nodes contain the properties that configure automatic restart of PFM services. For details on automatic restart of PFM services, see 16.4 Using the PFM service automatic restart functionality to restart PFM services. |
|
Node count variation property#1 |
These nodes contain the properties for which the number of nodes increases or decreases. The properties subject to batch distribution differ depending on the type of agent. For details, see the appendixes of the appropriate PFM - Agent or PFM - RM manual. |
|
Agent Store and Remote Monitor Store#2 |
Retention |
These nodes contain the properties that define how performance data is stored. For details, see 4. Managing Operation Monitoring Data. |
RetentionEx |
||
Disk Usage |
||
Configuration |
||
Remote agent and group agent |
Detail Records#3 |
These nodes contain the properties that define how performance data is recorded. For details, see 4. Managing Operation Monitoring Data. |
Interval Records#3 |
||
Log Records#3 |
- #1
-
You must be using version 08-11 or later of PFM - Manager and PFM - Web Console to perform batch distribution of properties for which the number of nodes increases or decreases.
- #2
-
Whether properties can be distributed from one Agent Store or Remote Monitor Store service to another depends on the versions of the Agent Store and Remote Monitor Store services and the Store database serving as the source and destination in the distribution process. For details, see 3.4.8(2) Property distribution capability by Agent Store and Remote Monitor Store versions.
- #3
-
Only the Log property can be distributed.
Properties cannot be distributed among the Remote Monitor Collector service and the remote or group agents.
- Organization of this subsection
(1) Procedure for distributing agent properties
-
Log on to PFM - Web Console from the monitoring console Web browser.
Log on to a user account that has administrator user permissions.
You must have administrator user permissions to use the Services window.
-
In the navigation frame of the main window, select the Services tab.
-
In the navigation frame of the Services window, expand the hierarchy under the Machines folder.
The hierarchy displays folders with the same names as the hosts where Performance Management services are installed. When you expand one of these folders, the services installed on that host are displayed. The name of each service is represented by the service ID. For details on the service ID, see the appendix describing service naming rules in the Job Management Partner 1/Performance Management Planning and Configuration Guide, and the list of identifiers described in the appropriate PFM - Agent or PFM - RM manual.
The format of the service ID depends on whether the product name display function is enabled. For details on the product name display function, see the chapter that describes the Performance Management functions in the Job Management Partner 1/Performance Management Planning and Configuration Guide.
-
Select the distribution source agent node.
You can select any of the following services to be the distribution source node:
-
Agent Collector and Remote Monitor Collector
-
Agent Store and Remote Monitor Store
-
Remote agent
-
Group agent
The selected node is marked with a checkmark.
-
-
In the method frame, select the Distribute Property method.
The Distribute Properties > Select Service window appears, showing a list of services available for selection as the distribution destination. The list is populated with services that have the same product name and data model version as the distribution source.
-
Select the distribution destination service.
If access control based on business groups is enabled, you can refine the list of distribution destination services by business group.
- Tip
-
You can search for a service by entering a search string in the text box and clicking Filter.
-
Click the Next button.
The Distribute Properties > Select Service window appears, showing a list of properties you can distribute to the distribution destination, with check boxes you can use to select the properties.
-
Select the properties to distribute.
When you select a node in the tree, a list of the properties you can select appears at the bottom of the information frame.
Click the Select All button to select all of the properties in the list. Click the Unselect All button to clear all selections.
If you want to select a different distribution destination service, click the Back button in the Distribute Properties > Select Property window. You are returned to the Distribute Properties > Select Service window in step 6.
-
Click the Finish button.
The batch distribution process begins, and the Distribute Property > Progress Reports window appears.
When batch distribution to a service has finished, OK appears in the Property Distribution column for that service.
The OK button becomes available when batch distribution has finished for all services.
- Reference note
-
In step 8, you can select additional properties to distribute by repeating the process of selecting another node in the tree and selecting the properties to distribute from that node, before clicking the Finish button.
-
Click the OK button.
The contents of the information frame are cleared.
(2) Property distribution capability by Agent Store and Remote Monitor Store versions
Whether properties can be distributed from one Agent Store service to another depends on the versions of the Agent Store and Remote Monitor Store services and the Store database serving as the source and destination in the distribution process.
Distribution source Agent Store and Remote Monitor Store |
Distribution destination Agent Store and Remote Monitor Store |
||
---|---|---|---|
08-00 or earlier |
08-11 or later with Store 2.0 |
08-11 or later with Store 1.0 |
|
08-00 or earlier |
Y |
N |
Y |
08-11 or later with Store 2.0 |
N |
Y |
N |
08-11 or later with Store 1.0 |
Y |
N |
Y |
- Legend:
-
Y: Can be distributed.
N: Cannot be distributed.
(3) Batch distribution of properties for which the number of nodes increases or decreases
Some properties for which the number of nodes increases or decreases can change the structure of the tree by adding or deleting higher-level nodes. For example, nodes below the Application monitoring setting node of PFM - Agent for Platform can change the tree structure by adding or deleting nodes.
This type of property, for which the number of nodes increases or decreases, can be included in batch distribution even when the source and destination of the distribution have different tree structures. You can also choose to match the structure of the distribution destination to that of the distribution source. Note that you must be using version 08-11 or later of PFM - Manager and PFM - Web Console to perform batch distribution of properties for which the number of nodes increases or decreases.
(a) Operations by batch distribution of the properties for which the number of nodes increases or decreases
By using the feature that distributes, in a batch, properties for which the number of nodes increases or decreases, you can operate the Performance Management system in the following ways:
-
Configure all agents identically when building a new system
-
Configure all agents identically during operation of the Performance Management system
-
Update specific properties on multiple agents during operation of the Performance Management system
-
Add a node to multiple agents during operation of the Performance Management system
-
Remove a node from multiple agents during operation of the Performance Management system
By adding and deleting nodes and setting properties on a single agent, and then distributing the properties of that agent in a batch, you can match the property settings of the distribution destinations including the tree structure to those of the distribution source.
The following provides examples of configuring batch-distribution of agent properties.
For details on how to add or remove nodes from a single agent, see the appropriate PFM - Agent or PFM - RM manual. For details on how to distribute properties in a batch, see 3.4.8(3)(b) Procedure for batch distribution of properties for which the number of nodes increases or decreases.
- Configuring all agents identically when building a new system:
-
In the Distribute Properties > Select Property window, select Add as the Operation for each node in the properties list area.
The nodes are added to the distribution destination so that the tree structure mirrors that of the distribution source. The values of the properties all match the values on the distribution source.
- Configuring all agents identically during operation of the Performance Management system:
-
In the Distribute Properties > Select Property window, select Add as the Operation for each node in the properties list area, and select the Delete nodes that only exist at the distribution destination check box.
Any nodes that do not exist on the distribution destination agent are added in the distribution process. In this case, the property settings of the added nodes match those of the destination agent. The settings of any node that already exists at the distribution destination agent will match the settings of that node on the source agent. Any nodes that only exist at the distribution destination agent will be removed.
As a result of this process, the tree structure of the distribution destination agent will match that of the distribution source agent.
- Updating the value of specific properties on multiple agents during operation of the Performance Management system:
-
In the Distribute Properties > Select Property window, select Update as the Operation for each node where there are properties you want to update.
Also, select the Apply check box for each property you want to update.
The update operation only updates the values of properties with the Apply check box selected.
- Adding a node to multiple agents during operation of the Performance Management system:
-
In the Distribute Properties > Select Property window, select Add as the Operation for the node that you want to add.
The node is added to the distribution target agent, so that the tree structure mirrors that of the distribution source. The property settings of the added node will match those of the destination agent.
If you perform batch distribution with Add selected for a node that exists at the distribution-target agent, the values of the properties on that node are overwritten regardless of whether the Apply check box is selected.
- Removing a node from multiple agents during operation of the Performance Management system:
-
In the Distribute Properties > Select Property window, select Delete as the Operation for the node you want to delete.
The node for which Delete is selected is deleted if it exists at the distribution destination.
- Tip
-
The Delete operation does not delete the corresponding node from the distribution source agent. For this reason, the distribution source and distribution destination agents will have different tree structures after the batch distribution process.
(b) Procedure for batch distribution of properties for which the number of nodes increases or decreases
Use the procedure below to distribute, in a batch, properties for which the number of nodes increases or decreases. This example distributes the tree structure below the Application monitoring setting node available with version 08-11 or later of PFM - Agent for Platform. The following procedure assumes that the properties have been set on the distribution source agent.
-
Log on to PFM - Web Console from the monitoring console Web browser.
Log on to a user account that has administrator user permissions.
You must have administrator user permissions to use the Services window.
-
In the navigation frame of the main window, select the Services tab.
-
In the navigation frame of the Services window, expand the hierarchy under the Machines folder.
The hierarchy displays folders with the same names as the hosts where Performance Management services are installed. When you expand one of these folders, the services installed on that host are displayed. The name of each service is represented by a service ID.
-
Select the node of the service to act as the distribution source.
- For PFM - Agent hosts
-
Expand the hierarchy under the folder named for the host running the Agent Store or Agent Collector service whose properties you want to distribute, and select the service to act as the distribution source.
- For PFM - RM hosts
-
Expand the hierarchy under the folder named for the host running the Remote Monitor Store or Remote Monitor Collector service whose properties you want to distribute, and then select the service to act as the distribution source.
Because this procedure involves distributing the Application monitoring setting of PFM - Agent for Platform, select an Agent Collector service that begins with TA.
For details on service IDs, see the description of the service naming rules in the appendixes of the Job Management Partner 1/Performance Management Planning and Configuration Guide and the list of identifiers described in the appropriate PFM - Agent or PFM - RM manual.
The selected Agent Collector service is marked with a checkmark.
-
In the method frame, select the Distribute Property method.
The Distribute Properties > Select Service window appears, showing a list of services available for selection as the distribution destination. The list is populated with services that have the same product name and data model version as the distribution source.
-
Select the distribution destination service and click Next.
-
In the Distribute Properties > Select Property window, select Application monitoring setting in the tree in the information frame.
-
Select Update, Add, or Delete for the nodes under Application monitoring setting in the property list area at the bottom of the information frame.
The following figure indicates the nodes that are subject to an Update operation.
The update operation only updates the values of properties for which you selected the Apply check box in step 10.
The following figure indicates the nodes that are subject to an Add operation.
If you perform batch distribution with Add selected for a node that exists at the distribution-target agent, the values of the properties on that node are overwritten regardless of whether the Apply check box is selected.
The following figure indicates the nodes that are subject to a Delete operation.
- Tip
-
The Delete operation does not delete the corresponding node from the distribution source agent. For this reason, the distribution source and distribution destination agents will have different tree structures after the batch distribution process.
-
To delete a node that exists on the distribution target agent but not on the distribution source agent, select the Delete nodes that only exist at the distribution destination check box.
The following figure indicates the nodes that are subject to a Delete operation when the Delete nodes that only exist at the distribution destination check box is selected.
-
For nodes for which you selected Update in step 8, select the properties whose values you want to update.
Select the node in the tree to display a list of properties.
When the Update operation is selected, properties for which the Apply check box is selected in the properties list are included in the batch distribution process.
You can select all of the properties in the list by clicking the Select All button, and unselect all selected properties by clicking the Unselect All button.
-
Click the Finish button.
After selecting the nodes for which to distribute properties and which properties to distribute, click the Finish button. The batch distribution process begins, and the Distribute Property > Progress Reports window appears.
When batch distribution to a service has finished, OK appears in the Property Distribution column for that service.
The OK button becomes available when batch distribution has finished for all services.
-
Click the OK button.
The contents of the information frame are cleared.