Create connector profiles to manage and monitor SEM Agents
This section explains the purpose for connector profiles and provides instructions for creating them.
About connector profiles
Use a connector profile to group Agents that share the same connector configuration. You can use the profile to configure a set of standardized connector settings, and then apply those settings to all Agents assigned to that profile. Once applied, every Agent in the profile will have the same connector settings.
Connector profiles maintain all Agents in a profile by updating only the profile connector configuration. The system then propagates your changes to all the Agents in the profile.
Most Agents in a network have only a few different connector configurations. Using connector profiles, you can streamline the process of connecting your network security products to SEM. If you decide not to use connector profiles, you must create at least one connector instance for every product that you intend to integrate with SEM, and then repeat this process for each Agent.
A well-planned set of connector profiles provides you with a versatile and efficient method for configuring and maintaining your Agent connector configurations. You can create as many connector profiles as you need to reflect each of your common connector configurations. For example, you can set up a standard user workstation profile, a web server profile, and so on. SolarWinds provides several default connector profiles that address common configurations.
About the connector-profile group type
SEM lets you use connector profiles in filters, rules, and searches. After you define a connector profile, you can use it in rules and filters to include or exclude the Agents associated with that profile. For example, you can create a filter using the Domain Controller connector-profile group to shows you web traffic from the computers in that group.
Groups organize related elements for use with SEM rules and filters. See About SEM groups for information about the various SEM group types.
Connector profile guidelines
A well-planned set of connector profiles provides you with a versatile and efficient method of updating and maintaining your Agents’ connector configurations.
When you configure your connector profiles, use the following guidelines:
- An Agent can only be a member of one connector profile. You cannot add an Agent to multiple connector profiles.
- You can only add a connector profile to one SEM Manager at a time. Each connector profile you create only applies to the SEM Manager you selected when you created the profile. To copy a connector profile for use with another SEM Manager, export the profile and then import it into the other Manager's Groups grid. See Export a group for steps.
Create a connector profile: process overview
This section provides an overview of the steps required to create a connector profile. Creating a connector profile is a three-step process:
Install the SEM Agent software on all the systems that you want to include in your new connector profile, then configure a single SEM Agent to serve as the template for your connector profile.
Add the Agents to the connector profile. When completed, the system applies the template to all Agents in the profile.
Verify the connector status.
When you select an Agent for a template, ensure the Agent has a configuration that mirrors your concept of the final connector configuration.
You can prepare a template Agent in advance by configuring an Agent you know will be a member of the new profile. When completed, use the Agent as the template for the new profile. This process minimizes your need to edit the profile connector configuration in the future.
To clone and/or edit a connector-profile, see Edit SEM Agent connector-profile settings
Create a connector profile: detailed steps
This section provides detailed instructions for creating a connector profile.
Task 1: Configure the Agent that will serve as a template for your connector profile
Open the SEM console. See Log in to the SEM web console for steps.
On the SEM toolbar, navigate to Build > Groups.
On the Groups grid connector bar, click , and then select Connector Profile.
Complete the connector profile selections.
The following table describes how to configure the Connector Profile form fields.
Field Description Name Enter a name for the connector profile. Description Briefly describe the connector profile. Template
Click the Template drop-down menu and select the Agent with the connector configuration that will provide the template for this profile. If you decide not to use a template, select None.
For best results, select a template when you create a new connector profile. Otherwise, the profile will delete the connectors on every Agent in the profile.
If you decide not to use a template, click Edit Connectors and add connectors to the profile before you add Agents and save the profile. Otherwise, there will be no connectors in the profile. When you save the profile, any Agents in the profile will lose their connectors.
Click the Manager drop-down list and select the Manager that will host the group.
If you are editing an existing group, this field displays the Manager currently hosting the profile.
If your targeted Manager is not included in the list, click Manage > Appliances and log on to the Manager. You must be logged on to a Manager to create groups
Save Click Save to save your changes.
The new connector profile appears in the Groups grid.
Task 2: Select the Agents that are members of the profile
Before you begin, be sure that the connector profile you created in task 1 is selected in the Groups grid.
The Connector Profile form contains two columns:
- Available Agents list each Agent that is not in the connector profile for the associated Manager.
- Contained Agents list the Agents included in the connector profile.
To add Agents to a Connector Profile:
In the Groups grid, locate and double-click the new connector profile.
The profile appears in the Connector Profile form. The Agent you selected as a template appears in the Contained Agents list by default.
Add or remove Agents from your connector profile.
Click or to move one or all selected Agents from the Available Agents column to the Contained Agents column. These Agents are added to the connector from the connector profile.
Click or to move one or all selected Agents from the Contained Agents column to the Available Agents column. These Agents are removed from the connector profile.
The system applies the configuration to every Agent you added to the profile.
If you remove an Agent from a connector profile that was previously saved with that profile, the Agent retains the connector configuration from the profile, but will no longer have membership in the profile.
Task 3: Verify the connector status
Some Agents in a connector profile will not use the same logging path for a connector. Be sure to check the configured connector status of each Agent. If the connector status is a icon, the connector is not running and may have a different logging path. To resolve this issue, add another connector instance to the profile connector catalog that points to an alternate logging path or create a new profile with an alternate logging path.