ONTAP 9.14.1 commands

system switch ethernet create

Add information about an Ethernet switch (cluster, management or storage).

Availability: This command is available to cluster administrators at the admin privilege level.


The system switch ethernet create command manually configures and enables the health monitoring of a specified Ethernet switch of type: cluster, management, or storage. This command might be needed when ONTAP is unable to automatically discover and initiate monitoring of a switch that is advertising its presence using either the Cisco Discovery Protocol (CDP) or the Link Layer Discovery Protocol (LLDP). To identify which switches are currently monitored, use the system switch ethernet show command. If this was a previously discovered or manually added switch within the past 7 days, hourly AutoSupport® log collection might automatically resume.


-device <text> - Device Name

Name of the switch intended for monitoring. ONTAP utilizes this device name to recognize the SNMP agent it needs to interact with.

-address <IP Address> - IP Address

IP address of the switch’s management interface. This address is used as the destination of SNMP traffic and SSH connections for the purpose of monitoring and log collection, respectively.

-snmp-version {SNMPv1|SNMPv2c|SNMPv3} - SNMP Version

SNMP version that ONTAP employs for sending SNMP requests for monitoring purposes. By default, SNMPv2c is used, as established by the Reference Configuration File (RCF) applied to the switch.

-community-or-username <text> - SNMPv2c Community String or SNMPv3 Username

Community string used for SNMPv2 authentication, or the SNMPv3 username for SNMPv3 security. By default, the community string for SNMPv2 authentication is set to cshm1! , as determined by the RCF that is applied to the switch. If SNMPv3 is used, the switch must be configured with the SNMPv3 username.

-model {NX5010|NX5020|CAT2960|OTHER|NX5596|CN1610|CN1601|NX3132|NX5548|NX3132V|OT9332|NX3132XL|NX3232C} - Model Number

Model of the switch. Use the OTHER option when adding a switch that requires an Ethernet switch health monitor XML configuration file, such as the BES-53248, MSN2100-CB2FC, MSN2100-CB2RC, N9K-C92300YC, and N9K-C9336C-FX2 switches. Be aware that the OTHER option selected during creation is different from the OTHER displayed by the system switch ethernet show command. In this show command, OTHER indicates that a switch is not supported for health monitoring.

-type {cluster-network|management-network|storage-network} - Switch Network

Switch type: cluster-network , storage-network , or management-network .

[-is-monitoring-enabled-admin {true|false}] - Enable Switch Monitoring

Monitoring status selected by the administrator, which is set to true by default when not specified. During maintenance periods, a switch not manually added might be repeatedly discovered and dropped, which could potentially generate unnecessary alerts if monitoring is enabled by default. In such cases, setting this parameter to false disables the monitoring process.


Example 1: Initiates Ethernet switch health monitoring for a Cisco Nexus 3132Q-V cluster switch named SwitchA.

cluster1::> system switch ethernet create -device SwitchA -address -snmp-version SNMPv2c -community-or-username cshm1! -model NX3132V -type cluster-network

Example 2: Initiates Ethernet switch health monitoring for a NVIDIA SN2100 storage switch named SwitchB, with the SNMPv3 username snmpv3u1.

cluster1::> system switch ethernet create -device SwitchB -address -snmp-version SNMPv3 -community-or-username snmpv3u1 -model OTHER -type storage-network
Top of Page