Edit SEM Agent connector-profile settings

This topic describes how to clone or edit a connector profile, and how to add, edit, or delete the connector instances associated with a connector profile.

Open the connector profile settings for editing

  1. Open the SEM console. See Log in to the SEM web console for steps.

  2. On the SEM toolbar, navigate to Build > Groups.

  3. In the Groups grid, locate the connector profile you want to edit.

  4. Click , and then select Edit.

    The Connector Profile pane opens at the bottom of the page, displaying the Agents in the profile.

Clone a connector-profile instance

  1. Open the SEM console. See Log in to the SEM web console for steps.

  2. On the SEM toolbar, navigate to Build > Groups.

  3. In the Groups grid, locate the connector profile you want to clone.

  4. Click , and then select Clone.

    The Groups grid displays a new instance of the connector profile.

  5. See Edit the connector-profile settings to change the settings of the cloned connector profile.

Editing a connector profile instance

Use the Edit Connectors command in the connector profile form to add, edit, or delete the connector instances associated with the profile.

Changing a connector profile changes the connector configuration of every Agent associated with the profile.

When you edit an Agent, you must stop and start each connector instance to edit the running Agent's configuration. When you edit a connector profile configuration, stopping or starting each connector instance is not required, but you must activate your changes.

When you edit the connector configuration in a connector profile, you are modifying the profile configuration data, not the actual Agent. When you edit a connector profile, you do not change the Agents that are members of the profile until you click Activate. After you activate the profile, the system automatically updates all Agents that are members of the profile, stops each connector instance, makes the necessary changes, and then restarts each connector instance.

Edit the connector-profile settings

Before you begin, see Editing a connector profile instance.

  1. Open the SEM console. See Log in to the SEM web console for steps.

  2. On the SEM toolbar, navigate to Build > Groups.

  3. In the Groups grid, locate the connector profile you want to edit.
  4. Click , and then select Edit.
  5. In the Properties form, update the connector settings, as needed.
    FieldDescription
    Name

    Enter a name for the connector profile.

    Description

    Briefly describe the connector profile.

    SEM Manager

    This field is read only. 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.

    Available Agents/Contained Agents

    Add or remove Agents from your connector profile.

    An Agent can only be a member of one connector profile. You cannot add an Agent to multiple connector profiles.

    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 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.

    Edit Connectors

    Click Edit Connectors (in the bottom left corner of the Connector Profile pane) to edit the connectors in the connector profile.

    1. Find the connector to configure:
      • Type part of the connector name in the search box, or use the filter menus in the Refine Results pane.

      • To restrict the list to only configured connectors, select Configured.

    2. Next to the connector instance, click , and then select New.
    3. Complete the connector configuration form. The following fields are common across most connectors:
      • Alias: Enter a user-friendly label for your connectors.

      • Log File: Enter the location of the log file that the connector will normalize. This is a location on either the local computer (Agents), or the SEM appliance (non-Agent devices).

      • Output, nDepth Host, and nDepth Port: You only need to configure these values if SEM is configured to save raw (unnormalized) log messages.

    4. Click Save, and then choose from the following:

      • Click Activate to apply your changes to all Agents associated with the connector profile.
      • Click Discard to discard your changes and reload the previous connectors configuration.
    5. To close the Connector Configuration form and return to the Groups grid, click Close.

    SaveTo save your changes, click Save.
  6. To save the connector profile, click Save.

  7. To apply your changes to all Agents associated with the connector profile, click Activate. To discard your changes and reload the previous connectors configuration, click Discard.

    At times, not all the Agents in a profile will use the same logging path for a particular connector. You can verify this by checking the Agent’s configured connector status. If a connector has a not running status, the connector may have a different logging path.

    To correct this problem, you may want to add another instance to the connector profile’s connector catalog that points to the alternative logging path. You can also create a new profile that has the alternative logging path.

  8. Repeat this procedure for each connector instance you want to reconfigure.

  9. To return to the Groups grid, click Close.

Add additional connectors to a connector profile

See Edit the connector-profile settings and click Edit Connectors when you update the connector settings.