Agent mappings configuration

Agent mappings define what environment should be assigned to agent being connected to the CMR repository. Please read the basic concepts first in order to understand all the configuration elements in inspectIT.

Management

Mappings are created and managed by clicking on the Agent Mapping Settings  tool-bar action in the Configuration Interface view. 

Configuration

The Agent mapping editor is used to configure all mappings in the selected CMR. Each mapping defines the following properties:

PropertyTypeDescription
ActiveYes/NoDefines if the given mapping is active. Non active mappings will not be taken into account when mapping agents to environments.
Agent NameTextDefines the name of the agent or the pattern with the wild-card (*). When agent is connected the given name/pattern must match the agent name in order for the agent to use the given mapping.
IP AddressTextDefined the IP address of the agent to match. When agents is connected he transmits all of it's network interfaces (IP addresses) and one of these must match the given IP address pattern. IPv4 and IPv6 matching is both possible.
EnvironmentEnvironmentDefines what environment should be used by the agents that are matching the agent name and IP address patterns.

Description OPTIONAL

TextUser defined description for easier management.

Agent must match only one mapping

The agent that is connected to the CMR must match exactly one active mapping. If there is zero or more than one matched active mappings, then agent will not be functional as the CMR is not able to deceide what Environment should be bounded to the agent.  

Mappings are added by using the Add Agent Mapping dialog

Examples

Here are some examples of the agent mappings:

ExampleDescription

Maps My Test Env to the agent(s) that are connected with the name MyAgent and have the IP address 192.168.0.126 as one of the network interface.

Maps My Test Env to the agent(s) that are connected the name that starts with MyApp. This will match for example agents with names: MyApp [Dev], MyApp Test, etc. The mappings also define that the agent is inside the 192.168.x.x sub-network.

Same as above, except it will match agents connected from any IP address.