diff --git a/docs/Building.md b/docs/Building.md index abe095d7..e66ab7ad 100644 --- a/docs/Building.md +++ b/docs/Building.md @@ -42,6 +42,7 @@ If you would like to build by hand you can do the following: #> git clone https://github.com/opencomputeproject/OpenNetworkLinux #> cd OpenNetworkLinux #> docker/tools/onlbuilder (-8) # enter the docker workspace + #> apt-cacher-ng #> source setup.env # pull in necessary environment variables #> make amd64 ppc # make onl for $platform (currently amd64 or powerpc) @@ -127,3 +128,86 @@ This installer image can be served to ONIE on Quanta or Accton platforms: #> ls *INSTALLER ONL-2.0.0_ONL-OS_2015-12-12.0252-ffce159_PPC_INSTALLER #> + +Example setup on new Debian 8.2 installation +------------------------------------------------------------ +Install sudo and add yourself to the sudoers: + +As root: + +apt-get install sudo + +vi /etc/sudoers.d/username + +Add the line: + +username ALL=(ALL:ALL) ALL + +Add the docker key: + +sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D + +gpg: key 2C52609D: public key "Docker Release Tool (releasedocker) " imported +gpg: Total number processed: 1 +gpg: imported: 1 (RSA: 1) + +Install necessary items, make, binfmt-support and apt-transport-https (for docker): + +sudo apt-get install apt-transport-https make binfmt-support + +Add the docker repository to your system: + +sudo vi /etc/apt/sources.list.d/docker.list + +Add the following line to the file: + +deb https://apt.dockerproject.org/repo debian-jessie main + +Install Docker: + +sudo apt-get update + +sudo apt-get install docker-engine + +Test Docker: + +sudo docker run hello-world + +Unable to find image 'hello-world:latest' locally +latest: Pulling from library/hello-world +b901d36b6f2f: Pull complete +0a6ba66e537a: Pull complete +Digest: sha256:8be990ef2aeb16dbcb9271ddfe2610fa6658d13f6dfb8bc72074cc1ca36966a7 +Status: Downloaded newer image for hello-world:latest + +Hello from Docker. +This message shows that your installation appears to be working correctly. + +Add yourself to the docker group: + +sudo gpasswd -a snoble docker + +Adding user snoble to group docker + +logout and log back in for the group to take effect: + +Clone the OpenNetworkLinux repository: + +git clone https://github.com/opencomputeproject/OpenNetworkLinux.git + +Cloning into 'OpenNetworkLinux'... +Checking connectivity... done. + +Build OpenNetworkLinux: + + #> cd OpenNetworkLinux/ + #> make docker + #> Pulling opennetworklinux/builder7:1.0… + +Or: + + #> docker/tools/onlbuilder + #> source setup.env + #> apt-cacher-ng + #> make onl-x86 onl-ppc + diff --git a/docs/PortingGuide.md b/docs/PortingGuide.md index 5d62a084..f1a65ae5 100644 --- a/docs/PortingGuide.md +++ b/docs/PortingGuide.md @@ -5,9 +5,10 @@ Open Network Linux has a number of internal APIs to simplify porting to new hardware. To support a new switch/device, there are three large software components -that need device-specific drivers: +that need device-specific drivers (information only known by the manufacturer +of the switch/device): -1. The ONL/ONIE installer -- how to actually install and boot ONL using ONIE +1. The ONL/ONIE installer -- how to install and boot ONL using ONIE 2. The ONLP platform drivers -- how to manage hardware once ONL is running 3. Any packet forwarding device specific settings (e.g., front panel port mappings, pre-emphesis settings) @@ -69,7 +70,7 @@ directory structure for the installer driver is as follows: # specific ONL OS abstractions (see below) ./$platform/$release/src/lib/install/$platform.sh # Script called from installer.sh to partition # and install ONL and setup boot params (see below) - ./$platform/src/python/$plaform/__init__.py # Platform specific python library (see below) + ./$platform/src/python/$platform/__init__.py # Platform specific python library (see below) ONL Installer src/boot drivers ------------------------------ diff --git a/docs/SupportedHardware.md b/docs/SupportedHardware.md index 9a4f9752..c8bdbbfd 100644 --- a/docs/SupportedHardware.md +++ b/docs/SupportedHardware.md @@ -9,13 +9,12 @@ Quanta - + - - - - - + + + +
Device Ports CPU Forwarding Support Status
Device Ports CPU Forwarding ONL Certified In Lab ORC OF-DPA OpenNSL SAI
QuantaMesh T1048-LB9 48x1G + 4x10G FreeScale P2020 Broadcom BCM56534 (Firebolt3) Supported and Tested
QuantaMesh T1048-LB9A 48x1G + 4x10G FreeScale P2020 Broadcom BCM56534 (Firebolt3) Supported, no ONIE, not regularly tested
QuantaMesh T3048-LY2 48x10G + 4x40G FreeScale P2020 Broadcom BCM56846 (Trident+) Supported and Tested
QuantaMesh T3048-LY8 48x10G + 6x40G Intel Rangely C2758 x86 Broadcom BCM56854 (Trident2) Supported and run in the lab
QuantaMesh T5032-LY6 32x40G Intel Rangely C2758 x86 Broadcom BCM56850 (Trident2) Supported and run in the lab
QuantaMesh T1048-LB9 48x1G + 4x10G FreeScale P2020 Broadcom BCM56534 (Firebolt3) Yes Yes Yes Yes No No
QuantaMesh T3048-LY2 48x10G + 4x40G FreeScale P2020 Broadcom BCM56846 (Trident+) Yes Yes Yes Yes No No
QuantaMesh T3048-LY8 48x10G + 6x40G Intel Rangely C2758 x86 Broadcom BCM56854 (Trident2) Yes* No No No No No
QuantaMesh T5032-LY6 32x40G Intel Rangely C2758 x86 Broadcom BCM56850 (Trident2) Yes* No No No No No
@@ -24,18 +23,20 @@ Accton/Edge-Core - + - - - - - - - - - - + + + + + + + + + + + +
Device Ports CPU Forwarding Support Status
Device Ports CPU Forwarding ONL Certified In Lab ORC OF-DPA OpenNSL SAI
Accton AS4600-54T 48x1G + 4x10G FreeScale P2020 Broadcom BCM56540 (Apollo2) Supported and Tested
Accton AS5600-52X 48x10G + 4x40G FreeScale P2020 Broadcom BCM56846 (Trident+) Supported and Tested
Accton AS5610-52X 48x10G + 4x40G FreeScale P2020 Broadcom BCM56846 (Trident+) Supported and Tested
Accton AS5710-54X 48x10G + 6x40G FreeScale P2041 Broadcom BCM56854 (Trident2) Supported and Tested
Accton AS6700-32X 32x40G FreeScale P2041 Broadcom BCM56850 (Trident2) Supported and Tested
Accton AS5712-54X 48x10G + 6x40G Intel Rangely C2538 x86 Broadcom BCM56854 (Trident2) Supported and Tested
Accton AS6712-32X 32x40G Intel Rangely C2538 x86 Broadcom BCM56850 (Trident2) Supported and Tested
Accton AS5812-54T 48x10G + 6x40G Intel Rangely C2538 x86 Broadcom BCM56864 (Trident2+) Supported
Accton AS5812-54X 48x10G + 6x40G Intel Rangely C2538 x86 Broadcom BCM56864 (Trident2+) Supported
Accton AS6812-32X 32x40G Intel Rangely C2538 x86 Broadcom BCM56864 (Trident2+) Supported
Accton AS4600-54T 48x1G + 4x10G FreeScale P2020 Broadcom BCM56540 (Apollo2) Yes Yes Yes Yes No No
Accton AS5600-52X 48x10G + 4x40G FreeScale P2020 Broadcom BCM56846 (Trident+) Yes Yes Yes Yes No No
Accton AS5610-52X 48x10G + 4x40G FreeScale P2020 Broadcom BCM56846 (Trident+) Yes Yes Yes Yes No No
Accton AS5710-54X 48x10G + 6x40G FreeScale P2041 Broadcom BCM56854 (Trident2) Yes Yes Yes Yes No No
Accton AS6700-32X 32x40G FreeScale P2041 Broadcom BCM56850 (Trident2) Yes Yes Yes Yes No No
Accton AS5712-54X 48x10G + 6x40G Intel Rangely C2538 x86 Broadcom BCM56854 (Trident2) Yes Yes Yes No No No
Accton AS6712-32X 32x40G Intel Rangely C2538 x86 Broadcom BCM56850 (Trident2) Yes Yes Yes No No No
Accton AS5812-54T 48x10G + 6x40G Intel Rangely C2538 x86 Broadcom BCM56864 (Trident2+) Yes Yes No No No No
Accton AS5812-54X 48x10G + 6x40G Intel Rangely C2538 x86 Broadcom BCM56864 (Trident2+) Yes Yes No No No No
Accton AS6812-32X 32x40G Intel Rangely C2538 x86 Broadcom BCM56864 (Trident2+) Yes Yes No No No No
Accton AS7712-32X 32x100G Intel Rangely C2538 x86 Broadcom BCM56960 (Tomahawk) Yes Yes Yes No No No
Accton Wedge-16X 16x40G Intel Rangely C2550 x86 Broadcom BCM56864 (Trident2+) Work In Progress** Yes No No Yes No
DNI/Agema @@ -43,9 +44,9 @@ DNI/Agema - + - +
Device Ports CPU Forwarding Support Status
Device Ports CPU Forwarding ONL Certified In Lab ORC OF-DPA OpenNSL SAI
AG-7448CU 48x10G + 4x40G FreeScale P2020 Broadcom BCM56845 (Trident) Supported and Tested
AG-7448CU 48x10G + 4x40G FreeScale P2020 Broadcom BCM56845 (Trident) Yes Yes Yes No No No
Dell @@ -53,10 +54,35 @@ Dell - + - - - - + + + +
Device Ports CPU Forwarding Support Status
Device Ports CPU Forwarding ONL Certified In Lab ORC OF-DPA OpenNSL SAI
S4810-ON 48x10G + 4x40G FreeScale P2020 Broadcom BCM56845 (Trident) Supported and Tested
S4048-ON 48x10G + 6x40G Intel Atom C2338 Broadcom BCM56854 (Trident2) Supported and Tested
S6000-ON 32x40G Intel Atom S1220 Broadcom BCM56850 (Trident2) Supported and Tested
S4810-ON 48x10G + 4x40G FreeScale P2020 Broadcom BCM56845 (Trident) Yes Yes Yes No No No
S4048-ON 48x10G + 6x40G Intel Atom C2338 Broadcom BCM56854 (Trident2) Yes Yes Yes No No No
S6000-ON 32x40G Intel Atom S1220 Broadcom BCM56850 (Trident2) Yes Yes Yes No No No
z9100-ON 32x100G Intel Broadcom BCM56960 (Tomahawk) Yes Yes No No No No
+ +Interface Masters Technologies, Inc. +--- + + + + + + + + + + +
Device Ports CPU Forwarding ONL Certified In Lab ORC OF-DPA OpenNSL SAI
Niagara 2948X12XLm 48x10G + 12x40G Intel/AMD x86 Broadcom BCM56850 (Trident2) Work In Progress** No No Yes*** No No
Niagara 2960X6XLm 60x10G + 6x40G Intel/AMD x86 Broadcom BCM56850 (Trident2) Work In Progress** No No Yes*** No No
Niagara 2972Xm 72x10G Intel/AMD x86 Broadcom BCM56850 (Trident2) Work In Progress** Yes No Yes*** No No
Niagara 2932XL 32x40G Intel/AMD x86 Broadcom BCM56850 (Trident2) Work In Progress** No No Yes*** No No
Niagara 2948X6XL 48x10G + 6x40G Intel/AMD x86 Broadcom BCM56850 (Trident2) Work In Progress** No No Yes*** No No
+ +Notes: +--- + +ONL Certified means that the system runs ONIE, is able to install a generic version of ONL and has the ONL Platform drivers necessary to manage the system. + +\* Systems no longer in the lab cannot be certified post removal + +\** Developing ONL Platform Drivers + +\*** Vendor provided