Agent Mapping Rule

Agent Mapping Rule allows you to define a rule for automatic mapping of agents to a master agent.

Define Agent Mapping Rule

Click the 'Settings' tab. In the 'Asset and Inventory' section, click 'Node Rules Engine'.
On the left hand menu click on 'Master Agent Mapping Rule'. The list of Master Agent Mapping rules is displayed.

Rules can be run on demand, by selecting them and clicking on 'On Demand'.
When an agent maps to multiple rules, by default it is mapped based on the first rule configured. The order can be changed by clicking on 'Preference Settings'. Refer to Preference Settings for details.
To add a new rule, click 'Add'.
Rules can be based on a 'Logical Condition' or 'Regular Expression'. The Regular Expression can be used to include a subset of systems by applying a regular expression to one of Host Name, IP address, IP range or Gateway IP. The Logical conditions can be used to create multiple rules based on conditions for Organization Unit, Host Name, IP address, IP range or Gateway IP.
The following screen is displayed when 'Logical Condition' is selected.

If you select 'Regular Expression', you will see the following screen.

The table below describes the fields.

Serial No	Field Name	Description
1	Rule Name	Enter the rule name of the agent mapping rule
2	Rule Constructor	Select between Logical Condition and Regular Expression.
3	Master Agent	Select the Master Agent to which the agent nodes have to be mapped
4	Rule Parameters	If Logical Condition is selected, select a 'Filter', select the 'Criteria' and 'Value'. Click on 'Add' to add the rule. Multiple rules can be added and the 'Conditions' joined by 'AND' or 'OR' operators.
5	Filter Type	If Regular Expression is selected, Select the filter type based on which the agents are associated to the master agent. For more information, click 'Help'.
6	Enter Regular Expression	Regular expression is an expression based on the filter type which is likely to contain the agent nodes To test if the agent node is present in the expression, click 'Test'. A pop-up appears. Enter the IP address and click 'Ok'.
7	Consider Slave Agents which are already mapped manually	Check this if the Slave Agents which are mapped manually need to be re-mapped based on this rule.
8	Consider Slave Agents which are already mapped using dynamic rule(s)	Check this box if the Slave Agents which are mapped through some other rule dynamically need to be re-mapped based on this rule.

Click on 'Save' to save the rule.
The agent mapping rules are run every 15 minutes and map all new agents which have been discovered.

Preference Settings

Sometimes, an agent may fall under more than one agent mapping rule. If no preference is set, the agent will be mapped to the first configured agent mapping rule. To explicitly define the agent preference, select the rule name and click 'Preference Settings'

Select the preference for the agent nodes to be associated with the master agent and click 'Save'

Audit Log

Click the Audit log icon to view the audit log for the rule. The audit log displays all changes to the rule.
To view the agent nodes associated to the agent mapping rule, in the Master Agent Mapping Rule page, click the agent mapping rule
Click the Audit log icon to view the agent mapping details.

Dedicated Server

Click this tab to view the dedicated server details. The term 'Dedicated server' is more meaningful in 'Enterprise' or 'Enterprise Plus' editions of SapphireIMS, where the discovered nodes are associated with a specific data collector that is selected at the time of discovery.

Note: In the case of Professional edition, there will be only one dedicated server listed and all the discovered systems are automatically associated with the server.

Click on '' to view the list of associated systems. Select a host name and click on 'De-Associate' to de-associate the host from the server. The host is then associated to the primary data collector. Hosts that are associated to the primary server cannot be de-associated from the primary server.

Dedicated Server Mapping Rule

The rule configuration is similar to the master agent mapping rule in the 'Professional' edition. This rule allows you to define an automatic mapping rule for bulk mapping of hosts to a particular data collector or dedicated server.

Sr. No	Field Name	Description
1	Rule Name	Enter the rule name of the agent mapping rule
2	Dedicated Server	Select the dedicated server to which the agent nodes have to be mapped
3	Filter Type	Select the filter type based on which the agents are associated to the dedicated server. For more information, click 'Help'
4	Enter Regular Expression	Regular expression is an expression based on the filter type which is likely to contain the agent nodes To test if the agent node is present in the expression, enter the IP address of the agent and click 'Test'.