Scale Mellanox SN2010 User manual

Mellanox SN2010
Quickstart Guide
Document Version 1.0: 10/2018
© Scale Computing 2018 1

Table of Contents
Introduction 3
Requirements 3
Connect to the Switch 4
Console 4
CLI Mode Basics 5
Initial Configuration 6
Update the Firmware 7
Download the Latest Firmware 7
General Configuration 8
Create VLANs 8
Logging 8
Port Configuration 9
Switchport Access Mode 9
Switchport Hybrid Mode 9
Configure Spanning Tree 9
Generate Troubleshooting Diagnostics 11
Feedback & Support 12
Document Feedback 12
Technical Support and Resources 12
Disclaimer 12
© Scale Computing 2018 2

Introduction
This guide provides general configuration examples. The configurations found here may not be applicable for all
environments. Consult Mellanox’s official documentation for further information in regards to your environment's
unique configuration.
The SN2010 supports the same features and scale as the SN2700. The SN2010 design allows either stand-alone
single switch installation, or side-by-side placement of two switches in a single 1RU slot of a 19” rack, delivering high
availability to the hosts.
Requirements
●A Terminal Emulation program, such as PuTTY.
●A serial to USB adapter.
© Scale Computing 2018 3

Connect to the Switch
Using a terminal emulator, such as PuTTY, connect the provided serial adapter to the port shown below.
Set your console settings as follows:
●Default baud rate = 115200 bps
●Parity = none
●Stop bits = 1
●Data bits = 8
●Flow control = none
The default username is admin and the default password is admin.
© Scale Computing 2018 4

CLI Mode Basics
Configuration for the SN2010 is performed through a CLI interface. As a reference:
> = unprivileged mode
# = privileged mode
(config)# = global configuration mode
(config interface ethernet 1/1)# = interface configuration mode
Upon login you will be in the unprivileged mode. To enter privileged mode:
> enable
#
NOTE
You can use ? to display what commands are available in the current mode.
In order to configure the switch we need to enter global configuration mode. This mode is used for settings that
aren’t specific to the switch ports.
# conf t
(config)#
Configuration of switch ports is performed in interface configuration mode. To return to the previous configuration
level:
(config interface ethernet 1/1)# exit
(config)#
© Scale Computing 2018 5

Initial Configuration
After logging into the switch via the console port, begin the initial configuration wizard. The following is an example
configuration:
Configuration wizard
Do you want to use the wizard for initial configuration? yes
Step 1: Hostname? [switch-2f5160]
Step 2: Use DHCP on mgmt0 interface? [yes] no
Step 3: Use zeroconf on mgmt0 interface? [no]
Step 4: Primary IPv4 address and masklen? [0.0.0.0/0] 10.0.0.1/24
Step 5: Default gateway? 10.0.0.1
Step 6: Primary DNS server? 10.0.0.1
Step 7: Domain name? scalecomputing.local
Step 8: Enable IPv6? [yes] no
Step 9: Admin password (Enter to leave unchanged)?
You have entered the following information:
1. Hostname: switch-2f5160
2. Use DHCP on mgmt0 interface: no
3. Use zeroconf on mgmt0 interface: no
4. Primary IPv4 address and masklen: 10.0.0.1/24
5. Default gateway: 10.0.0.1
6. Primary DNS server: 10.0.0.1
7. Domain name: scalecomputing.local
8. Enable IPv6: no
9. Admin password (Enter to leave unchanged): (unchanged)
To change an answer, enter the step number to return to.
Otherwise hit <enter> to save changes and exit.
Choice:
Zero-touch is disabled
Configuration changes saved.
To return to the wizard from the CLI, enter the "configuration jump-start"
command from configure mode. Launching CLI...
switch-2f5160 [standalone: master] >
© Scale Computing 2018 6

Update the Firmware
Download the Latest Firmware
To download the latest firmware image and documentation, create an account on the Mellanox support site.
After logging into the Mellanox support portal, you can find the firmware image by navigating to Switches and
Gateways > Ethernet Switch Systems > SN2010 > Downloads.
The latest user manuals are found under Switches and Gateways > Ethernet Switch Systems > SN2010 >
Documentation. The file names for user manuals end in '_UM
.'
The firmware image can be loaded via FTP or SCP. Make sure your firewall will allow port 22, or turn it off
temporarily. If you are using a linux machine, ensure sshd is running.
In this example we are using SCP to copy the image into the switch.
(config)# image fetch scp://<USERNAME>:<PASSWORD>@<IP-ADDRESS>/var/www/html/<IMAGE-FILE>
(config)# image install
(config)# image boot next
(config)# configuration write
(config)# reload
To examine what firmware images are currently loaded on the system:
(config)# show images
Reboot the switch to load the new firmware:
(config)# reload
© Scale Computing 2018 7

General Configuration
Create VLANs
You may create VLANs using vlan. An example is shown below.
(config)# vlan 2
(config-vlan)# name SCALEBACKPLANE
Logging
Troubleshooting relies heavily on inspecting the switch events. To enable event tracking for the group interfaces:
(config)# logging events interfaces enable
If there is a remote syslog server available:
(config)# logging 10.205.13.36
© Scale Computing 2018 8

Port Configuration
By default, all ports are in access mode for VLAN 1. If you are not utilizing VLANs in your environment, you will not
need to configure the VLAN settings for the switch ports further. We recommend isolating backplane ports for Scale
Computing equipment to a VLAN other than 1 using access mode.
Switchport Access Mode
Access mode allows only one VLAN to be configured for a switch port. Use this mode when connecting an end
device that is unaware of VLANs, such as the Scale Computing node backplane ports.
(config)# interface ethernet 1/1
(config interface ethernet 1/1)# switchport mode access
(config interface ethernet 1/1)# switchport access vlan 10
Switchport Hybrid Mode
Hybrid mode is used when an interface needs to carry multiple VLANs, such as the Scale Computing LAN ports. If
your VMs need access to specific VLANs other than what the Scale Computing node itself resides upon, you will
need to tag those VLANs. In this example, the Scale Computing appliance is being managed on VLAN 5. The
management interface is unaware of VLANs and thus needs to be untagged traffic. Any additional VLANs need to be
added to the list of allowed-vlan.
(config)# interface ethernet 1/1
(config interface ethernet 1/1)# switchport mode hybrid
(config interface ethernet 1/1)# switchport access vlan 5
(config interface ethernet 1/1)# switchport hybrid allowed-vlan add 10
Configure Spanning Tree
Ensure spanning tree is enabled:
(config)# spanning-tree
(config)# spanning-tree mode rpvst
NOTE
The number of VLANs supported by RPVST is 128.
Set ports connected to Scale Computing equipment to edge mode:
(config)# interface ethernet 1/1
(config interface ethernet 1/1)# spanning-tree port type edge
© Scale Computing 2018 9

Verify the spanning tree settings:
(config)# show spanning-tree
Switch : ethernet-default
Spanning tree protocol rst : enabled
Spanning tree force version: 2
Root ID:
Priority : 32768
Address : 50:6b:4b:9a:06:00
Bridge root : yes
Hello Time (sec) : 2
Max Age (sec) : 20
Forward Delay (sec): 15
Bridge ID:
Priority : 32768
Address : 50:6b:4b:9a:06:00
Hello Time (sec) : 2
Max Age (sec) : 20
Forward Delay (sec): 15
L: Loop Inconsistent
R: Root Inconsistent
G: BPDU Guard Inconsistent
--------------------------------------------------------------------------
Interface Role Sts Cost Prio Type
--------------------------------------------------------------------------
© Scale Computing 2018 10

Generate Troubleshooting Diagnostics
You can generate a diagnostic dump for use in troubleshooting and opening support cases with Mellanox.
(config)# debug generate dump
Generated dump sysdump-switch-2f5160-20010101-020754.tgz
(config)# file debug-dump upload latest scp://root:password@10.0.0.2/root
Uploading file sysdump-switch-2f5160-20010101-020754.tgz
Replace the user root and the password with your user credentials. Replace the path /root to one appropriate
for your local machine.
© Scale Computing 2018 11

Feedback & Support
Document Feedback
Scale Computing welcomes your suggestions for improving our documentation. Please send your feedback to
Technical Support and Resources
There are many technical support resources available for use. Access this document, and many others, at
http://www.scalecomputing.com/support/login/.
Disclaimer
Switches are not covered under the support and warranty for the Scale Computing HC3 system. Scale Computing is
not responsible for any issues arising from the use of this guide. Any and all questions, issues, or concerns
regarding switch configuration should be addressed with the switch manufacturer directly.
© Scale Computing 2018 12
Table of contents