From da76d91d182dc6d338968820e246edaf7c4a7342 Mon Sep 17 00:00:00 2001 From: Steven Noble Date: Wed, 19 Oct 2016 10:14:43 -0700 Subject: [PATCH] Updates docs for Wedge to include Wedge 100 (#115) --- docs/Building.md | 8 ++++---- docs/GettingStartedWedge.md | 31 ++++++++++++++++++++++--------- 2 files changed, 26 insertions(+), 13 deletions(-) diff --git a/docs/Building.md b/docs/Building.md index 693f83b5..f4c02f7a 100644 --- a/docs/Building.md +++ b/docs/Building.md @@ -105,8 +105,8 @@ Adding/Removing packages from a SWI: The list of packages for a given SWI are in - $ONL/packages/base/any/rootfs/common/$ARCH-packages.yml # for $ARCH specific packages - $ONL/packages/base/any/rootfs/common/common-packages.yml # for $ARCH-independent packages + $ONL/packages/base/any/rootfs/$suite/common/$ARCH-packages.yml # for $ARCH specific packages + $ONL/packages/base/any/rootfs/$suite/common/common-packages.yml # for $ARCH-independent packages Build a software image (SWI) for all powerpc platforms: ------------------------------------------------------------ @@ -190,9 +190,9 @@ This message shows that your installation appears to be working correctly. Add yourself to the docker group: ``` -sudo gpasswd -a snoble docker +sudo gpasswd -a user1 docker -Adding user snoble to group docker +Adding user user1 to group docker ``` logout and log back in for the group to take effect: diff --git a/docs/GettingStartedWedge.md b/docs/GettingStartedWedge.md index 42fe39c9..2bfcd926 100644 --- a/docs/GettingStartedWedge.md +++ b/docs/GettingStartedWedge.md @@ -9,17 +9,20 @@ Once installed, ONL has a default account ("root") with a default password the root password before the system comes up. You will need to enable the network interface before you can run the FBOSS agent. -FBOSS is installed and set to run the configuration created for a OCP ONL +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 from http://opennetlinux.org/binaries/accton-wedge/onie-recovery-x86_64-accton_wedge_16x-r0.iso +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) @@ -40,8 +43,8 @@ configuration menu 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) One you are in the BIOS configuration, move to the boot screen and change -the boot mode from UEFI to Legacy +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 @@ -56,13 +59,15 @@ 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-wedge-2.0.installer" +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 @@ -72,18 +77,23 @@ 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) The first time you start the fboss_wedge_agent service it will download -the OpenNSL library from the Broadcom github account. +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 +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" @@ -94,6 +104,9 @@ command "service fboss_wedge_agent status" 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: