Submit a ticketCall us

Have You Auto Renewed? If not, you're missing out.
The SolarWinds Renewal Program comes with a host of benefits including the most recent product updates, 24/7 technical support, virtual instructor-led training and more. Experience all of this with the convenience of Auto Renewal, and never worry about missing any of these great benefits. Learn More.

Home > Success Center > Log & Event Manager (LEM) > LEM Administrator's Guide > Edit LEM Agent connector-profile settings

Edit LEM Agent connector-profile settings

Updated: September 15, 2017

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 LEM console. See Log in to the LEM web console or Log in to the LEM desktop console for steps.

  2. Open the Build > Groups view.

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

  4. Click and 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 LEM console. See Log in to the LEM web console or Log in to the LEM desktop console for steps.

  2. Open the Build > Groups view.

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

  4. Click and 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 LEM console. See Log in to the LEM web console or Log in to the LEM desktop console for steps.

  2. Open the Build > Groups view.

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

  4. Click and select Edit.

  5. In the Properties form, update the connector settings, as needed.

    Field Description
    Name

    Enter a name for the connector profile.

    Description

    Briefly describe the connector profile.

    LEM Manager

    This field is read only. To copy a connector profile for use with another LEM 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 File:Success_Center/Reusable_content_-_InfoDev/LEM/Log_and_Event_Manager_Administrator's_Guide/LEM_Administrator's_Guide/0370-Edit_LEM_Agent_connector-profile_settings/icon-selectone_14x14.png or File:Success_Center/Reusable_content_-_InfoDev/LEM/Log_and_Event_Manager_Administrator's_Guide/LEM_Administrator's_Guide/0370-Edit_LEM_Agent_connector-profile_settings/icon-selectall_14x14.png 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 File:Success_Center/Reusable_content_-_InfoDev/LEM/Log_and_Event_Manager_Administrator's_Guide/LEM_Administrator's_Guide/0370-Edit_LEM_Agent_connector-profile_settings/icon-removeone_14x14.png or File:Success_Center/Reusable_content_-_InfoDev/LEM/Log_and_Event_Manager_Administrator's_Guide/LEM_Administrator's_Guide/0370-Edit_LEM_Agent_connector-profile_settings/icon-removeall_14x14.png 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. Click next to the connector instance, 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 LEM appliance (non-Agent devices).

      • Output,nDepth Host, andnDepth Port: You only need to configure these values if LEM is configured to save raw (un-normalized) 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. Click Close to close the Connector Configuration form and return to the Groups grid.

    Save Click Save to save your changes.
  6. Click Save to save the connector profile.

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

    At times, not all of 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 File:Success_Center/Reusable_content_-_InfoDev/LEM/Log_and_Event_Manager_Administrator's_Guide/LEM_Administrator's_Guide/0770-Test_enable_and_disable_rules_in_LEM/icon-disabled_14x14.png 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. Click Close to return to the Groups grid.

Add additional connectors to a connector profile

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

Last modified

Tags

Classifications

Public