Configuring Managed Network Components

In order for Mellanox NEO ® to retrieve information from Mellanox Onyx ® managed switches and hosts, additional configuration on switches and hosts is required.

To configure all Mellanox Onyx managed switches via Mellanox NEO GUI, perform the following:

  1. Go to the “Managed Devices” table (Managed Elements → Devices).

  2. Select the desired Mellanox Onyx switches to configure SNMP on (you can select multiple switches).

  3. Right click on the selected switches and click on “Provisioning”

  4. In the “Provisioning” view, click on the “Templates” button and load the “Enable-SNMP” template.

  5. Click on the “Apply” button.

  6. To send the configuration to the selected switches, click on the “Start” button. This will redirect you to the “Jobs” table.

  7. Make sure that all sub-jobs (all switches) are completed successfully.

    Warning

    To configure the SNMP-V3 protocol, refer to the Mellanox Onyx User Manual.

    Warning

    For the SNMP monitoring to work properly, the credentials on the switch must match the Mellanox NEO switch settings.

NEO can listen to SNMP traps and generate events upon receiving them. NEO supports both SNMP v3 and v2c traps.

By default, NEO listens to SNMP v2c traps. If you want to use SNMP v3, refer to Setting NEO SNMP Trap Protocol Registration in order to configure NEO to listen to it.

You can configure the switches to send SNMP traps to NEO using one of these two methods:

  • Using auto-provisioning: When adding the device, check the SNMP Traps auto-provisioning option. The protocol version configured (2c/3) depends on the SNMP protocol version active in the Onyx global credentials.

  • Using provisioning templates:

    1. Go to the “Managed Devices” table (Managed Elements → Devices).

    2. Select one or more of the desired Mellanox Onyx switches to configure SNMP on (you can select multiple switches).

    3. Right-click the selected switches and click “Provisioning”.

    4. In the “Provisioning” view, click the “Templates” button and load template relevant for the SNMP protocol you use (“Set-SNMP-V2c-Traps” or “Set-SNMP-V3-Traps”). For example:

      image2019-3-7_17-43-28.png

    5. Click the “Apply” button.

    6. Set the “ip_address” field in the “Global Variables” panel to be your Mellanox NEO IP address.

    7. Click the “Start” button. This will redirect you to the “Jobs” table.

    8. Make sure that all sub-jobs (all switches) are completed successfully.

Warning

NEO removes itself as an SNMP trap listener from Onyx switches when they are removed.

Setting NEO SNMP Trap Protocol Registration

NEO listens by default to SNMP v2c traps. If the user changes the active SNMP protocol in the Onyx global credentials, the trap listening is also changed accordingly.

To configure NEO side SNMP v3 or v2c trap listening properties, edit the file /opt/neo/providers/dm/conf/netservice.cfg.

  • When working with SNMP v2c, configure the following attributes in the [Snmp] section:

    Copy
    Copied!
                

    [Snmp] #valid protocol: snmpV2c, snmpV3 protocol=snmpV2c #valid for snmpV2c community=public

  • When working with SNMP v3, configure the following attributes in the [Snmp] section:

    Copy
    Copied!
                

    [Snmp] #valid protocol: snmpV2c, snmpV3 protocol=snmpV3 #valid for snmpV3 #valid auth protocol: MD5, SHA auth_protocol=MD5 #valid priv protocol: DES, AES-128 priv_protocol=DES auth_password=adminauth123 priv_password=adminpriv123

For the configuration changes to take effect, restart NEO by running:

Copy
Copied!
            

/opt/neo/neoservice restart


To configure all managed Mellanox Onyx switches via the Mellanox NEO GUI, perform the following:

  1. Go to the “Managed Devices” table (Managed Elements → Devices).

  2. Select the desired Mellanox Onyx switches to configure SNMP on (you can select multiple switches).

  3. Right click on the selected switches and click on “Provisioning”.

  4. In the “Provisioning” view, click on the “Templates” button and load the “Enable-LLDP” template.

  5. Click on the “Apply” button.

  6. Click on the “Start” button to send the configuration to the selected switches.

  7. Click on the “Start” button. This will redirect you to the “Jobs” table.

  8. Make sure all sub-jobs (all switches) are completed successfully.

In order to allow the LLDP to discover hosts, you must configure it accordingly. For instructions, refer to the following community page: HowTo Enable LLDP on Linux Servers for Link Discovery.

When configuring LLDP on the host, please make sure to configure the LLDP to publish the management IPv4 address of the host (i.e. the IP that Mellanox NEO must recognize and manage). Not doing so might result in non-deterministic behavior.

Basic authentication works across firewalls and proxy servers. Basic authentication requires valid user name and password to access content.

By default, Windows host authentication type is Kerberos. In order to connect to NEO, make sure basic authentication is enabled as well.

Allow basic and unencrypted message passing over WinRM on each of the Windows managed machines. Run the following command over PowerShell:

Copy
Copied!
            

winrm set winrm/config/service @{AllowUnencrypted="true"} winrm set winrm/config/service/auth @{Basic="true"}

Set the device credentials in the UI. Username attribute format must include the domain (user- name@domain), for example: administrator@mellanox.com.

image2019-4-19_0-23-19.png

© Copyright 2023, NVIDIA. Last updated on Nov 14, 2023.