Lenovo RackSwitch G8296 User manual

Lenovo RackSwitch G8296
ONIE Quick Start Guide
for Lenovo Network Operating System

Note: Before using this information and the product it supports, read the general information in the
Safety information and Environmental Notices and User Guide documents on the Lenovo Documentation CD,
and the Warranty Information document that comes with the product.
Second Edition (February 2017)
© Copyright Lenovo 2017
LIMITED AND RESTRICTED RIGHTS NOTICE: If data or software is delivered pursuant a General
Services Administration “GSA” contract, use, reproduction, or disclosure is subject to restrictions set
forth in Contract No. GS-35F-05925.
Lenovo and the Lenovo logo are trademarks of Lenovo in the United States, other countries, or both.

© Copyright Lenovo 2017 Contents 3
Contents
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Connecting to the G8296 . . . . . . . . . . . . . . . . . . . . . 6
Switch Unit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Mini-USB Serial Console Port . . . . . . . . . . . . . . . . . . . . . 7
Geographic Layout of the Temperature Sensors . . . . . . . . . . . . . 8
ONIE on the G8296 . . . . . . . . . . . . . . . . . . . . . . . 11
Installing the ONIE FoD License Key . . . . . . . . . . . . . . . . . . 12
Obtaining the ONIE License Key . . . . . . . . . . . . . . . . . . 12
Installing the ONIE License Key on CNOS . . . . . . . . . . . . . . 13
Uninstalling the ONIE License Key on CNOS . . . . . . . . . . . 13
Installing ONIE. . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing ONIE on CNOS . . . . . . . . . . . . . . . . . . . . . 14
Booting in ONIE Mode . . . . . . . . . . . . . . . . . . . . . . . . 16
Booting in ONIE Install Mode. . . . . . . . . . . . . . . . . . . . 16
Booting in ONIE Uninstall Mode . . . . . . . . . . . . . . . . . . 17
Booting in ONIE Update Mode . . . . . . . . . . . . . . . . . . . 18
Booting in ONIE Rescue Mode . . . . . . . . . . . . . . . . . . . 18
The Boot Management Menu . . . . . . . . . . . . . . . . . . . . . . 19
Uninstalling the Lenovo Network OS . . . . . . . . . . . . . . . . . . 20
Using ONIE without Lenovo Network OS . . . . . . . . . . . . . . . . 21

4 Lenovo ONIE Quick Start Guide for G8296

© Copyright Lenovo 2017 5
Overview
The Open Network Install Environment (ONIE) is a small Linux-based operating
system that provides an open install environment for network switches without
operating systems.
ONIE enables a network switch ecosystem where end-users can choose among
different Network Operating Systems (NOS). Practically, ONIE boots on a switch,
discovers NOS installer images available on the local network or USB drive, copies
the chosen image to the switch, and provides an environment where the installer
can load the NOS onto the switch.
ONIE is classified as free software, meaning it can be redistributed and/or modified
under the terms of version 2 of the GNU General Public License as published by the
Free Software Foundation. To read the license, visit the following link:
https://github.com/opencomputeproject/onie/blob/master/COPYING
For more details about ONIE, go to onie.org .
Lenovo ONIE Image
To download the Lenovo ONIE image, visit the following website:
http://support.lenovo.com/
The ONIE images for the G8296 have the [ONIE] tag in their name, as follows:
for Lenovo Cloud Network OS:
Lenovo Rackswitch G8296 [ONIE] 10.x.x.0

6 Lenovo ONIE Quick Start Guide for G8296
Connecting to the G8296
This section describes how to connect to the Lenovo RackSwitch G8296. For more
details about the switch and on how to install the switch hardware, consult the
Lenovo RackSwitch G8296 Installation Guide .
Switch Unit
The G8296 is a 2U GbE switch and it can be rack-mounted in a horizontal position.
The following illustrations show the features on the front and rear panels of the
switch:
Figure 1. G8296 front panel
Figure 2. G8296 management panel detail
Figure 3. G8296 rear panel
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
93 95
94 96
87
88
89 91
90 92
SFP+ Ports QSPF+ Ports
Management Panel
SFP+ Ports QSPF+ Ports
Reset Button
Mini-USB
Serial Console Port
USB Port
RJ-45
Management Port
Status LEDs
Fan Modules Power Supply Modules

© Copyright Lenovo 2017 Connecting to the G8296 7
Mini-USB Serial Console Port
The mini-USB port on the front management panel is available for switch console
management. The port operates using RS-232 serial communications. A compatible
console cable kit is included with the switch.
To connect a computer or terminal to the switch using the included kit, first connect
the console cable to the mini-USB port on the front panel. Connect one end of the
Category 5 patch cable to the RJ-45 port on the console cable and the other end of
the patch cable to the RJ-45-to-DB9 adapter (see the following illustration).
Figure 4. Console cable connections
The computer or terminal must run a terminal emulator (for example, SecureCRT,
HyperTerminal, or PuTTY). The console port terminal emulation requirements are
as follows:
• Default baud rate: 9,600 bps
• Character size: 8 characters
• Parity: none
• Stop bits: 1
• Data bits: 8
• Flow control: none
To PC
Terminal
To
Switch
RJ-45 Adapter
Category 5
Patch Cable
Switch
Console Cable

8 Lenovo ONIE Quick Start Guide for G8296
Geographic Layout of the Temperature Sensors
The following illustrations show the location of the temperature sensors (pointed
out with red arrows) on the main and CPU boards.
Figure 5. G8296 CPU Board Temperature Sensors
Ambient U8, I2C @ 1001.101x on CH0 of PCA9546, P4040 I2C Bus 3

© Copyright Lenovo 2017 Connecting to the G8296 9
Figure 6. G8296 Main Board Temperature Sensors
Front of the card U5, I2C @ 1001.001x on CH0 of PCA9548, P4040 I2C Bus 1
Close to switch ASIC U16, I2C @ 1001.010x on CH0 of PCA9548, P4040 I2C Bus 1
Rear of the card U38, I2C @ 1001.000x on CH0 of PCA9546, P4040 I2C Bus 2

10 Lenovo ONIE Quick Start Guide for G8296
Figure 7. G8296 Daughter Card Temperature Sensors
Front of the card U10, I2C @ 1001.100x on CH1 of PCA9548, P4040 I2C Bus 1
Rear of the card U17, I2C @ 1001.101x on CH1 of PCA9548, P4040 I2C Bus 1

© Copyright Lenovo 2017 ONIE on the G8296 11
ONIE on the G8296
The Lenovo RackSwitch G8296 comes out of the box with Lenovo Enterprise
Network OS (ENOS) already installed on the switch.
To ensure maximum security, ONIE is not available on the switch by default. To
enable the running of ONIE on the switch, you must follow these steps:
1. Download and install a compatible Lenovo Network OS.
You can download the latest Lenovo NOS images from the following link:
http://support.lenovo.com/
You can install ONIE on G8296s running:
Lenovo Cloud Network OS (CNOS) version 10.2 or later
Note: Check the Lenovo RackSwitch G8296 Release Notes associated with each
Lenovo Network OS to verify if ONIE is an available feature.
For details on how to upgrade the switch operating system from ENOS to CNOS,
see the
Lenovo RackSwitch G8296 Release Notes for Lenovo Cloud Network Operating
System
.
2. Obtain and install an ONIE Feature on Demand (FoD) license key.
For details on how to acquire and install the ONIE FoD license key on the switch,
see
“Installing the ONIE FoD License Key” on page 12 .
3. Download and install an ONIE image.
For details on how to install ONIE on the switch, see “Installing ONIE” on page 14 .

12 Lenovo ONIE Quick Start Guide for G8296
Installing the ONIE FoD License Key
ONIE is not installed by default and it can be activated only using a Feature on
Demand (FoD) license key. The process of obtaining and installing a FoD license key
is described in the following pages.
Obtaining the ONIE License Key
The ONIE license key or activation key can be acquired using the Lenovo Features on
Demand (FoD) website:
http://fod.lenovo.com/lkms/
You can also use the website to review and manage the license, and to obtain
additional help if required.
Note: An ID and password are required to log into the FoD website. If you do not
have an ID, you can register at the website.
The ONIE FoD license key is provided as a file that must be downloaded to the
switch. To obtain an activation key, acquire an Authorization Code from the Lenovo
Features on Demand website.
To acquire the Authorization Code, you will need to provide the unique ID (UID) of
the specific switch where the ONIE license key will be installed. The UID is the last
12 characters of the switch serial number. This serial number is located on the Part
Number (PN) label.
You can also view the UID of a switch using the following command:
Lenovo Cloud Network OS:
Once the ONIE license key file have been acquired from the Lenovo Features on
Demand website, it must be installed on the G8296.
G8296> display license host-id
System serial number: Y052MV4CR026

© Copyright Lenovo 2017 ONIE on the G8296 13
Installing the ONIE License Key on CNOS
The following example depicts use of the G8296 Command Line Interface (CLI)
running
Cloud NOS (CNOS) to install the ONIE license key.
1. Log into the G8296 and enter Global Configuration command mode:
2. You can install the license key by copying it from a remote server or a USB device:
remote FTP, SCP, SFTP, or TFTP server:
For example, using a TFTP server:
USB device:
For example:
The license key has now been successfully installed on the switch.
3. To view installed license keys, use the following command:
Uninstalling the ONIE License Key on CNOS
To remove the ONIE license key from the switch, use the following command:
For example:
Note: When removing the ONIE license key from the switch, the ONIE software
image is also removed.
G8296> enable
G8296# configure device
G8296(config)#
G8296(config)# license install {ftp|scp|sftp|tftp} <server IP address and
file path> vrf management
G8296(config)# license install tftp tftp://10.120.33.12/fod-keys/fodEE3
vrf management
G8296(config)# license install usb1 <file path>
G8296(config)# license install usb1 fod-keys/fodEE3
G8296> display license brief
G8296(config)# no license install <license file>
G8296(config)# no license install fodEE3

14 Lenovo ONIE Quick Start Guide for G8296
Installing ONIE
Only after you have successfully installed the appropriate FoD license key, you will
be able to install ONIE on the switch. For more details, see
“Installing the ONIE
FoD License Key” on page 12
.
Installing ONIE on CNOS
To install ONIE on the switch running Cloud NOS , use the following steps:
Note: The commands used to install ONIE on the switch will display an error if the
ONIE license key is not installed.
1.
Download an ONIE image for the switch from the following link:
http://support.lenovo.com/
For CNOS, the ONIE image is called Lenovo Rackswitch G8296 [ONIE]
10.x.x.0
.
2. Upload the ONIE image to a local server or a USB drive.
3. Connect to the switch using the mini-USB serial console port. For more details, see
“Connecting to the G8296” on page 6.
4. After connecting to the switch, enter Privileged EXEC configuration mode:
5. Use one of the following commands to copy the ONIE image:
using FTP, SCP, SFTP, or TFTP:
cp ftp <FTP URL> system-image onie [vrf management]
cp scp <SCP URL> system-image onie [vrf management]
cp sftp <SFTP URL> system-image onie [vrf management]
cp tftp <TFTP URL> system-image onie [vrf management]
using a USB drive:
cp usb1 <file path> system-image onie [vrf management]
G8296> enable
G8296#

© Copyright Lenovo 2017 ONIE on the G8296 15
Following is an example using the cp tftp command:
6. To check if the ONIE image was successfully installed on the switch, use the
following command:
In the command output, the current ONIE image installed on the switch is
displayed under the
Current FLASH software section.
G8296# cp tftp tftp://10.72.97.98/onie-img/G8296-CNOS-10.2.1.0_ONIE.imgs
system-image onie vrf management
Confirm download operation? (y/n) [n] y
Download in progress
...
Copy Success
Install image...This takes about 90 seconds. Please wait
Valid image detected.
Check image signature succeeded
Extracting image: 100%
Installing ONIE:
Updating flash: 100%
Updating ONIE eeprom with manufacturing fields...
ONIE image installation succeeded.
ONIE image now contains Software Version 10.2.1.0
G8296# display boot
Current FLASH software:
active image: version 10.2.1.0
standby image: empty
Uboot: version 10.2.1.0
ONIE: version 10.2.1.0
Currently set to boot software active image
Currently scheduled reboot time: none
Current port mode: default mode

16 Lenovo ONIE Quick Start Guide for G8296
Booting in ONIE Mode
After you have activated and installed an ONIE image, you can boot the switch in
ONIE mode. ONIE offers four modes for booting, each providing a different
operation:
ONIE install mode
ONIE rescue mode
ONIE uninstall mode
ONIE update mode
There are two ways to boot the switch in an ONIE mode:
using the Command Line Interface (CLI):
Lenovo Cloud Network OS:
–startup image onie-image install
–startup image onie-image rescue
–startup image onie-image uninstall
–startup image onie-image update
using the Boot Management Menu (for more details, see “The Boot Management
Menu” on page 19)
Note: For CNOS, the commands for booting in the different ONIE modes will
display an error if the ONIE license key is not installed on the switch.
Booting in ONIE Install Mode
This mode is used to install a NOS using ONIE. The ONIE install mode boots the
ONIE kernel and file-system and executes the ONIE discovery process. The
discovery process uses a number of different mechanisms to find a NOS installer
program.
Once a NOS installer is found, it is downloaded and executed. The installer loads
the Network OS on the switch, updates required ONIE environment variables and
reboots the switch.
The switch will now run its newly installed Network OS and behave like a regular
switch. The user can, at any point, reboot and run the ONIE installer again to
install another Network OS.
The Lenovo ONIE installer image, which installs the different Lenovo Network
Operating Systems, is called
onie-installer-powerpc-lenovo_g8296-r0 ,
and it is available at the following link:
http://support.lenovo.com/
To boot the switch in ONIE install mode on the next reload, use the following
command from the switch CLI:
Lenovo Cloud Network OS:
G8296(config)# startup image onie-image install

© Copyright Lenovo 2017 ONIE on the G8296 17
To check which in ONIE mode the switch is configured to boot, use the following
command
from the switch CLI :
Lenovo Cloud Network OS:
Booting in ONIE Uninstall Mode
This mode is used to uninstall a NOS using ONIE. The ONIE uninstall mode boots
the ONIE kernel and deletes the NOS image running on the switch. After the
uninstall is complete, the ONIE discovery process is executed.
To boot the switch in ONIE uninstall mode on the next reload, use the following
command from the switch CLI:
Lenovo Cloud Network OS:
Note: The following warning will be displayed after choosing ONIE uninstall
mode and you will be prompted for confirmation:
Once you confirm, the switch will boot in ONIE uninstall mode on the next reload.
For more details, see “Uninstalling the Lenovo Network OS” on page 20.
G8296(config)# display boot
Current FLASH software:
active image: version 10.2.1.0
standby image: version 10.2.1.0
Uboot: version 10.2.1.0
ONIE: version 10.2.1.0
Currently set to boot ONIE install mode
Currently scheduled reboot time: none
Current port mode: default mode
G8296(config)# startup image onie-image uninstall
WARNING: Booting ONIE in uninstall mode will completely uninstall the
operating system!
Only the ONIE image will be preserved.
Are you sure you want the next boot to uninstall the OS? (y/n)

18 Lenovo ONIE Quick Start Guide for G8296
Booting in ONIE Update Mode
ONIE update mode will install a new version of ONIE on the switch, including the
boot loader and the Linux kernel. It works similarly to the ONIE install mode,
except the discovery process will search for an ONIE image instead, and not a NOS
image.
Notes:
This will only upgrade the ONIE partition on the switch and will not affect the
NOS image.
This will also install a different version of the ONIE boot loader, which does not
support running Lenovo Network OS. If you wish to boot Lenovo NOS, you will
have to re-install it by using ONIE Install mode (for more details, see “Booting in
ONIE Install Mode” on page 16).
To boot the switch in ONIE update mode on the next reload, use the following
command from the switch CLI:
Lenovo Cloud Network OS:
Note: Upon reloading after the update process is completed, the switch will not be
able to load the Lenovo Network OS, booting into ONIE Install mode instead.
Booting in ONIE Rescue Mode
ONIE rescue and recovery mode is useful when trying to recover from a broken
NOS image. It works similarly to the ONIE install mode, except the ONIE
discovery process is disabled. ONIE will not try to find and install a NOS image.
This allows for the troubleshooting of the system.
To boot the switch in ONIE rescue mode on the next reload, use the following
command from the switch CLI:
Lenovo Cloud Network OS:
G8296(config)# startup image onie-image update
G8296(config)# startup image onie-image rescue

© Copyright Lenovo 2017 ONIE on the G8296 19
The Boot Management Menu
The Boot Management menu is another way to access ONIE and configure the
switch to boot in different ONIE modes.
You can interrupt the startup process of the switch and enter the Boot Management
menu from the serial console port. When the system displays the following
message, press Shift + B. The Boot Management menu will appear.
Note: For CNOS, the submenu is available, but executing any of its options will
result in an error, unless the ONIE license key is installed. For more details, see
“Installing the ONIE FoD License Key” on page 12.
To enter the ONIE submenu, press O .
The ONIE submenu allows you to perform the following actions:
To boot the switch in ONIE Install mode, press I. For more details, see “Booting
in ONIE Install Mode” on page 16.
To boot the switch in ONIE Rescue mode, press R. For more details, see “Booting
in ONIE Rescue Mode” on page 18.
To boot the switch in ONIE Update mode, press U. For more details, see
“Booting in ONIE Update Mode” on page 18.
To boot the switch in ONIE Uninstall mode, press D. For more details, see
“Booting in ONIE Uninstall Mode” on page 17.
To boot the switch using the installed NOS image, press N.
To exit the ONIE submenu and return to the Boot Management Menu, press E.
The system is going down for reboot NOW!
...
Press shift-B for startup menu or shift-R for recovery mode: ..
Running Startup Menu
...
Boot Management Menu
I - Change booting image
R - Boot in recovery mode (tftp and xmodem download of images to
recover switch)
P - Password reset
O - ONIE submenu
Q - Reboot
E - Exit
Please choose your menu option:
ONIE Menu
I - Startup ONIE OS installer
N - Startup NOS mode (system default)
R - Startup ONIE rescue mode
U - Startup ONIE self update mode
D - Startup ONIE OS uninstaller
E - Exit ONIE menu
Option? :

20 Lenovo ONIE Quick Start Guide for G8296
Uninstalling the Lenovo Network OS
If you wish to run another network operating system (NOS), you can uninstall the
Lenovo Network OS by using the ONIE Uninstall mode. For more details, see
“Booting in ONIE Uninstall Mode” on page 17 .
Notes:
If the switch does not have ONIE installed, you must first install a ONIE FoD
license key and then set up the software on the networking device. For more
details, see “Installing the ONIE FoD License Key” on page 12 and “Installing
ONIE” on page 14.
If you are connected to the switch through the mini-USB serial console port,
once you have uninstalled the Lenovo Network OS you must configure the default
baud rate from 9,600 bps to 115,200 bps.
Once you have uninstalled the Lenovo Network OS from the network device, see
“Using ONIE without Lenovo Network OS” on page 21.
After booting in ONIE Uninstall mode, the following should be displayed:
Once the NOS uninstall process is complete, the switch is reloaded and configured
to boot in ONIE Install mode.
Loading Open Network Install Environment ...
Platform: -lenovo_g8296-r0
Version : lenovo-internal
...
discover: Uninstall mode detected. Running uninstaller.
Erasing u-boot environment NOR flash region
Erasing 128 Kibyte @ 20000 - 100% complete.
Erasing internal mass storage device: /dev/mmcblk0 (7631MB)
Percent complete: 100%
Erase complete.
Uninstall complete. Rebooting...
discover: Uninstall mode detected. No discover stopped.
Stopping: dropbear ssh daemon... done.
Stopping: telnetd... done.
Stopping: syslogd... done.
Info: Unmounting kernel filesystems
The system is going down NOW!
Sent SIGTERM to all processes
Sent SIGKILL to all processes
Requesting system reboot
Restarting system.
...
discover: installer mode detected. Running installer.
Starting: discover... done.
Please press Enter to activate this console. Info: eth0: Checking
link... up.
Info: Trying DHCPv4 on interface: eth0
Warning: Unable to configure interface using DHCPv4: eth0
ONIE: Using default IPv4 addr: eth0: 192.168.3.10/24
ONIE: Using link-local IPv4 addr: eth0: 169.254.166.99/16
ONIE: Starting ONIE Service Discovery