Hewlett Packard Enterprise M-Series User Manual

Hewlett Packard Enterprise M-Series User Manual

Onie switch

Advertisement

M-Series ONIE Switch
User Manual
Rev 1.6
Mellanox ONIE Ver. 5.2.0004
Part number: P12821-001
Published: December 12, 2018
Edition: 1

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the M-Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Hewlett Packard Enterprise M-Series

  • Page 1 M-Series ONIE Switch User Manual Rev 1.6 Mellanox ONIE Ver. 5.2.0004 Part number: P12821-001 Published: December 12, 2018 Edition: 1...
  • Page 2 Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise website. Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use or copying.
  • Page 3: Table Of Contents

    Table of Contents Document Revision History ........4 Preface .
  • Page 4: Document Revision History

    Document Revision History Table 1 - Document Revision History Revision Date Description Rev 1.6 December 07, 2018 Added Section 2.3, “Update BIOS,” on page 18 Enhanced user manual with printouts of ONIE Grub Menu Updated Section 2.2, “Boot Modes,” on page 14 Rev 1.5 January 25, 2018 Added:...
  • Page 5: Preface

    Preface Intended Audience This document and the system is a bundle intended for system engineers and system developers interested in assembling their own OS on top of Mellanox switch systems. The system provides an easy way to install a user-defined OS over a Mellanox switch system. This document contains instructions supplementary to the official ONIE documentation refer- enced in the section.
  • Page 6 Table 3 - Typographical Conventions Description Convention Example Comments to explain command // This is a comment examples Variables for which users supply Italic font enable specific values Emphasized words Italic font These are emphasized words Note <text> This is a note. Warning <text>...
  • Page 7: Chapter 1 Introduction

    Introduction Introduction ONIE (Open Network Install Environment) is an open source initiative which enables automatic installation of user-defined OS whose function is to setup a network OS that provides the follow- ing services: • Re/installing an OS • Booting in "rescue" mode •...
  • Page 8: Log Facilities

    Introduction Configure a serial terminal program (for example, HyperTerminal, minicom, or Tera Term) Step 2. on your host PC with the settings described in the table below. Table 5 - Serial Terminal Program Configuration for 2016.11-5.2.0004-115200 Parameter Setting Baud rate 115200 Data bits Stop bits...
  • Page 9 Introduction Nov 25 12:47:43 sys-hostname local0.info onie: done. Nov 25 12:47:43 sys-hostname local0.info onie: Starting: discover... Nov 25 12:47:43 sys-hostname local0.info onie: done. Nov 25 12:47:43 sys-hostname local0.info onie: Info: eth0: Checking link... Nov 25 12:47:43 sys-hostname local0.info onie: up. Nov 25 12:47:43 sys-hostname local0.info onie: Info: Trying DHCPv4 on interface: eth0 Nov 25 12:47:43 sys-hostname local0.info onie: ONIE: Using DHCPv4 addr: eth0: 10.7.144.133 / 255.255.248.0 Nov 25 12:47:43 sys-hostname local0.info discover: ONIE: Starting ONIE Service Discovery...
  • Page 10: Booting Into Onie System

    Introduction Nov 25 12:48:00 sys-hostname local0.info onie-exec: Info: Attempting http://10.7.77.135/onie-installer-x86_64-mlnx_msn2100-r0 ... Nov 25 12:48:00 sys-hostname local0.info onie-exec: Info: Attempting http://10.7.77.135/onie-installer-x86_64-mlnx_msn2100-r0.bin Nov 25 12:48:00 sys-hostname local0.info onie-exec: Info: Attempting http://10.7.77.135/onie-installer-x86_64-mlnx_msn2100 ... Nov 25 12:48:00 sys-hostname local0.info onie-exec: Info: Attempting http://10.7.77.135/onie-installer-x86_64-mlnx_msn2100.bin ... Nov 25 12:48:00 sys-hostname local0.info onie-exec: Info: Attempting http://10.7.77.135/onie-installer-mlnx_msn2100 ...
  • Page 11: Chapter 2 How-Tos

    How-Tos How-Tos Install Network OS The following subsections illustrate how to install a Network OS using different methods. 2.1.1 From DHCP Server Perform the following in your DHCP server. Define a DHCP filename by configuring it in /etc/dhcpd.conf. Run: Step 1. filename "tftpboot_location/onie-installer-x86_64-mlnx_x86-r5.2.0004.bin";...
  • Page 12: From Ipv6 Neighbors

    How-Tos [1018004.495413] sd 0:0:0:0: [sda] Synchronizing SCSI cache [1018004.501473] Starting new kernel [ 0.000000] Initializing cgroup subsys cpuset [ 0.000000] Initializing cgroup subsys cpu 2.1.3 From IPv6 Neighbors  To install a Network OS from IPv6 neighbors using an installer test script: Boot ONIE in install mode by selecting "Install OS"...
  • Page 13: From Local Usb Drive

    How-Tos 2.1.4 From Local USB Drive ONIE discovery and installation from USB does not support EXFAT (NTFS). Use VFAT or FAT32 formatting instead.  To install a Network OS from a USB drive: Put the NOS image inside the USB root directory. Step 1.
  • Page 14: Boot Modes

    How-Tos Copy NOS image to /tmp/nos: Step 5. ONIE:/ # scp root@192.168.1.21:/tftpboot/cumulus-linux-3.5.3-mlx-amd64.bin /tmp/nos Do you want to continue connecting? (y/n) yes root@192.168.1.21’s password: cumulus-linux-3.5.3-mlx-amd64.bin 100% 212MB 19.3MB/s 00:11 cd to directory and install NOS image: Step 6. ONIE:/ # cd /tmp/nos ONIE:/tmp/nos # onie-nos-install cumulus-linux-3.5.3-mlx-amd64.bin discover: installer mode detected.
  • Page 15: Mellanox Onie Update

    How-Tos Select "Rescue" in the ONIE GRUB menu: Step 1. GNU GRUB version 2.02 +---------------------------------------------+ | ONIE: Install OS |*ONIE: Rescue | ONIE: Uninstall OS | ONIE: Update ONIE | ONIE: Embed ONIE +---------------------------------------------+ Run "rescue": Step 2. # rescue ONIE: Rescue Mode ...
  • Page 16: Uninstall

    How-Tos Run the command "onie-self-update": Step 2. ONIE:/ # onie-self-update http://20.20.20.20/onie-updater-x86_64-mlnx_x86-r5.2.0004 topping: discover... done. Info: Fetching http://20.20.20.20/onie-updater-x86_64-mlnx_x86-r5.2.0004 ... Connecting to 20.20.20.20 (20.20.20.20:80) installer 100% |*******************************| 24601k 0:00:00 ETA ONIE: Executing installer: http://<ip address>/onie-updater-x86_64-mlnx_x86-r5.2.0004 Verifying image checksum ... OK. Preparing image archive ... OK. ONIE: Version : master-201604201145 ONIE: Architecture : x86_64...
  • Page 17: Embed

    How-Tos Run the command "uninstall": Step 2. ONIE:/ # uninstall ONIE: OS Uninstall Mode ... Version : master-201604201145 Build Date: 2016-04-20T13:08+0300 5.796828] i8042: No controller found Info: Mounting kernel filesystems... done. Info: Mounting LABEL=ONIE-BOOT on /mnt/onie-boot ... 10.270675] LPCI2C DBG: LPC Generic Decode Range 2 configured: 0xfc2001 10.277368] LPCI2C DBG: LPC Generic Decode Range 3 configured: 0xfc2501 ONIE:/ # + /bin/umount -a -r The system is going down NOW!
  • Page 18: Reinstall

    How-Tos 2.2.5 Reinstall There are two possible methods to reinstall the network OS on a x86 system: 1. Uninstall (Section 2.2.3 on page 16) and then install (Section 2.1 on page 11) the OS from ONIE instead (scrubs the former data). 2.
  • Page 19: Chapter 3 Cli Reference

    CLI Reference CLI Reference ONIE Commands onie-syseeprom onie-syseeprom Display the system EEPROM data block. Syntax Description Default History 5.0.0100 Example ONIE:/ # onie-syseeprom TlvInfo Header: Id String: TlvInfo Version: Total Length: 584 TLV Name Code Len Value -------------------- ---- --- ----- Product Name 0x21 64 MSN2700...
  • Page 20 CLI Reference onie-syseeprom --list onie-syseeprom --list Lists the supported TLV (type, length and value) codes and names. Syntax Description Default History 5.0.0100 Example ONIE:~ # onie-syseeprom --list TLV Code TLV Name ======== ================= 0x21 Product Name 0x22 Part Number 0x23 Serial Number 0x24 Base MAC Address...
  • Page 21 CLI Reference onie-syseeprom --get onie-syseeprom --get Locates a TLV by code and write the value to stdout. Syntax Description Default History 5.0.0100 Example ONIE:~ # onie-syseeprom --get 0x22 MSX1710-BS2F2E ONIE:~ # Note...
  • Page 22 CLI Reference onie-nos-install onie-nos-install Installs a network operation system. Syntax Description Default History 5.0.1404 Example ONIE:~ # onie-nos-install http://<ip-address>/CumulusLinux-3.0.0- 1456539878.a71971a-amd64.bin Stopping: discover... done. Info: Fetching http://<ip-address>/CumulusLinux-3.0.0- 1456539878.a71971a-amd64.bin ... Connecting to <ip-address> (<ip-address>:<port>) installer 100% |*******************************| 271M 0:00:00 ETA ONIE: Executing installer: http://<ip-address>/CumulusLinux-3.0.0- 1456539878.a71971a-amd64.bin Verifying image checksum ...
  • Page 23 CLI Reference onie-stop onie-stop Disables DHCP auto-discovery. Syntax Description Default History 5.0.1404 Example ONIE:~ # onie-stop Stopping: discover... done. ONIE:~ # Note onie-start onie-start Enables DHCP auto-discovery Syntax Description Default History 5.0.1404 Example ONIE:~ # onie-start Starting: discover... done. ONIE:~ # Note...
  • Page 24: Onie-Sysinfo -V" On

    CLI Reference onie-sysinfo onie-sysinfo Displays platform information. Syntax Description Default History 5.0.1404 5.1.0012 Updated example Example ONIE:~ # onie-sysinfo x86_64-mlnx_msn2700-r0 ONIE:/ # Note onie-sysinfo -v onie-sysinfo Displays ONIE version details. Syntax Description Default History 5.1.0012 Example ONIE:~ # onie-sysinfo -v 2016.11-5.2.0004-115200 ONIE:~ # Note...
  • Page 25: Support And Other Resources

    Support and Other Resources Accessing Hewlett Packard Enterprise Support • For live assistance, go to the Contact Hewlett Packard Enterprise Worldwide website: http://www.hpe.com/assistance • To access documentation and support services, go to the Hewlett Packard Enterprise Support Center website: http://www.hpe.com/support/hpesc Information to Collect •...
  • Page 26: Customer Self Repair

    If a CSR part needs to be replaced, it will be shipped directly to you so that you can install it at your convenience. Some parts do not qualify for CSR. Your Hewlett Packard Enterprise autho- rized service provider will determine whether a repair can be accomplished by CSR.
  • Page 27: Remote Support

    Remote support is available with supported devices as part of your warranty or contractual sup- port agreement. It provides intelligent event diagnosis, and automatic, secure submission of hard-ware event notifications to Hewlett Packard Enterprise, which will initiate a fast and accurate resolution based on your product's service level. Hewlett Packard Enterprise strongly recom-mends that you register your device for remote support.
  • Page 28: Websites

    Additional Regulatory Information Hewlett Packard Enterprise is committed to providing our customers with information about the chemical substances in our products as needed to comply with legal requirements such a s REACH (Regulation EC No 1907/2006 of the European Parliament and the Council). A chemi- cal information report for this product can be found at: www.hpe.com/info/reach...

Table of Contents