mirror of
https://github.com/Telecominfraproject/OpenNetworkLinux.git
synced 2025-11-03 11:48:17 +00:00
177 lines
7.1 KiB
Markdown
177 lines
7.1 KiB
Markdown
Getting Started With the Accton Wedge
|
||
------------------------------------------------
|
||
To install and run ONL on the Accton Wedge you will need ONIE and
|
||
the ONL wedge installer binary. Relevant pointers can be found at
|
||
https://opennetlinux.org/wedge
|
||
|
||
Once installed, ONL has a default account ("root") with a default password
|
||
("onl"). The network interface is disabled by default so that you can change
|
||
the root password before the system comes up. You will need to enable the
|
||
network interface before you can run the FBOSS agent.
|
||
|
||
On the Wedge 40 FBOSS is installed and set to run the configuration created for a OCP ONL
|
||
on Wedge Demo. This configuration sets up the first physical QSFP port of
|
||
the wedge as 4 10G ports (via a break out cable) and configures vlans and
|
||
ip addresses on them.
|
||
|
||
On the Wedge 100 FBOSS is installed and set to run a generic configuration that breaks all
|
||
ports into 25G (each 100G port is broken into 4 ports for a total of 128 ports)
|
||
|
||
ONIE Manual Install
|
||
------------------------------------------------
|
||
If your Accton Wedge does not have ONIE installed, you will need to install
|
||
it before you can proceed.
|
||
|
||
1) Download the ONIE rescue image for the Wedge 40 from http://opennetlinux.org/binaries/accton-wedge/onie-recovery-x86_64-accton_wedge_16x-r0.iso for the Wedge 100 it is http://opennetlinux.org/binaries/accton-wedge/onie-recovery-x86-64-facebook-wedge100-r0.iso
|
||
|
||
2) Burn the image onto a USB (a USB with a minimum size of 256M is necessary)
|
||
|
||
3) Insert the USB into the front USB port on the Wedge
|
||
|
||
4) Attach a serial terminal to the wedge
|
||
|
||
5) Power on the wedge and wait for the BMC to finish booting
|
||
|
||
6) Log into the bmc with the login: root password: 0penBmc
|
||
|
||
7) Attach to the wedge microserver using the command sol.sh
|
||
|
||
8) If the microserver shows the BIOS status screen press F2 to go to the BIOS
|
||
configuration menu
|
||
|
||
9) In cases where the wedge microserver has already booted into the default
|
||
linux installation, you will need to either reboot (if possible) or hit ctrl-x, exiting to the BMC and issue the "wedge_power reset" command to power-cycle the
|
||
microserver, run sol.sh again and hit F2 when the BIOS status screen appears
|
||
|
||
10) For the Wedge 40 Once you are in the BIOS configuration, move to the boot screen and change
|
||
the boot mode from UEFI to Legacy. For the Wedge 100 you will choose the non UEFI version of your USB disk.
|
||
|
||
11) In the boot device list, make sure that the USB is set to #1
|
||
|
||
12) Hit esc-0 to or F10 to save and exit the configuration
|
||
|
||
13) The system will now boot from the ONIE rescue USB
|
||
|
||
14) When the ONIE Grub window appears, choose "Embed ONIE"
|
||
|
||
15) ONIE will be installed on the system and the system will automatically
|
||
reboot
|
||
|
||
16) *IMPORTANT* Remove the USB from the system before proceeding to the ONL install
|
||
|
||
17) On the Wedge 100 go back into the BIOS and set device P0 to be the main boot drive.
|
||
|
||
ONL Manual Install
|
||
------------------------------------------------
|
||
1) Attach a serial terminal to the wedge
|
||
|
||
2) Boot switch and choose "ONIE: Rescue" to go to ONIE''s interactive mode
|
||
|
||
3) From the ONIE# prompt run "install_url http://opennetlinux.org/binaries/latest-DEB8-AMD64-installed.installer"
|
||
|
||
4) Wait for the install to finish and the system to reboot
|
||
|
||
5) Once the onl login prompt appears login with the username root and the
|
||
password "onl"
|
||
|
||
6) Configure the ma1 interface either via dhcp (dhclient ma1) or manually
|
||
|
||
7) Install fboss using the commands
|
||
|
||
For the Wedge 40
|
||
#> apt-get update
|
||
#> apt-get install fboss
|
||
|
||
Or for the Wedge 100
|
||
#> apt-get install fboss-w100
|
||
|
||
8) From the command prompt you can start fboss by using the command
|
||
"service fboss_wedge_agent start"
|
||
|
||
9) On the Wedge 40 The first time you start the fboss_wedge_agent service it will download
|
||
the OpenNSL library from the Broadcom github account. On the Wedge 100, it OpenNSL is included
|
||
as a package.
|
||
|
||
10) Once the library is installed, fboss_wedge_agent will start, using the
|
||
default configuration located at /etc/fboss/ocp-demo.json for the Wedge 40 or /etc/fboss/sample_config.json for the Wedge 100
|
||
|
||
11) You can confirm that the fboss_wedge_agent is running by issuing the
|
||
command "service fboss_wedge_agent status"
|
||
|
||
12) If fboss is running, you should see "[ ok ] fboss_wedge_agent is running."
|
||
|
||
13) You can now execute the fboss_route.py script and configure the system.
|
||
|
||
Modifying The fboss_wedge_agent configuration
|
||
------------------------------------------------
|
||
|
||
The rest of this document is based on the Wedge 40 but the Wedge 100 is similar.
|
||
|
||
In the /etc/init.d/fboss_wedge_agent script, you will locate a section where
|
||
the configuration file "FBOSS_DAEMON_OPTIONS" is set:
|
||
|
||
OCP_DEMO="-config /etc/fboss/ocp-demo.json"
|
||
SAMPLE1="-config /etc/fboss/sample1.json"
|
||
SAMPLE2="-config /etc/fboss/sample2.json"
|
||
SAMPLE3="-config /etc/fboss/sample3.json"
|
||
FBOSS_DAEMON_OPTIONS=$OCP_DEMO
|
||
|
||
The sample configurations are documented here: https://github.com/facebook/fboss/tree/master/fboss/agent/configs
|
||
|
||
To change the configuration, simply change the variable from $OCP_DEMO to $SAMPLE1/2/3 or add your own configuration and set the variable to call it.
|
||
|
||
|
||
Expected output (you can also see videos at https://opennetlinux.org/wedge)
|
||
|
||
ONIE:
|
||
|
||
ONIE: Using DHCPv4 addr: eth0: 10.7.1.10 / 255.254.0.0
|
||
discover: installer mode detected. Running installer.
|
||
|
||
Please press Enter to activate this console. ONIE: Using DHCPv4 addr: eth0: 10.7.1.10 / 255.254.0.0
|
||
ONIE: Starting ONIE Service Discovery
|
||
|
||
To check the install status inspect /var/log/onie.log.
|
||
Try this: tail -f /var/log/onie.log
|
||
|
||
Now press RETURN here to jump into ONIE''s manual installer mode. You should see:
|
||
|
||
** Installer Mode Enabled **
|
||
|
||
ONIE:/ #
|
||
|
||
Then simply download the latest ONL wedge installer from the website and run it.
|
||
|
||
ONIE:/ # install_url http://opennetlinux.org/binaries/latest-wedge-2.0.installer
|
||
|
||
Connecting to opennetlinux.org (107.170.237.53:80)
|
||
Open Network Installer running under ONIE.
|
||
Installing Open Network Linux Software Image (ONL-2.0.0_ONL-OS_2016-02-12.2304-b9b7e50_AMD64.swi)...
|
||
Installation finished. No error reported.
|
||
Install finished. Rebooting to Open Network Linux.
|
||
...
|
||
|
||
Connecting tty=ttyS1 with /sbin/pgetty
|
||
|
||
Debian GNU/Linux 8 localhost ttyS1
|
||
|
||
localhost login: root
|
||
Password:
|
||
Linux localhost 3.2.65-1+deb7u2-OpenNetworkLinux #1 SMP Fri Feb 12 23:10:15 UTC 2016 x86_64
|
||
|
||
root@localhost:~# apt-get update
|
||
root@localhost:~# apt-get install fboss
|
||
WARNING: The following packages cannot be authenticated!
|
||
folly wangle fbthrift fboss-py fboss-core fboss
|
||
Install these packages without verification? [y/N] y
|
||
|
||
root@localhost:~# service fboss_wedge_agent start
|
||
[....] Starting Facebook FBOSS agent: fboss_wedge_agent
|
||
Error: OpenNSL library not found, attempting to grab from GitHub
|
||
Saving to: ‘/usr/local/lib/libopennsl.so.1’
|
||
|
||
OpenNSL library succesfully installed
|
||
[ ok --- Loading linux-kernel-bde linux-user-bde linux-bcm-knet ; Creating devices .
|
||
root@localhost:~# service fboss_wedge_agent status
|
||
[ ok ] fboss_wedge_agent is running.
|