From df704879f0335f8c7c823f1d0fb5c0cbb86fe386 Mon Sep 17 00:00:00 2001 From: bernard puel Date: Tue, 13 Dec 2016 14:37:30 +0100 Subject: [PATCH 001/114] Updated OE.md to render more generic --- Reference-Platform/CECommon/OE.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/Reference-Platform/CECommon/OE.md b/Reference-Platform/CECommon/OE.md index 990b4ae..045eb01 100644 --- a/Reference-Platform/CECommon/OE.md +++ b/Reference-Platform/CECommon/OE.md @@ -1,6 +1,7 @@ ## OpenEmbedded and Yocto -This page provides instructions to get started with OpenEmbedded and the Yocto Project on the DragonBoard 410c and HiKey. +This page provides instructions to get started with OpenEmbedded and the Yocto Project. It tries (when possible) to be generic for any board supported. +The board diversity should be addressed through dedicated BSP layer then MACHINE choice. # Introduction @@ -11,15 +12,12 @@ This wiki is not an introduction on OpenEmbedded or Yocto Project. If you are no In this wiki, we assume that the reader is familiar with basic concepts of OpenEmbedded. -The support for DragonBoard 410c is available in the [meta-qcom BSP layer](http://git.yoctoproject.org/cgit/cgit.cgi/meta-qcom). - -The support for HiKey is available in the [meta-96boards BSP layer](https://github.com/96boards/meta-96boards). - -These layers have been tested with OpenEmbedded Core layer, and are expected to work with any other standard layers and of course any OpenEmbedded based distributions. +The support for a dedicated board is available in the dedicated BSP Layer. These layers have been tested with OpenEmbedded Core layer, and are expected to work with any other standard layers and of course any OpenEmbedded based distributions. The Linux kernel used for these boards is the Reference Platform Kernel (RPK). The graphic stack is based on mesa: * using the freedreno driver for Dragonboard 410c * using the ARM Mali Utgard GPU driver for HiKey +* using the ARM Mali 400 GPU driver for B2260 ## OE Layers @@ -32,8 +30,9 @@ The Linux kernel used for these boards is the Reference Platform Kernel (RPK). T | meta-qt5 | This is a cross-platform toolkit. | | meta-linaro | This layer is used to get the Linaro toolchain. | | meta-linaro-backports | This is an experimental layer used to get newer versions into the build which were not part of the release. | -| meta-96Boards | This support layer is managed by Linaro and intended for boards that do not have their own board support layer. Currently used for the HiKey Consumer Edition board, and eventually the Bubblegum-96 board. If a vendor does not support their own layer, it can be added to this layer. | -| meta-qcom (BSP) | This is the board support layer for Qualcomm boards. Currently supports IFC6410 and the DragonBoard 410c. | +| [meta-96boards BSP layer](https://github.com/96boards/meta-96boards) | This support layer is managed by Linaro and intended for boards that do not have their own board support layer. Currently used for the HiKey Consumer Edition board, and eventually the Bubblegum-96 board. If a vendor does not support their own layer, it can be added to this layer. | +| [meta-qcom BSP layer](http://git.yoctoproject.org/cgit/cgit.cgi/meta-qcom) | This is the board support layer for Qualcomm boards. Currently supports IFC6410 and the DragonBoard 410c. | +| [meta-st-cannes2 BSP Layer](https://github.com/cpriouzeau/meta-st-cannes2) | This is the board support layer for ST B2260 board. | # Package Dependencies From ce6f96466d64a6251a2c883b79de03a6259a6e92 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 09:07:08 -0800 Subject: [PATCH 002/114] Added .md files for each platform description Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Consumer.md | 14 ++++++++++++++ Reference-Platform/Platforms/Enterprise.md | 15 +++++++++++++++ Reference-Platform/Platforms/IoT.md | 12 ++++++++++++ 3 files changed, 41 insertions(+) create mode 100644 Reference-Platform/Platforms/Consumer.md create mode 100644 Reference-Platform/Platforms/Enterprise.md create mode 100644 Reference-Platform/Platforms/IoT.md diff --git a/Reference-Platform/Platforms/Consumer.md b/Reference-Platform/Platforms/Consumer.md new file mode 100644 index 0000000..38790c4 --- /dev/null +++ b/Reference-Platform/Platforms/Consumer.md @@ -0,0 +1,14 @@ +# Consumer Reference Platform + +The consumer reference platform aims to enable the latest software on a series of embedded hardware platforms. Open source boot firmware and a unified Linux kernel delivers an excellent starting point for your next embedded product. High level components such as ROS, and a standard GPIO library are included to help accelerate robotic enthusiasts and makers. The consumer software stack provides two builds based on Debian and OpenEmbedded. A graphic user interface is included for each variant, and both are validated to ensure quality and a great user experience. + +**Features:** + +- Unified Linux Kernel +- Open Boot Firmware +- Debian and OpenEmbedded Builds +- Desktop Enviroment +- ROS (Robot OS) +- Standard GPIO Library + +*** diff --git a/Reference-Platform/Platforms/Enterprise.md b/Reference-Platform/Platforms/Enterprise.md new file mode 100644 index 0000000..4eb5e5e --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise.md @@ -0,0 +1,15 @@ +# Enterprise Reference Platform + +The enterprise reference platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. + +**Features:** + +- Unified Linux Kernel +- Open Boot Firmware + - Compliant with ARM SBSA and SBBR specifications +- Debian and Centos Network Installers +- Openstack and Ceph Reference Deployments +- Built for Big Data Workloads + +*** + diff --git a/Reference-Platform/Platforms/IoT.md b/Reference-Platform/Platforms/IoT.md new file mode 100644 index 0000000..deba881 --- /dev/null +++ b/Reference-Platform/Platforms/IoT.md @@ -0,0 +1,12 @@ +# IoT Reference Platform + +The IoT reference platform’s goal is to provide an end to end open source secure pipeline from gateway devices to endpoints. For the deeply embedded use cases, a Zephyr RTOS baseline is provided to enable a series of hardware platforms, which ships with a rich developer SDK. The gateway is a variant of the Consumer reference platform based on Debian, leveraging the latest in cloud and container technology. Secure updates are not a mere afterthought, instead this software stack has been designed with security and maintainability in mind from day one. + +**Features:** + +- Zephyr RTOS with SDK for endpoints +- Open Boot Firmware for endpoints +- Debian builds for gateways +- Secure update pipeline for all devices + +*** From cff14c3e15fc1c7d1720f36cb429e509d6d3c181 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 16:20:06 -0800 Subject: [PATCH 003/114] Added base content for page - first draft Signed-off-by: Robert Wolff --- .../Enterprise/Installation/README.md | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index e69de29..d513ad8 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -0,0 +1,47 @@ +# Installation + +This page offers generic installation instructions for the Enterprise Reference Platform on supported hardware. A list of approved hardware can be found in the ["Approved Hardware"](../Hardware/README.md) section of this documentation set. + +*** + +## Step 1: Upgrade firmware to latest version + + + + + + + + +
UEFI/EDK2 + Download
Get the latest pre-built firmware images		Build
Instructions for building latest firmware images		Install
Instructions on how to install firmware		Read more
Learn more about UEFI/EDK2
+ +*** + +## Step 2: Set up PXE on your network + +- Debian: https://wiki.debian.org/PXEBootInstall +- Centos: https://wiki.centos.org/HowTos/NetworkInstallServer + +*** + +## Step 3: Use a PXE to boot a network installer + +Choose your network installer, download or build, and proceed to the installation instructions + +**Network Installers:** + + + + + + + + + + + + +
CentosDownloadInstall
Debian JessieDownloadInstall
+ +*** From 59a4a7b425b89860b5d56a336f4eb7a94e7e2947 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 16:41:10 -0800 Subject: [PATCH 004/114] format change Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/README.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index d513ad8..e6595a3 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -20,8 +20,16 @@ This page offers generic installation instructions for the Enterprise Reference ## Step 2: Set up PXE on your network -- Debian: https://wiki.debian.org/PXEBootInstall -- Centos: https://wiki.centos.org/HowTos/NetworkInstallServer + + + + + + + +
Centos + https://wiki.centos.org/HowTos/NetworkInstallServer
Debian + https://wiki.debian.org/PXEBootInstall
*** @@ -33,12 +41,12 @@ Choose your network installer, download or build, and proceed to the installatio - + - + From e7164e8ad46e59cacdbdeb6289b675676652b432 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:05:15 -0800 Subject: [PATCH 005/114] Added release notes Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 8095c6f..7a44a9d 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -17,5 +17,6 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is #### Resources +- [Release Note](ReleaseNotes.md) - [Previous Releases](PreviousReleases/README.md) - [Document Contribution Policy](../../../ContributionPolicy.md) From c8fb43fbf7eeee3f7e9495277a2e7a00fa11af57 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:05:34 -0800 Subject: [PATCH 006/114] Typo fix Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 7a44a9d..e7b062b 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -17,6 +17,6 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is #### Resources -- [Release Note](ReleaseNotes.md) +- [Release Notes](ReleaseNotes.md) - [Previous Releases](PreviousReleases/README.md) - [Document Contribution Policy](../../../ContributionPolicy.md) From 8c372ba06f45467fad0d0c750d8dbbf302f11137 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:09:24 -0800 Subject: [PATCH 007/114] Added lower relative links Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/GettingStarted/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md index 9bcc90e..6c38615 100644 --- a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md +++ b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md @@ -17,3 +17,11 @@ The enterprise reference platform is targeted to accelerate the high powered ARM *** +## Jump to... + +- [Approved Hardware](../Hardware/README.md) + - This is a list of all tested and approved Enterprise Reference Platform hardware +- [Installation](../Installation/README.md) + - From start to finish, set up your environment and install the Enterprise Reference Platform +- [Support](../Support/README.md) + - Bug reports and current issues, forum access and other useful resources. We want to help you find answers From 1c70f0382c7482d1b02066df004dc15435b3489c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:21:30 -0800 Subject: [PATCH 008/114] Added list of hardware Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Hardware/README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Hardware/README.md diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Hardware/README.md new file mode 100644 index 0000000..e7e2d0d --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Hardware/README.md @@ -0,0 +1,12 @@ +# Approved Hardware + +List of approved hardware, ideal for testing the Enterprise Reference Platform. + +- [AMD Overdrive]() +- [LeMaker Cello]() +- [HiSilicon D03]() +- [HiSilicon D05]() +- [APM X-Gene Mustang]() +- [HP Proliant m400]() +- [Qualcomm Q2432]() +- [Cavium Thunder X]() From 26ef3bc165b0c50590e91334bb0f7486039a473d Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:22:25 -0800 Subject: [PATCH 009/114] Added installation link at the bottom Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Hardware/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Hardware/README.md index e7e2d0d..bf9c422 100644 --- a/Reference-Platform/Platforms/Enterprise/Hardware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Hardware/README.md @@ -10,3 +10,5 @@ List of approved hardware, ideal for testing the Enterprise Reference Platform. - [HP Proliant m400]() - [Qualcomm Q2432]() - [Cavium Thunder X]() + +Proceed to [Installation](../Installation/README.md) page. From f29a640853136c43a061458bbb3ca63c98d5945d Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:27:55 -0800 Subject: [PATCH 010/114] Added content Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Support/README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Support/README.md b/Reference-Platform/Platforms/Enterprise/Support/README.md index e69de29..931e61e 100644 --- a/Reference-Platform/Platforms/Enterprise/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Support/README.md @@ -0,0 +1,10 @@ +# Support + +Please take advantage of the many Enterprise Reference Platform resources available to you Linaro and third parties. + +- [Release Note](../ReleaseNotes.md) + - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. +- [Enterprise Forum](http://www.96boards.org/forums/forum/products/dragonboard410c/) + - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. +- [Report a bug!](../../../Extras/Report_a_bug.md) + - Instructions on how to report bugs for any of our 96Boards hardware and software, this includes the DragonBoard 410c! From 6133d1988a0cfa189679a97562b9adfe0d8dc4f0 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:30:33 -0800 Subject: [PATCH 011/114] Changed description to Report a bug Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Support/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Support/README.md b/Reference-Platform/Platforms/Enterprise/Support/README.md index 931e61e..cccc8b2 100644 --- a/Reference-Platform/Platforms/Enterprise/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Support/README.md @@ -7,4 +7,4 @@ Please take advantage of the many Enterprise Reference Platform resources availa - [Enterprise Forum](http://www.96boards.org/forums/forum/products/dragonboard410c/) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. - [Report a bug!](../../../Extras/Report_a_bug.md) - - Instructions on how to report bugs for any of our 96Boards hardware and software, this includes the DragonBoard 410c! + - Instructions on how to report Enterprise Reference Platform bugs From dedaca37b95c9fac1379ba53f5db231c0613ca28 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:31:45 -0800 Subject: [PATCH 012/114] Added page Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/ReleaseNotes.md diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md new file mode 100644 index 0000000..b1b33e3 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -0,0 +1,3 @@ +# 16.12 Release Notes - Eneterprise Reference Platform + +< Add when ready here > From 5725019e19af9d274ac0b2b4847b88fc187dd733 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:32:11 -0800 Subject: [PATCH 013/114] Typo fix Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index b1b33e3..3ed5f25 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -1,3 +1,3 @@ -# 16.12 Release Notes - Eneterprise Reference Platform +# 16.12 Release Notes - Enterprise Reference Platform < Add when ready here > From 15cafea595dff821fd64ecac21f73480eef7b51a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:35:07 -0800 Subject: [PATCH 014/114] Removed Downloads for now Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index e7b062b..8b6d408 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -8,8 +8,6 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is - Learn more about the Enterprise Reference Platform, this is an ideal place to start. - [Installation](Installation/README.md) - Installation and build instructions for a variety of your Reference Platform components -- [Downloads](Downloads/README.md) - - Skip straight to your pre-built Reference Platform downloads - [Support](Support/README.md) - From bug reports and current issues, to forum access and other useful resources, we want to help you find answers From 8dd9ff0e9275fb1a8876fceda521af406dc682d9 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:35:38 -0800 Subject: [PATCH 015/114] Removed CE material Signed-off-by: Robert Wolff --- .../Enterprise/PreviousReleases/RPB_15.12/README.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/PreviousReleases/RPB_15.12/README.md b/Reference-Platform/Platforms/Enterprise/PreviousReleases/RPB_15.12/README.md index 25ef139..86bbe02 100644 --- a/Reference-Platform/Platforms/Enterprise/PreviousReleases/RPB_15.12/README.md +++ b/Reference-Platform/Platforms/Enterprise/PreviousReleases/RPB_15.12/README.md @@ -4,10 +4,5 @@ ## Choose your Hardware -#### Consumer Edition -- [HiKey](ConsumerEdition/HiKey/README.md) -- [DragonBoard™ 410c](ConsumerEdition/DragonBoard-410c/README.md) - -#### Enterprise Edition - [D02](EnterpriseEdition/D02/README.md) - [Overdrive](EnterpriseEdition/Overdrive/README.md) From de150d24b28be840363de904b8589132f5a3593a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:45:13 -0800 Subject: [PATCH 016/114] Added links, these are probably not right... Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Hardware/README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Hardware/README.md index bf9c422..59e006e 100644 --- a/Reference-Platform/Platforms/Enterprise/Hardware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Hardware/README.md @@ -2,13 +2,13 @@ List of approved hardware, ideal for testing the Enterprise Reference Platform. -- [AMD Overdrive]() -- [LeMaker Cello]() -- [HiSilicon D03]() -- [HiSilicon D05]() -- [APM X-Gene Mustang]() -- [HP Proliant m400]() +- [AMD Overdrive](http://www.amd.com/en-us/innovations/software-technologies/technologies-gaming/over-drive) +- [LeMaker Cello](http://www.lenovator.com/product/103.html) +- [HiSilicon D03](http://open-estuary.org/d03/) +- [HiSilicon D05](http://open-estuary.org/d05/) +- [APM X-Gene Mustang](https://www.apm.com/products/data-center/x-gene-family/x-gene/) +- [HP Proliant m400](https://www.cdw.com/shop/products/HPE-ProLiant-m400-X-Gene-2.4-GHz-64-GB-0-GB/3516636.aspx) - [Qualcomm Q2432]() -- [Cavium Thunder X]() +- [Cavium Thunder X](http://www.cavium.com/ThunderX_ARM_Processors.html) Proceed to [Installation](../Installation/README.md) page. From 0a0a3349c15e6123a81702c5e4e5c5d2bf8bf226 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:46:30 -0800 Subject: [PATCH 017/114] Typo fix Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/GettingStarted/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md index 6c38615..8f6735a 100644 --- a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md +++ b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md @@ -4,7 +4,7 @@ This page is designed to bring you up to speed with the Enterprise Reference Pla ## Introduction -The enterprise reference platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. +The Enterprise Reference Platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. **Features:** From 74a7e334a4de636f6d30a5ca4d26b9657fa9c7ca Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:47:38 -0800 Subject: [PATCH 018/114] Added Content Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md new file mode 100644 index 0000000..d5eaa2e --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md @@ -0,0 +1,11 @@ +## UEFI/EDK2 + +EDK2 is a modern, feature-rich, cross-platform firmware development environment for the UEFI and PI specifications. + +The reference UEFI/EDK2 tree used by the EE-RPB comes directly from [upstream](https://github.com/tianocore/edk2), based on a specific commit that gets validated and published as part of the Linaro EDK2 effort (which is available at [https://git.linaro.org/uefi/linaro-edk2.git](https://git.linaro.org/uefi/linaro-edk2.git)). + +Since there is no hardware specific support as part of EDK2 upstream, an external module called [OpenPlatformPkg](https://git.linaro.org/uefi/OpenPlatformPkg.git) is also required as part of the build process. + +EDK2 is currently used by 96boards LeMaker Cello, AMD Overdrive, ARM Juno r0/r1/r2, HiSilicon D02 and HiSilicon D03. + +This guide provides enough information on how to build UEFI/EDK2 from scratch, but meant to be a quick guide. For further information please also check the official Linaro UEFI documentation, available at [https://wiki.linaro.org/ARM/UEFI](https://wiki.linaro.org/ARM/UEFI) and [https://wiki.linaro.org/LEG/Engineering/Kernel/UEFI/build](https://wiki.linaro.org/LEG/Engineering/Kernel/UEFI/build) From 585ba91c7f0c6ea798f343e6b7d2a466f5ba3baf Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:49:16 -0800 Subject: [PATCH 019/114] Added Content Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/Build.md | 135 ++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md new file mode 100644 index 0000000..8ccde87 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -0,0 +1,135 @@ +# Build + +## Pre-Requisites + +Make sure the build dependencies are available at your host machine. + +On Debian/Ubuntu: + +```shell +sudo apt-get install uuid-dev build-essential aisle +``` + +On RHEL/CentOS/Fedora: + +```shell +sudo yum install uuid-devel libuuid-devel aisle +``` + +Also make sure you have the right 'acpica-unix' version at your host system. The current one required by the 16.03/16.06 releases is 20150930, and you can find the packages (debian) at the 'linaro-overlay': + +```shell +wget http://repo.linaro.org/ubuntu/linaro-overlay/pool/main/a/acpica-unix/acpica-tools_20150930-1.linarojessie.1_amd64.deb +wget http://repo.linaro.org/ubuntu/linaro-overlay/pool/main/a/acpica-unix/acpidump_20150930-1.linarojessie.1_all.deb +wget http://repo.linaro.org/ubuntu/linaro-overlay/pool/main/a/acpica-unix/iasl_20150930-1.linarojessie.1_all.deb +sudo dpkg -i --force-all *.deb +``` + +If cross compiling, you also need to separately add the required toolchains. Ubuntu has a prebuilt arm-linux-gnueabihf toolchain, but not an aarch64-linux-gnu one. + +Download Linaro's GCC 4.9 cross-toolchain for Aarch64, and make it available in your 'PATH'. You can download and use the Linaro GCC binary (Linaro GCC 4.9-2015.02), available at [http://releases.linaro.org/15.02/components/toolchain/binaries/aarch64-linux-gnu/gcc-linaro-4.9-2015.02-3-x86_64_aarch64-linux-gnu.tar.xz](http://releases.linaro.org/15.02/components/toolchain/binaries/aarch64-linux-gnu/gcc-linaro-4.9-2015.02-3-x86_64_aarch64-linux-gnu.tar.xz) + +```shell +mkdir arm-tc arm64-tc +tar --strip-components=1 -C ${PWD}/arm-tc -xf gcc-linaro-arm-linux-gnueabihf-4.9-*_linux.tar.xz +tar --strip-components=1 -C ${PWD}/arm64-tc -xf gcc-linaro-aarch64-linux-gnu-4.9-*_linux.tar.xz +export PATH="${PWD}/arm-tc/bin:${PWD}/arm64-tc/bin:$PATH" +``` + +## Getting the source code + +UEFI/EDK2: + +```shell +git clone https://github.com/tianocore/edk2.git +git clone https://git.linaro.org/uefi/OpenPlatformPkg.git +cd edk2 +git checkout -b stable-baseline 469e1e1e4203b5d369fdce790883cb0aa035a744 # revision provided by https://git.linaro.org/uefi/linaro-edk2.git +ln -s ../OpenPlatformPkg +``` + +ARM Trusted Firmware (in case it is supported by your target hardware, only used by Juno at this point): + +```shell +git clone https://github.com/ARM-software/arm-trusted-firmware.git +cd arm-trusted-firmware +git checkout -b stable-baseline v1.2 # suggested latest stable release +``` + +UEFI Tools (helpers and scripts to make the build process easy): + +```shell +git clone git://git.linaro.org/uefi/uefi-tools.git +``` + +## Building UEFI/EDK2 for Juno R0/R1 + +```shell +export AARCH64_TOOLCHAIN=GCC49 +export LINARO_EDK2_DIR=${PWD}/edk2 +export UEFI_TOOLS_DIR=${PWD}/uefi-tools +export ARMTF_DIR=${PWD}/arm-trusted-firmware +cd ${LINARO_EDK2_DIR} +${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG -a $ARMTF_DIR juno +``` + +The output files: + +- `Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin` +- `Build/ArmJuno/DEBUG_GCC49/FV/fip.bin` + +## Building UEFI/EDK2 for D02 + +```shell +export AARCH64_TOOLCHAIN=GCC49 +export LINARO_EDK2_DIR=${PWD}/edk2 +export UEFI_TOOLS_DIR=${PWD}/uefi-tools +cd ${LINARO_EDK2_DIR} +${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG d02 +``` + +The output file: + +- `Build/Pv660D02/DEBUG_GCC49/FV/PV660D02.fd` + +## Building UEFI/EDK2 for D03 + +```shell +export AARCH64_TOOLCHAIN=GCC49 +export LINARO_EDK2_DIR=${PWD}/edk2 +export UEFI_TOOLS_DIR=${PWD}/uefi-tools +cd ${LINARO_EDK2_DIR} +${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG d03 +``` + +The output file: + +- `Build/D03/DEBUG_GCC49/FV/D03.fd` + +## Building UEFI/EDK2 for Overdrive + +```shell +export AARCH64_TOOLCHAIN=GCC49 +export LINARO_EDK2_DIR=${PWD}/edk2 +export UEFI_TOOLS_DIR=${PWD}/uefi-tools +cd ${LINARO_EDK2_DIR} +${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG overdrive +``` + +The output file: + +- `Build/Overdrive/DEBUG_GCC49/FV/STYX_ROM.fd` + +## Building UEFI/EDK2 for HuskyBoard / Cello + +```shell +export AARCH64_TOOLCHAIN=GCC49 +export LINARO_EDK2_DIR=${PWD}/edk2 +export UEFI_TOOLS_DIR=${PWD}/uefi-tools +cd ${LINARO_EDK2_DIR} +${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG cello +``` + +The output file: + +- `Build/Cello/DEBUG_GCC49/FV/STYX_ROM.fd` From e17972823332a69c1514599ee28daa16092ff4fb Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:51:28 -0800 Subject: [PATCH 020/114] Added Content Signed-off-by: Robert Wolff --- .../Installation/Firmware/Install.md | 208 ++++++++++++++++++ 1 file changed, 208 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md new file mode 100644 index 0000000..27492c8 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -0,0 +1,208 @@ +# Install + +## Juno R0/R1 + +### Clean flash + +Power on the board, and (if prompted) press Enter to stop auto boot. Once in Juno's boot monitor, use the following commands to erase Juno's flash and export it as an external storage: + +```shell +Cmd> flash +Flash> eraseall +Flash> quit +Cmd> usb_on +``` + +This will delete any binaries and UEFI settings currently stored in the Juno's flash, then mount the Juno's MMC card as an external storage device on your host PC. + +In order to do a clean flash on Juno, you will also need to flash the firmware provided by ARM, which can be downloaded from the Linaro ARM LT Versatile Express Firmware git tree: + +```shell +git clone -b juno-0.11.6-linaro1 --depth 1 https://git.linaro.org/arm/vexpress-firmware.git +``` + +Then copy over the UEFI/EDK2 files that were built in the previous steps, making sure they get copied to the right firmware folder location: + +```shell +cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin vexpress-firmware/SOFTWARE +cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/fip.bin vexpress-firmware/SOFTWARE +``` + +Now just copy all the files that are now available in the 'vexpress-firmware' folder into the mounted MMC card (which is provided as an external storage after calling 'usb_on'): + +```shell +cp -rf vexpress-firmware/* /media/recovery +``` + +Be sure to issue a sync command on your host PC afterwards, which will guarantee that the copy has completed: + +```shell +sync +``` + +Finally, power cycle the Juno. After it has finished copying the contents of the MMC card into Flash, the board will boot up and run the new firmware. + +##### Upgrading UEFI/EDK2 + +If you already have a known working firmware available in your Juno, you simply need to update 'bl1.bin' and 'fip.bin', by mounting Juno's MMC over usb (as described in the procedure for clean flash). + +Export Juno's MMC as a usb storage device on your host machine: + +```shell +Cmd> usb_on +``` + +Then just copy over the UEFI/EDK2 files that were built in the previous steps: + +```shell +cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin /media/recovery/SOFTWARE +cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/fip.bin /media/recovery/SOFTWARE +``` + +Be sure to issue a sync command on your host PC afterwards, which will guarantee that the copy has completed: + +```shell +sync +``` + +Then just power cycle the Juno and the board should see and use the new firmware. + +*** + +## D02 + +Flashing D02 requires the board to have a working ethernet connection to the FTP server hosting the firmware (since the recovery UEFI image provides an update path via FTP fetch + flash). Flashing also requires entering the Embedded Boot Loader (EBL). This can be reached by typing 'exit' on the UEFI shell that will bring you to a bios-like menu. Goto 'Boot Manager' to find EBL. + +### Clean flash + +First make sure the built firmware is available in your FTP server ('PV660D02.fd'): + +```shell +cp PV660D02.fd /srv/tftp/ +``` + +Now follow the steps below in order to fetch and flash the new firmware: + +1. Power off the board and unplug the power supply. +2. Push the dial switch **3. CPU0_SPI_SEL** to **off** (check [http://open-estuary.com/d02-2/](http://open-estuary.com/d02-2/) for the board picture) + - The board has two SPI flash chips, and this switch selects which one to boot from. +3. Power on the device, stop the boot from the serial console, and get into the the 'Embedded Boot Loader (EBL)' shell +4. Push the dial switch **3. CPU0_SPI_SEL** to **on** + - **NOTE:** make sure to run the step above before running 'biosupdate' (as it modifies the flash), or else the backup BIOS will also be modified and there will be no way to unbrick the board (unless sending it back to Huawei). +5. Download and flash the firmware file from the FTP server: +'biosupdate -u -p -f master' like +'D02 > biosupdate 10.0.0.10 -u anonymous -p anonymous -f PV660D02.fd master' +6. Exit the EBL console and reboot the board + +### Upgrading firmware + +There are 2 options for updating the firmware, first via network and the second via USB storage. + +Network upgrade: + +1. Make sure the built firmware is available in your FTP server ('PV660D02.fd') +2. Stop UEFI boot, select 'Boot Manager' then 'Embedded Boot Loader (EBL)' +3. Download and flash the firmware file from the FTP server: +'biosupdate -u -p -f master', like +'D02 > biosupdate 10.0.0.10 -u anonymous -p anonymous -f PV660D02.fd master' +4. Exit the EBL console and reboot the board + +USB storage upgrade: +- Copy the '.fd' file to a FAT32 partition on USB (UEFI can only recognize FAT32 file system), then run the following command (from **EBL**): +'newbios fs1:\' + +On EBL fs1 is for USB first partition, while fs0 the ramdisk. + +*** + +## D03 + +Flashing D03 requires the board to have a working ethernet connection to the FTP server hosting the firmware (since the recovery UEFI image provides an update path via FTP fetch + flash). Flashing also requires entering the Embedded Boot Loader (EBL). This can be reached by typing 'exit' on the UEFI shell that will bring you to a bios-like menu. Goto 'Boot Manager' to find EBL. + +### Clean flash + +To do a clean flash you will require access to the board's BMC. + +1. Make sure the board's BMC port is connected, and with a known IP address. +2. Login the BMC website, The username/passwd is root/Huawei12#$. Go to "System", "Firmware Upgrade", and "Browse" to select the UEFI file in hpm format. (Please contact support@open-estuary.org to get the hpm file). +3. Pull out the power cable to power off the board. Find the pin named "COM_SW" at J44. Then connect it with jump cap. +4. Power on the board and connect to the board's serial port. When the screen display message "You are trying to access a restricted zone. Only Authorized Users allowed.", type "Enter", input username/passwd (username/passwd is root/Huawei12#$). +5. After you login the BMC interface which start with "iBMC:/->", use command "ifconfig" to see the modified BMC IP. When you get the board's BMC IP, please visit the BMC website by "https://BMC IP ADDRESS/". +6. Go to "Start Update" (Do not power off during this period). +7. After updating the UEFI firmware, reboot the board to enter UEFI menu. + +### Upgrading firmware + +There are 2 options for updating the firmware, first via network and the second via USB storage. + +Network upgrade: + +1. Make sure the built firmware is available in your FTP server ('D03.fd') +2. Stop UEFI boot, select 'Boot Manager' then 'Embedded Boot Loader (EBL)' +3. Download and flash the firmware file from the FTP server: +'biosupdate -u -p -f master', like +'D02 > biosupdate 10.0.0.10 -u anonymous -p anonymous -f D03.fd master' +4. Exit the EBL console and reboot the board + +USB storage upgrade: +- Copy the '.fd' file to a FAT32 partition on USB (UEFI can only recognize FAT32 file system), then run the following command (from **EBL**): +'newbios fs1:\' + +On EBL fs1 is for USB first partition, while fs0 the ramdisk. + +*** + +## AMD Overdrive / HuskyBoard / Cello + +### Clean flash + +#### DediProg SF100 + +Use [DediProg SF100](http://www.dediprog.com/pd/spi-flash-solution/sf100) to flash the firmware via SPI, by plugging the programming unit into the Overdrive/Husky/Cello board 2x4 pin header (labeled SCP SPI J5 on Overdrive). + +The Dediprog flashing tool is also available for Linux, please check for [https://github.com/DediProgSW/SF100Linux](https://github.com/DediProgSW/SF100Linux) for build and use instructions. + +First unplug the power cord before flashing the new firmware, then erase the SPI flash memory: + +```shell +dpcmd --type MX25L12835F -e +``` + +Now just flash the new firmware: + +```shell +dpcmd --type MX25L12835F -p FIRMWARE.rom +``` + +Then just power cycle the board, and it should boot with the new firmware. + +#### SPI Hook + +Use [SPI Hook](http://www.tincantools.com/SPI_Hook.html) and _flashrom_ to flash the firmware via SPI, by plugging the programming unit into the Overdrive/Husky/Cello board 2x4 pin header (labeled SCP SPI J5 on Overdrive). + +In order to use SPI Hook, make sure _flashrom_ is recent enough. This utility is used to identify, read, write, verify and erase flash chips. You can find the _flashrom_ package in most Linux distributions, but make sure the version at least v.0.9.8. If older, please just build latest from source, by going to [flashrom Downloads](https://www.flashrom.org/Downloads) + +Depending on the size of the firmware image, flashrom might not be able to flash as it will complain that the size of the image is not a perfect match for the size of the SPI (partial flash only supported via the use of layouts). One easy way is just appending 0s at the end of the file, until it got the right size. + +Example for the 4.5M based firmware: + +```shell +dd if=/dev/zero of=FIRMWARE.ROM ibs=512K count=23 obs=1M oflag=append conv=notrunc +``` + +Connect the SPI cable, unplug the power cord and flash SPI: + +```shell +sudo flashrom -p ft2232_spi:type=2232h,port=A,divisor=2 -c "MX25L12835F/MX25L12845E/MX25L12865E" -w FIRMWARE.rom +``` + +Then just power cycle the board, and it should boot with the new firmware. + +### Upgrading firmware + +There is currently no easy way to update just the UEFI/EDK2 firmware, so please follow the clean flash process instead. + +# Links and References: + +- [ARM - Using Linaro's deliverables on Juno](https://community.arm.com/docs/DOC-10804) +- [ARM - FAQ: General troubleshooting on the Juno](https://community.arm.com/docs/DOC-8396) From 3aa1a8633bcb23396557da14fd955f158a3a5d00 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:53:28 -0800 Subject: [PATCH 021/114] Added relative link at bottom to install page Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/Build.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md index 8ccde87..a27c172 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -133,3 +133,7 @@ ${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG cello The output file: - `Build/Cello/DEBUG_GCC49/FV/STYX_ROM.fd` + +*** + +Proceed to [Installation](Install.md) page From a6df4307447fb7927494ea452a8543f9cdcdc15e Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:55:18 -0800 Subject: [PATCH 022/114] Small format fix Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/Install.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index 27492c8..0999ebd 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -42,7 +42,7 @@ sync Finally, power cycle the Juno. After it has finished copying the contents of the MMC card into Flash, the board will boot up and run the new firmware. -##### Upgrading UEFI/EDK2 +### Upgrade Firmware If you already have a known working firmware available in your Juno, you simply need to update 'bl1.bin' and 'fip.bin', by mounting Juno's MMC over usb (as described in the procedure for clean flash). @@ -94,7 +94,7 @@ Now follow the steps below in order to fetch and flash the new firmware: 'D02 > biosupdate 10.0.0.10 -u anonymous -p anonymous -f PV660D02.fd master' 6. Exit the EBL console and reboot the board -### Upgrading firmware +### Upgrade Firmware There are 2 options for updating the firmware, first via network and the second via USB storage. @@ -131,7 +131,7 @@ To do a clean flash you will require access to the board's BMC. 6. Go to "Start Update" (Do not power off during this period). 7. After updating the UEFI firmware, reboot the board to enter UEFI menu. -### Upgrading firmware +### Upgrade Firmware There are 2 options for updating the firmware, first via network and the second via USB storage. @@ -198,7 +198,7 @@ sudo flashrom -p ft2232_spi:type=2232h,port=A,divisor=2 -c "MX25L12835F/MX25L128 Then just power cycle the board, and it should boot with the new firmware. -### Upgrading firmware +### Upgrade Firmware There is currently no easy way to update just the UEFI/EDK2 firmware, so please follow the clean flash process instead. From 55410d48b900f567fe64b9b89bb7d7ab80f43129 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:57:23 -0800 Subject: [PATCH 023/114] Added installation links for each board Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/Build.md | 20 +++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md index a27c172..0e6c0f4 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -78,6 +78,10 @@ The output files: - `Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin` - `Build/ArmJuno/DEBUG_GCC49/FV/fip.bin` +### Proceed to [Installation](Install.md) page + +*** + ## Building UEFI/EDK2 for D02 ```shell @@ -92,6 +96,10 @@ The output file: - `Build/Pv660D02/DEBUG_GCC49/FV/PV660D02.fd` +### Proceed to [Installation](Install.md) page + +*** + ## Building UEFI/EDK2 for D03 ```shell @@ -106,6 +114,10 @@ The output file: - `Build/D03/DEBUG_GCC49/FV/D03.fd` +### Proceed to [Installation](Install.md) page + +*** + ## Building UEFI/EDK2 for Overdrive ```shell @@ -120,6 +132,10 @@ The output file: - `Build/Overdrive/DEBUG_GCC49/FV/STYX_ROM.fd` +### Proceed to [Installation](Install.md) page + +*** + ## Building UEFI/EDK2 for HuskyBoard / Cello ```shell @@ -134,6 +150,6 @@ The output file: - `Build/Cello/DEBUG_GCC49/FV/STYX_ROM.fd` -*** +### Proceed to [Installation](Install.md) page -Proceed to [Installation](Install.md) page +*** From 14286a4718bab273492e761c4dd4495324ff1212 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 17:59:14 -0800 Subject: [PATCH 024/114] Added Content Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Centos/README.md | 216 ++++++++++++++++++ 1 file changed, 216 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Centos/README.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Centos/README.md b/Reference-Platform/Platforms/Enterprise/Installation/Centos/README.md new file mode 100644 index 0000000..dbd12bd --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Centos/README.md @@ -0,0 +1,216 @@ +## Installing CentOS 7 - Reference Platform Enterprise + +This guide is not to be a replacement of the official CentOS Installer documentation, but instead be a quick walkthrough for the network installer. You can find the original documentation at [https://wiki.centos.org/SpecialInterestGroup/AltArch/AArch64](https://wiki.centos.org/SpecialInterestGroup/AltArch/AArch64) + +### Setting up the TFTP server + +Back to your dnsmasq server (check [this link](DHCP-TFTP-Server-UEFI.md) for instructions on how to setup your own TFTP/DCHP server), download the required CentOS 7 installer files at your tftp-root directory. In this example, this directory is configured to `/srv/tftp`. + +Downloading required Grub 2 UEFI files: + +```shell +sudo su - +cd /srv/tftp/ +wget http://mirror.centos.org/altarch/7/os/aarch64/EFI/BOOT/BOOTAA64.EFI +wget http://mirror.centos.org/altarch/7/os/aarch64/EFI/BOOT/grubaa64.efi +``` + +#### Downloading the CentOS 7 Reference Platform installer (e.g. 16.06 release): + +```shell +mkdir /srv/tftp/centos7 +cd /srv/tftp/centos7 +wget https://builds.96boards.org/releases/reference-platform/components/centos-installer/16.06/images/pxeboot/vmlinuz +wget https://builds.96boards.org/releases/reference-platform/components/centos-installer/16.06/images/pxeboot/initrd.img +``` + +Creating the Grub 2 config file (`grub.cfg`): + +```shell +menuentry 'Install CentOS 7 ARM 64-bit - Reference Platform' --class red --class gnu-linux --class gnu --class os { + linux (tftp)/centos7/vmlinuz ip=dhcp inst.stage2=https://builds.96boards.org/releases/reference-platform/components/centos-installer/16.06/ inst.repo=http://mirror.centos.org/altarch/7/os/aarch64/ inst.ks=file:/ks.cfg + initrd (tftp)/centos7/initrd.img +} +``` + +**Note:** `inst.ks` is required because of the additional linaro-overlay repository (which contains the reference platform kernel rpm package), which is available inside the `initrd.img`. The `inst.ks` contains only one line, which is used by the installer to fetch and install the right kernel package. The content: `repo --name="linaro-overlay" --baseurl=http://repo.linaro.org/rpm/linaro-overlay/centos-7/repo/`. + +Also check the [RHEL 7](https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Installation_Guide/chap-anaconda-boot-options.html) and the [anaconda documentation](https://rhinstaller.github.io/anaconda/boot-options.html) for additional boot options. One example is using **ip=eth1:dhcp** if you want to use the second network interface as default. + +You should now have the following file tree structure: + +```shell +/srv/tftp/ +├── BOOTAA64.EFI +├── centos7 +│   ├── initrd.img +│   └── vmlinuz +├── grubaa64.efi +└── grub.cfg +``` + +Now just make sure that @/etc/dnsmasq.conf@ is pointing out to the right boot file, like: + +```shell +dhcp-boot=BOOTAA64.EFI +``` + +### Booting the installer + +Now boot your platform of choice, selecting PXE boot when presented by UEFI (make sure to boot with the right network interface, in case more than one is available). + +You should see the following (using AMD Seattle's Overdrive as example): + +```shell +NOTICE: BL3-1: +NOTICE: BL3-1: Built : 15:14:55, Feb 9 2016 +INFO: BL3-1: Initializing runtime services +INFO: BL3-1: Preparing for EL3 exit to normal world +INFO: BL3-1: Next image address = 0x8000e80000 +INFO: BL3-1: Next image spsr = 0x3c9 +Boot firmware (version built at 15:18:14 on Feb 9 2016) +Version 2.17.1249. Copyright (C) 2016 American Megatrends, Inc. +BIOS Date: 02/09/2016 15:15:23 Ver: ROD1001A00 +Press or to enter setup. +. +>>Checking Media Presence...... +>>Media Present...... +>>Start PXE over IPv4. + Station IP address is 192.168.3.57 + Server IP address is 192.168.3.1 + NBP filename is BOOTAA64.EFI + NBP filesize is 885736 Bytes +>>Checking Media Presence...... +>>Media Present...... + Downloading NBP file... + Succeed to download NBP file. + Fetching Netboot Image +``` + +At this stage you should be able to see the Grub 2 menu, like: + +```shell +Install CentOS 7 ARM 64-bit - Reference Platform +. +Use the and keys to change the selection. +Press 'e' to edit the selected item, or 'c' for a command prompt. +``` + +Now just hit enter and wait for the kernel and initrd to load, which automatically loads the installer and provides you the installer console menu, so you can finally install CentOS 7. + +You should see the following: + +```shell +EFI stub: Booting Linux Kernel... +EFI stub: Using DTB from configuration table +EFI stub: Exiting boot services and installing virtual address map... +[ 0.000000] Booting Linux on physical CPU 0x0 +[ 0.000000] Initializing cgroup subsys cpuset +[ 0.000000] Initializing cgroup subsys cpu +[ 0.000000] Initializing cgroup subsys cpuacct +[ 0.000000] Linux version 4.4.0-reference.104.aarch64 (buildslave@r2-a19) (gcc version 4.8.3 20140911 (Red Hat 4.8.3-9) (GCC) ) #1 SMP Tue Mar 1 20:52:15 UTC 2016 +[ 0.000000] Boot CPU: AArch64 Processor [411fd072] +[ 0.000000] efi: Getting EFI parameters from FDT: +[ 0.000000] EFI v2.40 by American Megatrends +[ 0.000000] efi: ACPI 2.0=0x83ff1c3000 SMBIOS 3.0=0x83ff347798 +... +Welcome to CentOS Linux 7 (AltArch) dracut-033-359.el7 (Initramfs)! +... +dracut-initqueue[610]: RTNETLINK answers: File exists +dracut-initqueue[610]: % Total % Received % Xferd Average Speed Time Time Time Current +dracut-initqueue[610]: Dload Upload Total Spent Left Speed +100 287 100 287 0 0 390 0 --:--:-- --:--:-- --:--:-- 389:--:-- --:--:-- 0 +... +Welcome to CentOS Linux 7 (AltArch)! +... +Starting installer, one moment... +anaconda 21.48.22.56-1 for CentOS Linux AltArch 7 started. + * installation log files are stored in /tmp during the installation + * shell is available on TTY2 + * if the graphical installation interface fails to start, try again with the + inst.text bootoption to start text installation + * when reporting a bug add logs from /tmp as separate text/plain attachments +21:06:29 X startup failed, falling back to text mode +================================================================================ +================================================================================ +VNC +. +X was unable to start on your machine. Would you like to start VNC to connect t +o this computer from another computer and perform a graphical installation or co +ntinue with a text mode installation? +. + 1) Start VNC +. + 2) Use text mode +. + Please make your choice from above ['q' to quit | 'c' to continue | + 'r' to refresh]: 2 +[anaconda] 1:main* 2:shell 3:log 4:storage-log 5:program-log +``` + +For the text mode installer, just enter `2` and follow the instructions available in the console. + +Menu items without that are not `[x]` must be set. Enter the menu number associated with the menu in order to configure it. + +### Finishing the installation + +After selecting the install destination, partitioning scheme, root password and users (optional), just enter `b` to proceed with the installation. + +Once the installation is completed, you should be able to simply reboot the system in order to boot into your new CentOS 7 system. + +### Automating the installation with kickstart + +It is possible to fully automate the installer by providing a file called kickstart. The kickstart file is a plain text file, containing keywords that serve as directions for the installation. Check the RHEL 7 [kickstart guide](https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Installation_Guide/sect-kickstart-howto.html) for further information about how to create your own kickstart file. + +Kickstart example: + +```shell +cmdline +url --url="http://mirror.centos.org/altarch/7/os/aarch64/" +repo --name="CentOS" --baseurl=http://mirror.centos.org/altarch/7/os/aarch64/ +repo --name="Updates" --baseurl=http://mirror.centos.org/altarch/7/updates/aarch64/ +repo --name="linaro-overlay" --baseurl=http://repo.linaro.org/rpm/linaro-overlay/centos-7/repo/ +lang en_US.UTF-8 +keyboard us +timezone --utc Etc/UTC +auth --useshadow --passalgo=sha512 +rootpw --lock --iscrypted locked +firewall --disabled +firstboot --disabled +selinux --disabled +reboot +network --bootproto=dhcp --device=eth0 --activate --onboot=on +ignoredisk --only-use=sda +bootloader --location=mbr +clearpart --drives=sda --all --initlabel +part /boot/efi --fstype=efi --grow --maxsize=200 --size=20 +part /boot --fstype=ext4 --size=512 +part / --fstype=ext4 --size=10240 --grow +part swap --size=4000 +%packages +wget +net-tools +chrony +%end +%post +useradd -m -U -G wheel linaro +echo linaro | passwd linaro --stdin +%end +``` + +#### Setting up grub.cfg + +Now back to your tftp server, change the original grub.cfg file adding the location of your kickstart file: + +```shell +menuentry 'Install CentOS 7 ARM 64-bit - Reference Platform' --class red --class gnu-linux --class gnu --class os { + linux (tftp)/centos7/vmlinuz ip=dhcp inst.stage2=https://builds.96boards.org/releases/reference-platform/components/centos-installer/16.06/ inst.ks=http://people.linaro.org/~ricardo.salveti/centos-ks.cfg + initrd (tftp)/centos7/initrd.img +} +``` + +In case your system contains more than one network interface, also make sure to add the one to be used via the `ip` argument, like `ip=eth0:dhcp`. + +#### Booting the system + +Now just do a normal PXE boot, and anaconda should automatically load and use the kickstart file provided by grub.cfg. In case there is still a dialog that stops your installation that means not all the installer options are provided by your kickstart file. Get back to official documentation and try to find out what is the missing step. From e5771364ec624110b2b0b0afb40a2fd0bcaa8e8a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:00:03 -0800 Subject: [PATCH 025/114] Added content Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Debian/README.md | 342 ++++++++++++++++++ 1 file changed, 342 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Debian/README.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Debian/README.md b/Reference-Platform/Platforms/Enterprise/Installation/Debian/README.md new file mode 100644 index 0000000..c95ec87 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Debian/README.md @@ -0,0 +1,342 @@ +## Installing Debian "Jessie" 8.5 + +This guide is not to be a replacement of the official Debian Installer documentation, but instead be a quick walkthrough for the network installer. You can find the original documentation at [https://www.debian.org/releases/jessie/arm64/index.html.en](https://www.debian.org/releases/jessie/arm64/index.html.en) + +### Debian Installer + +The released debian-installer from Debian Jessie contains a kernel based on 3.16, which doesn't yet provide support for development boards used by the reference software project. For a complete enterprise experience (including support for tip-based kernel with ACPI support and additional platforms), we also build and publish a custom debian installer that incorporates a more recent kernel. + +Our custom installer changes nothing more than the kernel, and you can also find the instructions to build it from source at the end of this document. + +## Loading debian-installer from the network +### Setting up the TFTP server + +Back to your dnsmasq server (check [this link](../DHCP-TFTP-Server-UEFI.md) for instructions on how to setup your own TFTP/DCHP server), download the required Debian installer files at your tftp-root directory. In this example, this directory is configured to `/srv/tftp`. + +Since the kernel, initrd and GRUB 2 is part of the debian-installer tarball (`netboot.tar.gz`), that is the only file you will need to download and use. + +#### Downloading debian-installer: + +```shell +sudo su - +cd /srv/tftp/ +wget https://builds.96boards.org/releases/reference-platform/components/debian-installer/16.06/netboot.tar.gz +tar -zxvf netboot.tar.gz +``` + +You should now have the following file tree structure: + +```shell +/srv/tftp/ +├── debian-installer +│   └── arm64 +│   ├── bootnetaa64.efi +│   ├── grub +│   │   ├── arm64-efi +│   │   │   ├── acpi.mod +│   │   │   ├── adler32.mod +│   │   │   ├── all_video.mod +│   │   │   ├── archelp.mod +│   │   │   ├── bfs.mod +│   │   │   ├── bitmap.mod +│   │   │   ├── bitmap_scale.mod +│   │   │   ├── blocklist.mod +│   │   │   ├── boot.mod +│   │   │   ├── btrfs.mod +│   │   │   ├── bufio.mod +... +│   │   │   ├── xzio.mod +│   │   │   └── zfscrypt.mod +│   │   ├── font.pf2 +│   │   └── grub.cfg +│   ├── initrd.gz +│   └── linux +├── netboot.tar.gz +└── version.info +``` + +Now just make sure that `/etc/dnsmasq.conf` is pointing out to the right boot file, like: + +```shell +dhcp-boot=debian-installer/arm64/bootnetaa64.efi +``` +## Loading debian-installer from the minimal CD + +Together with the debian-installer netboot files, a minimal ISO is also provided containing the same installer, which can be loaded as normal boot disk media. + +Making a bootable SATA disk / USB stick / microSD card (attention to **/dev/sdX**, make sure that it is your target device first): + +``` +wget https://builds.96boards.org/releases/reference-platform/components/debian-installer/16.06/mini.iso +sudo cp mini.iso /dev/sdX +sync +``` + +Please refer to the [debian-manual](https://www.debian.org/releases/jessie/amd64/ch04s03.html.en) for a more complete guide on creating a CD, SATA disk, USB stick or micro SD with the minimal ISO. + +## Booting the installer + +If you are booting the installer from the network, simply select PXE boot when presented by UEFI (make sure to boot with the right network interface, in case more than one is available). In case you are booting with the minimal ISO via SATA / USB / microSD, simply select the right boot option in UEFI. + +You should see the following (using AMD Seattle's Overdrive as example): + +```shell +NOTICE: BL3-1: +NOTICE: BL3-1: Built : 18:22:46, Nov 23 2015 +INFO: BL3-1: Initializing runtime services +INFO: BL3-1: Preparing for EL3 exit to normal world +INFO: BL3-1: Next image address = 0x8000000000 +INFO: BL3-1: Next image spsr = 0x3c9 +Boot firmware (version built at 18:27:24 on Nov 23 2015) +Version 2.17.1249. Copyright (C) 2015 American Megatrends, Inc. +BIOS Date: 11/23/2015 18:23:09 Ver: ROD0085E00 +Press or to enter setup. +. +>>Checking Media Presence...... +>>Media Present...... +>>Start PXE over IPv4. + Station IP address is 192.168.3.57 + Server IP address is 192.168.3.1 + NBP filename is BOOTAA64.EFI + NBP filesize is 885736 Bytes +>>Checking Media Presence...... +>>Media Present...... + Downloading NBP file... + Succeed to download NBP file. + Fetching Netboot Image +``` + +At this stage you should be able to see the Grub 2 menu, like: + +```shell +Install +Advanced options ... +Install with speech synthesis +. +Use the and keys to change the selection. +Press 'e' to edit the selected item, or 'c' for a command prompt. +``` + +Now just hit enter and wait for the kernel and initrd to load, which automatically loads the installer and provides you the installer console menu, so you can finally install Debian. + +You should see the following: + +```shell +EFI stub: Booting Linux Kernel... +EFI stub: Using DTB from configuration table +EFI stub: Exiting boot services and installing virtual address map... +[ 0.355175] ACPI: IORT: Failed to get table, AE_NOT_FOUND +[ 0.763784] kvm [1]: error: no compatible GIC node found +[ 0.763818] kvm [1]: error initializing Hyp mode: -19 +[ 0.886298] Failed to find cpu0 device node +[ 0.947082] zswap: default zpool zbud not available +[ 0.951959] zswap: pool creation failed +Starting system log daemon: syslogd, klogd. +... + ┌───────────────────────┤ [!!] Select a language ├────────────────────────┐ + │ │ + │ Choose the language to be used for the installation process. The │ + │ selected language will also be the default language for the installed │ + │ system. │ + │ │ + │ Language: │ + │ │ + │ C │ + │ English │ + │ │ + │ │ + │ │ + └─────────────────────────────────────────────────────────────────────────┘ + moves; selects; activates buttons +``` + +### Finishing the installation + +For using the installer, please check the documentation available at [https://www.debian.org/releases/jessie/arm64/ch06.html.en](https://www.debian.org/releases/jessie/arm64/ch06.html.en) + +**NOTE - Cello Only:** In case your mac address is empty (e.g. early boards), you will be required to change your default network mac address in order to proceed with the network install. Please open a shell after booted the installer (the installer offers the shell option at the first menu), and change the mac address as described below. Once changed, simply proceed with the install process. + +``` +~ # ip link set dev enp1s0 address de:5e:60:e4:6b:1f +~ # exit +``` + +Once the installation is completed, you should be able to simply reboot the system in order to boot your new Debian system. + +**NOTE - Cello Only:** If you had to set a valid mac address during the installer, you will be required to also set the mac address in debian, after your first boot. Please change _/etc/network/interfaces_ and add your mac address again, like below: + +``` +root@debian:~# cat /etc/network/interfaces +... +allow-hotplug enp1s0 +iface enp1s0 inet dhcp + hwaddress ether de:5e:60:e4:6b:1f +``` + +### Automating the installation using preseeding + +Preseeding provides a way to set answers to questions asked during the installation process, without having to manually enter the answers while the installation is running. This makes it possible to fully automate the installation over network, when used together with the debian-installer. + +This document only provides a quick way for you to get started with preseeding. For the complete guide, please check the [Debian GNU/Linux Installation Guide](https://www.debian.org/releases/jessie/arm64/apb.html) and [example-preseed.txt](https://www.debian.org/releases/jessie/example-preseed.txt) + +**Note:** Since we require an external kernel to be installed during the install process, this is done via the `preseed/late_command` argument, so you if you decide to use that command as part of your preseed file, make sure to add the following as part of the multi-line command: + +```shell +d-i preseed/late_command string in-target apt-get install -y linux-image-reference-arm64; # here you can add 'in-target foobar' for additional commands +``` + +#### Creating the preseed file + +Check [example-preseed.txt](https://www.debian.org/releases/jessie/example-preseed.txt) for a wide list of options supported by the Debian Jessie installer. Your file needs to use a similar format, but customized for your own needs. + +Once created, make sure the file gets published into a network address that can be reachable from your target device. + +Preseed example (`preseed.cfg`): + +```shell +d-i debian-installer/locale string en_US +d-i keyboard-configuration/xkb-keymap select us +d-i netcfg/dhcp_timeout string 60 +d-i netcfg/get_hostname string unassigned-hostname +d-i netcfg/get_domain string unassigned-domain +d-i netcfg/hostname string debian +d-i mirror/country string manual +d-i mirror/http/hostname string httpredir.debian.org +d-i mirror/http/directory string /debian +d-i mirror/http/proxy string +d-i passwd/root-password password linaro123 +d-i passwd/root-password-again password linaro123 +d-i passwd/user-fullname string Linaro User +d-i passwd/username string linaro +d-i passwd/user-password password linaro +d-i passwd/user-password-again password linaro +d-i passwd/user-default-groups string audio cdrom video sudo +d-i time/zone string UTC +d-i clock-setup/ntp boolean true +d-i clock-setup/utc boolean true +d-i partman-auto/disk string /dev/sda +d-i partman-auto/method string regular +d-i partman-lvm/device_remove_lvm boolean true +d-i partman-md/device_remove_md boolean true +d-i partman-auto/choose_recipe select atomic +d-i partman/confirm_write_new_label boolean true +d-i partman/choose_partition select finish +d-i partman/confirm boolean true +d-i partman/confirm_nooverwrite boolean true +popularity-contest popularity-contest/participate boolean false +tasksel tasksel/first multiselect standard, web-server +d-i pkgsel/include string openssh-server build-essential ca-certificates sudo vim ntp +d-i pkgsel/upgrade select safe-upgrade +d-i finish-install/reboot_in_progress note +``` + +In this example, this content is also available at [http://people.linaro.org/~ricardo.salveti/preseed.cfg](http://people.linaro.org/~ricardo.salveti/preseed.cfg) + +#### Setting up grub.cfg + +Now back to your tftp server, change the original `grub.cfg` file adding the location of your preseed file: + +```shell +$ cat /srv/tftp/debian-installer/arm64/grub/grub.cfg +# Force grub to automatically load the first option +set default=0 +set timeout=1 +menuentry 'Install with preseeding' { + linux /debian-installer/arm64/linux auto=true priority=critical url=http://people.linaro.org/~ricardo.salveti/preseed.cfg --- + initrd /debian-installer/arm64/initrd.gz +} +``` + +The `auto` kernel parameter is an alias for `auto-install/enable` and setting it to `true` delays the locale and keyboard questions until after there has been a chance to preseed them, while `priority` is an alias for `debconf/priority` and setting it to `critical` stops any questions with a lower priority from being asked. + +In case your system contains more than one network interface, also make sure to add the one to be used via the `interface` argument, like `interface=eth1`. + +#### Booting the system + +Now just do a normal PXE boot, and debian-installer should automatically load and use the preseeds file provided by `grub.cfg`. In case there is still a dialog that stops your installation that means not all the debian-installer options are provided by your preseeds file. Get back to [example-preseed.txt](https://www.debian.org/releases/jessie/example-preseed.txt) and try to identify what is missing step. + +Also make sure to check debian-installer's `/var/log/syslog` (by opening a shell) when debugging the installer. + +### Building debian-installer from source + +#### Build kernel package and udebs + +Check the Debian [kernel-handbook](http://kernel-handbook.alioth.debian.org/ch-common-tasks.html) for the instructions required to build the debian kernel package from scratch. Since the installer only understands `udeb` packages, it is a good idea to reuse the official kernel packaging instructions and rules. + +You can also find the custom kernel source package created as part of the EE-RPB effort at [https://builds.96boards.org/snapshots/reference-platform/components/linux/enterprise/latest/](https://builds.96boards.org/snapshots/reference-platform/components/linux/enterprise/latest/) + +#### Rebuilding debian-installer with the new udebs + +To build the installer, make sure you're running on a native `arm64` system, preferably running Debian Jessie. + +Download the installer (from jessie): + +```shell +sudo apt-get build-dep debian-installer +dget http://ftp.us.debian.org/debian/pool/main/d/debian-installer/debian-installer_20150422+deb8u4.dsc +``` + +Change the kernel abi and set a default local preseed (so it can install your kernel during the install process): + +```shell +cd debian-installer-* +cd build +sed -i "s/LINUX_KERNEL_ABI.*/LINUX_KERNEL_ABI = YOUR_KERNEL_ABI/g" config/common +sed -i "s/PRESEED.*/PRESEED = default-preseed/g" config/common +``` + +Download the kernel udebs that you created at the localudebs folder: + +```shell +cd localudebs +wget +cd .. +``` + +Create a local pkg-list to include the udebs created (otherwise d-i will not be able to find them online): + +```shell +cat < pkg-lists/local +ext4-modules-\${kernel:Version} +fat-modules-\${kernel:Version} +btrfs-modules-\${kernel:Version} +md-modules-\${kernel:Version} +efi-modules-\${kernel:Version} +scsi-modules-\${kernel:Version} +jfs-modules-\${kernel:Version} +xfs-modules-\${kernel:Version} +ata-modules-\${kernel:Version} +sata-modules-\${kernel:Version} +usb-storage-modules-\${kernel:Version} +EOF +``` + +Set up the local repo, so the installer can locate your udebs (from localudebs): + +```shell +cat < sources.list.udeb +deb [trusted=yes] copy:/PATH/TO/your/installer/d-i/debian-installer-20150422/build/ localudebs/ +deb http://httpredir.debian.org/debian jessie main/debian-installer +EOF +``` + +Default preseed to skip known errors (as the kernel provided by local udebs): + +``` +cat < default-preseed +# Continue install on "no kernel modules were found for this kernel" +d-i anna/no_kernel_modules boolean true +# Continue install on "no installable kernels found" +d-i base-installer/kernel/skip-install boolean true +d-i base-installer/kernel/no-kernels-found boolean true +d-i preseed/late_command string in-target wget ; dpkg -i linux-image-*.deb +EOF +``` + +Now just build the installer: + +```shell +fakeroot make build_netboot +``` + +You should now find your custom debian-installer at `dest/netboot/netboot.tar.gz`. From 94da6b2384cbffb445dd1e9872129e276981e11a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:00:48 -0800 Subject: [PATCH 026/114] Added relative links to Debian and centos options Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index e6595a3..c346da7 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -43,12 +43,12 @@ Choose your network installer, download or build, and proceed to the installatio - + - +
CentosCentos Download Install
Debian JessieDebian Jessie Download Install
Centos DownloadInstallInstall
Debian Jessie DownloadInstallInstall
From 56238366430d76e45b0458396046d5a13feda369 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:06:17 -0800 Subject: [PATCH 027/114] Added table indicating location Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/Build.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md index 0e6c0f4..3811135 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -1,4 +1,12 @@ -# Build + + + + + + + +
UEFI/EDK2Download
Get the latest pre-built firmware images		Build
Instructions for building latest firmware images + 		Install
Instructions on how to install firmware		Read more
Learn more about UEFI/EDK2
## Pre-Requisites From f84fe1b80fb93f644bef46d565cc07489b32d919 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:07:02 -0800 Subject: [PATCH 028/114] Added table indicating location Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/Install.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index 0999ebd..0e91f08 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -1,4 +1,12 @@ -# Install + + + + + + + +
UEFI/EDK2Download
Get the latest pre-built firmware images		Build
Instructions for building latest firmware images		Install
Instructions on how to install firmware + 		Read more
Learn more about UEFI/EDK2
## Juno R0/R1 From 054d379a5a3f2d496e8957092701fda442f4ff56 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:07:44 -0800 Subject: [PATCH 029/114] Added table indication location Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md index d5eaa2e..855d5f3 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md @@ -1,4 +1,12 @@ -## UEFI/EDK2 + + + + + + + +
UEFI/EDK2Download
Get the latest pre-built firmware images		Build
Instructions for building latest firmware images		Install
Instructions on how to install firmware		Read more
Learn more about UEFI/EDK2 +
EDK2 is a modern, feature-rich, cross-platform firmware development environment for the UEFI and PI specifications. From 0433957d7dfd1ae759f9f5c64ce5f51fbc074adb Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:10:55 -0800 Subject: [PATCH 030/114] Update README.md --- .../Platforms/Enterprise/Installation/Firmware/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md index 855d5f3..4a0c6ff 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md @@ -1,6 +1,6 @@ - + From 21144daa6f121fdd5366021020c74adce4d54e77 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:11:08 -0800 Subject: [PATCH 031/114] Update Build.md --- .../Platforms/Enterprise/Installation/Firmware/Build.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md index 3811135..6e639e9 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -1,6 +1,6 @@
UEFI/EDK2UEFI/EDK2
Go Back		 Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images		 Install
Instructions on how to install firmware
- + From f62476a0308e2cc0b3acb4dfcbb520bda4f7340c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 13 Dec 2016 18:11:17 -0800 Subject: [PATCH 032/114] Update Install.md --- .../Platforms/Enterprise/Installation/Firmware/Install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index 0e91f08..aa11acd 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -1,6 +1,6 @@
UEFI/EDK2UEFI/EDK2
Go Back		 Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images 		Install
Instructions on how to install firmware
- +
UEFI/EDK2UEFI/EDK2
Go Back		 Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images		 Install
Instructions on how to install firmware From 42692a4fc3e83f2b9a5bc0624111ed2254205899 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 15 Dec 2016 11:51:51 -0800 Subject: [PATCH 033/114] Update README.md --- Reference-Platform/Platforms/Enterprise/Support/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Support/README.md b/Reference-Platform/Platforms/Enterprise/Support/README.md index cccc8b2..a8d4a5e 100644 --- a/Reference-Platform/Platforms/Enterprise/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Support/README.md @@ -2,7 +2,7 @@ Please take advantage of the many Enterprise Reference Platform resources available to you Linaro and third parties. -- [Release Note](../ReleaseNotes.md) +- [Release Notes](../ReleaseNotes.md) - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. - [Enterprise Forum](http://www.96boards.org/forums/forum/products/dragonboard410c/) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. From 4184005a278220f794e7202deee03fa709c70af8 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 15 Dec 2016 11:52:55 -0800 Subject: [PATCH 034/114] Update README.md Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Installation/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index c346da7..e055ad7 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -2,6 +2,8 @@ This page offers generic installation instructions for the Enterprise Reference Platform on supported hardware. A list of approved hardware can be found in the ["Approved Hardware"](../Hardware/README.md) section of this documentation set. +Be sure to check out the [Release Notes](../ReleaseNotes.md) before installing. + *** ## Step 1: Upgrade firmware to latest version From f3e748336e6b49b2bb756ae8c7536fa64f326d4c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Fri, 16 Dec 2016 12:53:44 -0800 Subject: [PATCH 035/114] Juno dropped Signed-off-by: Robert Wolff --- .../Installation/Firmware/Install.md | 69 ------------------- 1 file changed, 69 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index aa11acd..39ad332 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -8,75 +8,6 @@
-## Juno R0/R1 - -### Clean flash - -Power on the board, and (if prompted) press Enter to stop auto boot. Once in Juno's boot monitor, use the following commands to erase Juno's flash and export it as an external storage: - -```shell -Cmd> flash -Flash> eraseall -Flash> quit -Cmd> usb_on -``` - -This will delete any binaries and UEFI settings currently stored in the Juno's flash, then mount the Juno's MMC card as an external storage device on your host PC. - -In order to do a clean flash on Juno, you will also need to flash the firmware provided by ARM, which can be downloaded from the Linaro ARM LT Versatile Express Firmware git tree: - -```shell -git clone -b juno-0.11.6-linaro1 --depth 1 https://git.linaro.org/arm/vexpress-firmware.git -``` - -Then copy over the UEFI/EDK2 files that were built in the previous steps, making sure they get copied to the right firmware folder location: - -```shell -cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin vexpress-firmware/SOFTWARE -cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/fip.bin vexpress-firmware/SOFTWARE -``` - -Now just copy all the files that are now available in the 'vexpress-firmware' folder into the mounted MMC card (which is provided as an external storage after calling 'usb_on'): - -```shell -cp -rf vexpress-firmware/* /media/recovery -``` - -Be sure to issue a sync command on your host PC afterwards, which will guarantee that the copy has completed: - -```shell -sync -``` - -Finally, power cycle the Juno. After it has finished copying the contents of the MMC card into Flash, the board will boot up and run the new firmware. - -### Upgrade Firmware - -If you already have a known working firmware available in your Juno, you simply need to update 'bl1.bin' and 'fip.bin', by mounting Juno's MMC over usb (as described in the procedure for clean flash). - -Export Juno's MMC as a usb storage device on your host machine: - -```shell -Cmd> usb_on -``` - -Then just copy over the UEFI/EDK2 files that were built in the previous steps: - -```shell -cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin /media/recovery/SOFTWARE -cp $LINARO_EDK2_DIR/Build/ArmJuno/DEBUG_GCC49/FV/fip.bin /media/recovery/SOFTWARE -``` - -Be sure to issue a sync command on your host PC afterwards, which will guarantee that the copy has completed: - -```shell -sync -``` - -Then just power cycle the Juno and the board should see and use the new firmware. - -*** - ## D02 Flashing D02 requires the board to have a working ethernet connection to the FTP server hosting the firmware (since the recovery UEFI image provides an update path via FTP fetch + flash). Flashing also requires entering the Embedded Boot Loader (EBL). This can be reached by typing 'exit' on the UEFI shell that will bring you to a bios-like menu. Goto 'Boot Manager' to find EBL. From 071b6172b36089d90ad6aa27cadf5e6a9e6a347a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Fri, 16 Dec 2016 12:54:51 -0800 Subject: [PATCH 036/114] Update Install.md Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/Install.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index 39ad332..b077a60 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -8,6 +8,10 @@ +Choose instructions from the approved hardware: + +*** + ## D02 Flashing D02 requires the board to have a working ethernet connection to the FTP server hosting the firmware (since the recovery UEFI image provides an update path via FTP fetch + flash). Flashing also requires entering the Embedded Boot Loader (EBL). This can be reached by typing 'exit' on the UEFI shell that will bring you to a bios-like menu. Goto 'Boot Manager' to find EBL. From 20747ad0f2a3578ed1f8f764b4166c387fed9056 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Fri, 16 Dec 2016 12:55:56 -0800 Subject: [PATCH 037/114] Removed Juno Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Firmware/Build.md | 18 +----------------- 1 file changed, 1 insertion(+), 17 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md index 6e639e9..7e517e7 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -8,7 +8,7 @@ -## Pre-Requisites +## Pre-Requisites and Dependencies Make sure the build dependencies are available at your host machine. @@ -70,22 +70,6 @@ UEFI Tools (helpers and scripts to make the build process easy): git clone git://git.linaro.org/uefi/uefi-tools.git ``` -## Building UEFI/EDK2 for Juno R0/R1 - -```shell -export AARCH64_TOOLCHAIN=GCC49 -export LINARO_EDK2_DIR=${PWD}/edk2 -export UEFI_TOOLS_DIR=${PWD}/uefi-tools -export ARMTF_DIR=${PWD}/arm-trusted-firmware -cd ${LINARO_EDK2_DIR} -${UEFI_TOOLS_DIR}/uefi-build.sh -b DEBUG -a $ARMTF_DIR juno -``` - -The output files: - -- `Build/ArmJuno/DEBUG_GCC49/FV/bl1.bin` -- `Build/ArmJuno/DEBUG_GCC49/FV/fip.bin` - ### Proceed to [Installation](Install.md) page *** From e080284903ec4477de2c6bcdede56ecb92c5fe36 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Fri, 16 Dec 2016 12:57:34 -0800 Subject: [PATCH 038/114] Fixed format issue for website rendering Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Hardware/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Hardware/README.md index 59e006e..fba00fc 100644 --- a/Reference-Platform/Platforms/Enterprise/Hardware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Hardware/README.md @@ -8,7 +8,7 @@ List of approved hardware, ideal for testing the Enterprise Reference Platform. - [HiSilicon D05](http://open-estuary.org/d05/) - [APM X-Gene Mustang](https://www.apm.com/products/data-center/x-gene-family/x-gene/) - [HP Proliant m400](https://www.cdw.com/shop/products/HPE-ProLiant-m400-X-Gene-2.4-GHz-64-GB-0-GB/3516636.aspx) -- [Qualcomm Q2432]() +- Qualcomm Q2432 - [Cavium Thunder X](http://www.cavium.com/ThunderX_ARM_Processors.html) Proceed to [Installation](../Installation/README.md) page. From d369b2f2a2b3e95dbc084970f2a6d0c25aab374a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Fri, 16 Dec 2016 12:59:14 -0800 Subject: [PATCH 039/114] Update README.md --- Reference-Platform/Platforms/Enterprise/Support/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Support/README.md b/Reference-Platform/Platforms/Enterprise/Support/README.md index a8d4a5e..771ad1e 100644 --- a/Reference-Platform/Platforms/Enterprise/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Support/README.md @@ -6,5 +6,5 @@ Please take advantage of the many Enterprise Reference Platform resources availa - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. - [Enterprise Forum](http://www.96boards.org/forums/forum/products/dragonboard410c/) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. -- [Report a bug!](../../../Extras/Report_a_bug.md) +- [Report a bug!](../../../Extras/Report-a-bug.md) - Instructions on how to report Enterprise Reference Platform bugs From a5410e38d15b8283485965d26ebde0e01bf94cc5 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Fri, 16 Dec 2016 13:02:08 -0800 Subject: [PATCH 040/114] Changed link to forum Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Support/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Support/README.md b/Reference-Platform/Platforms/Enterprise/Support/README.md index 771ad1e..a597af5 100644 --- a/Reference-Platform/Platforms/Enterprise/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Support/README.md @@ -4,7 +4,7 @@ Please take advantage of the many Enterprise Reference Platform resources availa - [Release Notes](../ReleaseNotes.md) - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. -- [Enterprise Forum](http://www.96boards.org/forums/forum/products/dragonboard410c/) +- [Enterprise Forum](https://platforms.linaro.org/community/) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. - [Report a bug!](../../../Extras/Report-a-bug.md) - Instructions on how to report Enterprise Reference Platform bugs From f6d8d16069702111e02d5f70153e3eea2c655aa1 Mon Sep 17 00:00:00 2001 From: Shovan Date: Tue, 20 Dec 2016 15:20:42 +0000 Subject: [PATCH 041/114] Added forum link --- Reference-Platform/Platforms/Enterprise/Support/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Support/README.md b/Reference-Platform/Platforms/Enterprise/Support/README.md index a597af5..f21db2c 100644 --- a/Reference-Platform/Platforms/Enterprise/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Support/README.md @@ -4,7 +4,7 @@ Please take advantage of the many Enterprise Reference Platform resources availa - [Release Notes](../ReleaseNotes.md) - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. -- [Enterprise Forum](https://platforms.linaro.org/community/) +- [Enterprise Forum](https://discuss.linaro.org/c/erp) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. - [Report a bug!](../../../Extras/Report-a-bug.md) - Instructions on how to report Enterprise Reference Platform bugs From 63f629a2f6e05b35aa137dfd78cb4b03ea209ffb Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 20 Dec 2016 10:47:26 -0800 Subject: [PATCH 042/114] Added link to download on releases.linaro Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Installation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index e055ad7..cb1f0ef 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -11,7 +11,7 @@ Be sure to check out the [Release Notes](../ReleaseNotes.md) before installing. + From 98eb52643469dcfaf892da9e11a13a432920d287 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 20 Dec 2016 10:48:42 -0800 Subject: [PATCH 043/114] Added links for Debian and Centos installers Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index cb1f0ef..f3ab14e 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -44,12 +44,12 @@ Choose your network installer, download or build, and proceed to the installatio
UEFI/EDK2 - Download
Get the latest pre-built firmware images		Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images		 Install
Instructions on how to install firmware		 Read more
Learn more about UEFI/EDK2
+ +
Centos - DownloadDownload Install
Debian Jessie - DownloadDownload Install
From 15cf5adff67fe20d45d2961f4c951965382e2074 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 20 Dec 2016 10:53:10 -0800 Subject: [PATCH 044/114] Added release notes Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/ReleaseNotes.md | 69 ++++++++++++++++++- 1 file changed, 68 insertions(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 3ed5f25..395cf68 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -1,3 +1,70 @@ # 16.12 Release Notes - Enterprise Reference Platform -< Add when ready here > +## Reference Platform Kernel + +- 4.9 based, including under-review topic branches to extend hardware platform support +- Unified tree, used by both the CentOS and Debian Reference Platforms +- ACPI and PCIe support +- Single kernel config and binary (package) for all hardware platforms + +## UEFI + +- Tianocore EDK II and OpenPlatformPkg containing reference implementations for Huawei D03/D05, AMD Overdrive and LeMaker Cello + +## Debian + +- Network Installer based on Debian 8.6 "Jessie" +- Unified Reference Platform Kernel based on 4.9 + +## CentOS + +- Network Installer based on CentOS 7.2 16.03 +- Unified Reference Platform Kernel based on 4.9 + +## Enterprise Components +- Docker 1.10.3 +- OpenStack + - Not ready +- Ceph 10.2.3 +- Spark 2.0 +- OpenJDK 8 +- QEMU 2.7 + +## Supported Hardware Platforms + +- AMD Overdrive +- LeMaker Cello +- HiSilicon D03 +- HiSilicon D05 +- APM X-Gene Mustang +- HP Proliant m400 +- Qualcomm Q2432 +- Cavium Thunder X + +## Known Issues + +### CentOS: + +- Using Docker with XFS and Overlay Storage Driver: + - Note that XFS file systems must be created with the -n ftype=1 option enabled for use as an overlay. With the rootfs and any file systems created during system installation, set the --mkfsoptions=-n ftype=1 parameters in the Anaconda kickstart. When creating a new file system after the installation, run the # mkfs -t xfs -n ftype=1 /PATH/TO/DEVICE command. To determine whether an existing file system is eligible for use as an overlay, run the # xfs_info /PATH/TO/DEVICE | grep ftype command to see if the ftype=1 option is enabled. + - https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.2_Release_Notes/technology-preview-file_systems.html +- Installation via USB fails - bug 2655 + +### QDF2432: + +- No support for on-board ethernet (emac) - bug 2603 + +### D03: + +- Only 16 cores enabled (instead of 32) - bug 2635 +- Fails to install/boot Debian/CentOS with the default boot argument - bug 2661 +- Earlycon not working (no console output) - bug 2699 + +### HP-m400 Moonshot: + +- Boot medium is not updated after network installer - bug 2703 + +### Cavium (ThunderX) + +- UEFI boot entry not created after Debian installer finished - bug 2736 + From d1dd0815d0b19246719bed0af251951dc2e63b60 Mon Sep 17 00:00:00 2001 From: Tyler Baker Date: Wed, 21 Dec 2016 09:25:28 -0800 Subject: [PATCH 045/114] ceph: mark it as not ready. --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 395cf68..1e2d92e 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -26,6 +26,7 @@ - OpenStack - Not ready - Ceph 10.2.3 + - Not ready - Spark 2.0 - OpenJDK 8 - QEMU 2.7 From 295ec89b4dae918ffb39a1f821edf58ede0a5c1e Mon Sep 17 00:00:00 2001 From: Tyler Baker Date: Wed, 21 Dec 2016 15:22:52 -0800 Subject: [PATCH 046/114] Release Notes: add links to bugs --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 1e2d92e..4f99294 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -58,14 +58,14 @@ ### D03: - Only 16 cores enabled (instead of 32) - bug 2635 -- Fails to install/boot Debian/CentOS with the default boot argument - bug 2661 -- Earlycon not working (no console output) - bug 2699 +- Fails to install/boot Debian/CentOS with the default boot argument - (https://bugs.linaro.org/show_bug.cgi?id=2661 "bug 2661") +- Earlycon not working (no console output) - (https://bugs.linaro.org/show_bug.cgi?id=2699 "bug 2699") ### HP-m400 Moonshot: -- Boot medium is not updated after network installer - bug 2703 +- Boot medium is not updated after network installer - (https://bugs.linaro.org/show_bug.cgi?id=2703 "bug 2703") ### Cavium (ThunderX) -- UEFI boot entry not created after Debian installer finished - bug 2736 +- UEFI boot entry not created after Debian installer finished - (https://bugs.linaro.org/show_bug.cgi?id=2736 "bug 2736") From 32f73fda26be80af1d8c4a6a47c8d1838aee24e8 Mon Sep 17 00:00:00 2001 From: Tyler Baker Date: Wed, 21 Dec 2016 15:23:57 -0800 Subject: [PATCH 047/114] Release Notes: remove github url markdown for bugs --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 4f99294..db2594c 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -58,14 +58,14 @@ ### D03: - Only 16 cores enabled (instead of 32) - bug 2635 -- Fails to install/boot Debian/CentOS with the default boot argument - (https://bugs.linaro.org/show_bug.cgi?id=2661 "bug 2661") -- Earlycon not working (no console output) - (https://bugs.linaro.org/show_bug.cgi?id=2699 "bug 2699") +- Fails to install/boot Debian/CentOS with the default boot argument - https://bugs.linaro.org/show_bug.cgi?id=2661 +- Earlycon not working (no console output) - https://bugs.linaro.org/show_bug.cgi?id=2699 ### HP-m400 Moonshot: -- Boot medium is not updated after network installer - (https://bugs.linaro.org/show_bug.cgi?id=2703 "bug 2703") +- Boot medium is not updated after network installer - https://bugs.linaro.org/show_bug.cgi?id=2703 ### Cavium (ThunderX) -- UEFI boot entry not created after Debian installer finished - (https://bugs.linaro.org/show_bug.cgi?id=2736 "bug 2736") +- UEFI boot entry not created after Debian installer finished - https://bugs.linaro.org/show_bug.cgi?id=2736 From 045ec8e7350bd131c618c0071f86a3ce756fbd6c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:32:41 -0800 Subject: [PATCH 048/114] Added list of hardware for download pages Signed-off-by: Robert Wolff --- .../Installation/Firmware/Download.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md new file mode 100644 index 0000000..b998fb0 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md @@ -0,0 +1,17 @@ + + + + + + + +
UEFI/EDK2
Go Back		Download
Get the latest pre-built firmware images + 		Build
Instructions for building latest firmware images		Install
Instructions on how to install firmware		Read more
Learn more about UEFI/EDK2
+ +## Choose your Hardware + +- [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/uefi/) +- [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/uefi/) +- [OverDrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/uefi/) + +If you hardware is not listed here, please proceed to [Install](Install.md) page From 56154a9456a17ea6e6ceda6f126c32c3ca7360ce Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:33:17 -0800 Subject: [PATCH 049/114] Added download lin Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md index 4a0c6ff..d7de928 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/README.md @@ -1,7 +1,7 @@ - + - From 3fe307c5904cf68458c2b7dd542572f494943b22 Mon Sep 17 00:00:00 2001 From: Fathi Boudra Date: Wed, 18 Jan 2017 09:47:51 +0200 Subject: [PATCH 082/114] Fix CentOS base version --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index d0e5d6e..5066bf5 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -18,7 +18,7 @@ ## CentOS -- Network Installer based on CentOS 7.2 16.03 +- Network Installer based on CentOS 7.2.1603 - Unified Reference Platform Kernel based on 4.9 ## Enterprise Components From 0dcb75b531d5c64e13e0178e7922b9416e8c1353 Mon Sep 17 00:00:00 2001 From: Gema Gomez Date: Wed, 18 Jan 2017 15:48:17 +0000 Subject: [PATCH 083/114] Adding last changes to the OpenStack documentation for ERP 16.12 --- .../Platforms/Enterprise/OpenStack/README.md | 8 ++- .../Enterprise/OpenStack/docs/architecture.md | 57 +++++++++++++++++++ 2 files changed, 62 insertions(+), 3 deletions(-) create mode 100644 Reference-Platform/Platforms/Enterprise/OpenStack/docs/architecture.md diff --git a/Reference-Platform/Platforms/Enterprise/OpenStack/README.md b/Reference-Platform/Platforms/Enterprise/OpenStack/README.md index f7167b9..86a0e6f 100644 --- a/Reference-Platform/Platforms/Enterprise/OpenStack/README.md +++ b/Reference-Platform/Platforms/Enterprise/OpenStack/README.md @@ -8,7 +8,7 @@ Cloud". The OpenStack packages are built by Linaro and made available in the following location: -TBD +http://repo.linaro.org/rpm/linaro-overlay/centos-7/repo The build scripts for the packages are available in this repository on the `openstack-venvs` folder. These scripts are provided on as is basis, and they @@ -17,7 +17,9 @@ own risk. # Reference Architecture -The reference architecture deploys a cloud that uses Ceph as backend for OpenStack. +The reference architecture deploys a cloud that uses Ceph as backend for OpenStack: + +[https://git.linaro.org/leg/sdi/openstack-ref-architecture.git](https://git.linaro.org/leg/sdi/openstack-ref-architecture.git) See block diagram of how the servers should be connected to the network and how to spread the services on the different hosts on a default configuration in the [architecture document](docs/architecture.md). @@ -25,7 +27,7 @@ spread the services on the different hosts on a default configuration in the [ar # Pre-requisites -1. All the servers are supposed to have CentOS or Debian installed and they are supposed to +1. All the servers are supposed to have Linaro ERP 16.12 installed and they are supposed to have networking configured in a way that they can see/resolve each other's names. 1. The nodes that will be used as Ceph OSDs need to have at least one extra harddrive for Ceph. diff --git a/Reference-Platform/Platforms/Enterprise/OpenStack/docs/architecture.md b/Reference-Platform/Platforms/Enterprise/OpenStack/docs/architecture.md new file mode 100644 index 0000000..ba95e26 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/OpenStack/docs/architecture.md @@ -0,0 +1,57 @@ +# Network Diagram + +This diagram is orientative to show how the physical networks +are expected to be set up. + +The two networks are physical networks segmented between 2 different VLANS. The +internal network is a traditional lab internal network that all the servers can +see. The openstack services will communicate with each other on this +fairly safe network. Outbound traffic on this network is routed through the +external router. + +The "VMS NET" is a 2nd VLAN (can be same or different physical switch). +This network is private with no outbound routes. The compute nodes and the +network node talk over this network using VXLAN to provide private virtualized +networks defined and managed by OpenStack. The network node as a single interface +bridged to the public internet and a range of public IPv4 addresses that can +be assigned as floating IPs to expose VMs to the internet. + +``` ++---+ +---------------------------------+ +---+ +| V | | +--------+ I | +| M | | control-node-1 |eth0 | N | +| S | | mysql, rabbit, ceph-mon | | T | +| | | | | E | +| N | +---------------------------------+ | R +-----+ +| E | | N | |eth0 +| T | +---------------------------------+ | A | +---------------+ +| | | +--------+ L | | | +| | | control-node-2 |eth0 | | | External | +| | | keystone, glance, memcached, | | N | | router | +| | | nova(api etc), neutron-server, | | E | | | +| 1 | | horizon, cinder, ceph-mon | | T | +---------------+ +| 9 | | | | W | |eth1 +| 2 | +---------------------------------+ | O | | +| . | | R | | +| 1 | +---------------------------------+ | K | | +| 6 | | +--------+ | | +| 8 | | control-node-3 |eth0 | | | +| . | | openvswitch_agent, l3_agent, | | | | +| 0 | eth1| dhcp_agent, metadata_agent |eth2 |10 | | +| . +--------+ ceph-mon |__ | . | | +| X | +---------------------------------+ \ |10 | | +| | \___/| . |- | +| | +---------------------------------+ | X | \ \ XXXXX +| | | +--------+ . | \ XXXX X +| | | compute-$X |eth0 | X | \ XX XX +| | eth1| nova-compute, ceph-osd | | | \XX XXX +| +--------+ neutron-openvswitch_agent | | | X Internet X +| | +---------------------------------+ | | XX XXX +| | | | XXXXXXXXXXX +| | +---------------------------------+ | | +| | | +--------+ | +| | | compute-$X |eth0 | | +| | eth1| nova-compute, ceph-osd | | | +| +--------+ neutron-openvswitch_agent | | | ++---+ +---------------------------------+ +---+ +``` From 318c4ee455c6f8845bbfc7cf8303ff49f5162455 Mon Sep 17 00:00:00 2001 From: Ganesh Raju Date: Wed, 18 Jan 2017 15:25:09 -0600 Subject: [PATCH 084/114] Big Data component Installation instructions --- Reference-Platform/Platforms/Enterprise/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index ff16e48..903443c 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -10,6 +10,8 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is - Installation and build instructions for a variety of your Reference Platform components - [OpenStack](OpenStack/README.md) - This section provides all the support code required to deploy a "Developer Cloud" +- [BigData](BigData/README.md) + - Installation instructions for Big Data Components. i.e., Hadoop, Spark and Hive - [Support](Support/README.md) - From bug reports and current issues, to forum access and other useful resources, we want to help you find answers From b63c6e8bd65947ebf3366b9e35398d8927b1327e Mon Sep 17 00:00:00 2001 From: Ganesh Raju Date: Wed, 18 Jan 2017 15:28:26 -0600 Subject: [PATCH 085/114] Add README.md --- .../Platforms/Enterprise/BigData/README.md | 669 ++++++++++++++++++ 1 file changed, 669 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/BigData/README.md diff --git a/Reference-Platform/Platforms/Enterprise/BigData/README.md b/Reference-Platform/Platforms/Enterprise/BigData/README.md new file mode 100644 index 0000000..39ecd88 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/BigData/README.md @@ -0,0 +1,669 @@ +# Big Data + +This file provides all the instructions required to install Big Data components - Hadoop, Spark and Hive + +# Big Data packages + +The following Big data components are built as part of Linaro's Reference Architecture + +* Hadoop 2.7.2 +* Spark 2.0 +* Hive 2.0.1 + +These components were built using Apache BigTop 1.1 and uses ODPi's code base. + + +# About ODPi + +Check out the website https://www.odpi.org/ + +# Prerequisites + +Java 8 (e.g. openjdk-8-jre) installed + +# Linaro Repo + +The package is available at the following repo: + +Debian Jessie - http://repo.linaro.org/debian/erp-16.12-stable/ +CentOS 7 - http://repo.linaro.org/rpm/linaro-overlay/centos-7/repo + +# Installation + +## For Ubuntu + +Add to repo source list (not required if you are using the installer from the Reference Platform): + + $ echo "deb http://repo.linaro.org/debian/erp-16.12-stable/ jessie main" | sudo tee /etc/apt/sources.list.d/linaro-overlay-repo.list + + +Update the source list and install the dependencies: + + $ sudo apt-get update + $ sudo apt-get build-dep build-essential + + +Check Java version + + java -version + +This should print out OpenJDK8. + +Install Hadoop, Spark and Hive + + $ sudo apt-get install -ft jessie bigtop-tomcat bigtop-utils hadoop* spark-core zookeeper ^hive-* hbase oozie + +## For Centos: + +Add to repo source list (not required if you are using the installer from the Reference Platform): + + $ sudo wget http://repo.linaro.org/rpm/linaro-staging/centos-7/linaro-staging.repo -O /etc/yum.repos.d/linaro-overlay.repo + +Update the source list and install the dependencies + + $ sudo yum update + $ sudo yum -y install openssh-server openssh-clients java-1.8.0-openjdk* + + +Install Hadoop, Spark and Hive + + $ sudo yum install -y hadoop* spark* hive* + +# Verifying Hadoop Installation + +Packages would get installed in /usr/lib + +Type hadoop to check if hadoop is installed. + + $ hadoop + +And you should see the following: + + "linaro@debian:~$ hadoop Usage: hadoop [--config confdir] COMMAND where COMMAND is one of: + + fs run a generic filesystem user client version print the version jar run a jar file checknative [-a|-h] check native hadoop and compression libraries availability distcp copy file or directories recursively archive -archiveName NAME -p * create a hadoop archive classpath prints the class path needed to get the credential interact with credential providers + Hadoop jar and the required libraries + daemonlog get/set the log level for each daemon trace view and modify Hadoop tracing settings + or CLASSNAME run the class named CLASSNAME + + Most commands print help when invoked w/o parameters. " + +# Setup, Configuration and Running Hadoop + +## Add Hadoop User + +We need to create a dedicated user (hduser) for running Hadoop. This user needs to be added to hadoop user group: + + $ sudo adduser hduser -G hadoop + +give a password for hduser + + $ sudo passwd hduser + +Add hduser to sudoers list: + +On Debian: + + $ sudo adduser hduser sudo + +On CentOS: + + $ sudo usermod -G wheel hduser + +Switch to hduser + + $ su - hduser + +Generate ssh key for hduser + + $ ssh-keygen -t rsa -P "" + +Press to leave to default file name. +Enable ssh access to local machine + + $ cat $HOME/.ssh/id_rsa.pub >> $HOME/.ssh/authorized_keys + $ chmod 600 $HOME/.ssh/authorized_keys + $ chmod 700 $HOME/.ssh + +Test ssh setup + + $ ssh localhost + $ exit + +## Disabling IPv6 + + $ sudo vi /etc/sysctl.conf + +add the below lines and save + + net.ipv6.conf.all.disable_ipv6 = 1 + net.ipv6.conf.default.disable_ipv6 = 1 + net.ipv6.conf.lo.disable_ipv6 = 1 + +Prefer IPv4 on Hadoop: + + $ sudo vi /etc/hadoop/conf/hadoop-env.sh + +uncomment line + + export HADOOP_OPTS=-Djava.net.preferIPV4stack=true + +Run sysctl to apply the changes: + + $ sudo sysctl -p + +## Configuring the app environment + +Back to the system, we need to configure the app environment by following steps: + + $ sudo mkdir -p /app/hadoop/tmp + $ sudo chown hduser:hadoop /app/hadoop/tmp + $ sudo chmod 750 /app/hadoop/tmp + $ sudo chown hduser:hadoop /usr/lib/hadoop + $ sudo chmod 750 /usr/lib/hadoop + +## Setting up Environment Variables + +Follow the below steps to setup Environment Variables in bash file : + + $ vi .bashrc + +Add the following to the end and save: + + export HADOOP_HOME=/usr/lib/hadoop + export HADOOP_PREFIX=$HADOOP_HOME + export HADOOP_OPTS="-Djava.library.path=$HADOOP_PREFIX/lib/native" + export HADOOP_LIBEXEC_DIR=/usr/lib/hadoop/libexec + export HADOOP_CONF_DIR=/etc/hadoop/conf + export HADOOP_COMMON_LIB_NATIVE_DIR=$HADOOP_HOME/lib/native + export HADOOP_COMMON_HOME=$HADOOP_HOME + export HADOOP_MAPRED_HOME=/usr/lib/hadoop-mapreduce + export HADOOP_HDFS_HOME=/usr/lib/hadoop-hdfs + export YARN_HOME=/usr/lib/hadoop-yarn + export HADOOP_YARN_HOME=/usr/lib/hadoop-yarn/ + export HADOOP_USER_NAME=hdfs + export CLASSPATH=$CLASSPATH:. + export CLASSPATH=$CLASSPATH:$HADOOP_HOME/hadoop-common-2.7.2.jar:$HADOOP_HOME/client/hadoop-hdfs-2.7.2.jar:$HADOOP_HOME/hadoop-auth-2.7.2.jar:/usr/lib/hadoop-mapreduce/*:/usr/lib/hive/lib/*:/usr/lib/hadoop/lib/*: + export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::") + export PATH=/usr/lib/hadoop/libexec:/etc/hadoop/conf:$HADOOP_HOME/bin/:$PATH + + $ source .bashrc + +## Modifying config files + +### core-site.xml + + $ sudo vi /etc/hadoop/conf/core-site.xml + +And add/modify the following settings: Look for property with fs.defaultFS and modify as below: + + + fs.default.name + hdfs://localhost:54310 + The name of the default file system. A URI whose + scheme and authority determine the FileSystem implementation. The + uri's scheme determines the config property (fs.SCHEME.impl) naming + the FileSystem implementation class. The uri's authority is used to + determine the host, port, etc. for a filesystem. + + + +Add this to the bottom before tag: "" + + + hadoop.tmp.dir + /app/hadoop/tmp + A base for other temporary directories. + + +### mapred-site.xml + + $ sudo vi /etc/hadoop/conf/mapred-site.xml + +Modify existing properties as follows: Look for property tag with as mapred.job.tracker and modify as below: + + + mapred.job.tracker + localhost:54311 + The host and port that the MapReduce job tracker runs + at. If "local", then jobs are run in-process as a single map + and reduce task. + + + +### hdfs-site.xml + + $ sudo vi /etc/hadoop/conf/hdfs-site.xml + +Modify existing property as below: + + + dfs.replication + 1 + Default block replication. The actual number of replications can be specified when the file is created. The default is used if replication is not specified in create time. + + + + +Make sure the following properties are set correctly as below in hdfs-site.xml + + + hadoop.tmp.dir + /var/lib/hadoop-hdfs/cache/${user.name} + + + + + dfs.namenode.name.dir + /var/lib/hadoop-hdfs/cache/${user.name}/dfs/name + + + + dfs.namenode.checkpoint.dir + /var/lib/hadoop-hdfs/cache/${user.name}/dfs/namesecondary + + + + dfs.datanode.data.dir + /var/lib/hadoop-hdfs/cache/${user.name}/dfs/data + + + +Make sure the following properties are also present: + + + dfs.name.dir + /var/lib/hadoop-hdfs/cache/${user.name}/dfs/nn + + + + dfs.data.dir + /var/lib/hadoop-hdfs/cache/${user.name}/dfs/dn + + + + + dfs.permissions.supergroup + hadoop + + +## Format Namenode + +This step is needed for the first time. Doing it every time will result in loss of content on HDFS. + + $ sudo /etc/init.d/hadoop-hdfs-namenode init + +## Start the YARN daemons + + $ for i in hadoop-hdfs-namenode hadoop-hdfs-datanode ; do sudo service $i start ; done + + $ sudo /etc/init.d/hadoop-yarn-resourcemanager start + $ sudo /etc/init.d/hadoop-yarn-nodemanager start + +## Validating Hadoop + +Check if hadoop is running. jps command should list namenode, datanode, yarn resource manager. or use ps aux + + $ sudo jps + +or + + $ ps aux | grep java + + +Alternatively, check if yarn managers are running: + + $ sudo /etc/init.d/hadoop-yarn-resourcemanager status + $ sudo /etc/init.d/hadoop-yarn-nodemanager status + +You would see like below: + + " ● hadoop-yarn-nodemanager.service - LSB: Hadoop nodemanager + Loaded: loaded (/etc/init.d/hadoop-yarn-nodemanager) Active: active (running) since Tue 2015-12-22 18:25:03 UTC; 1h 24min ago CGroup: /system.slice/hadoop-yarn-nodemanager.service └─10366 /usr/lib/jvm/java-1.8.0-openjdk-arm64/bin/java -Dproc_node... + + + + Dec 22 18:24:57 debian su[10348]: Successful su for yarn by root Dec 22 18:24:57 debian su[10348]: + ??? root:yarn Dec 22 18:24:57 debian su[10348]: pam_unix(su:session): session opened for ...0) Dec 22 18:24:57 debian hadoop-yarn-nodemanager[10305]: starting nodemanager, ... Dec 22 18:24:58 debian su[10348]: pam_unix(su:session): session closed for ...rn Dec 22 18:25:03 debian hadoop-yarn-nodemanager[10305]: Started Hadoop nodeman... " + +## Run teragen, terasort and teravalidate + + $ hadoop jar /usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar teragen 1000000 terainput + $ hadoop jar /usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar terasort terainput teraoutput + $ hadoop jar /usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar teravalidate -D mapred.reduce.tasks=8 teraoutput teravalidate + +## Run a demo application to verify installation + + $ mkdir in + $ cat > in/file << EOFThis is one line + This is another one + EOF + +Add this directory to HDFS: + + $ hadoop dfs -copyFromLocal in /in + +## Run wordcount example provided + + $ hadoop jar /usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar wordcount /in /out + +Check the output + + $ hadoop dfs -cat /out/* + +## Web Interface + +* http://master:50070/dfshealth.jsp +* http://master:8088/cluster +* http://master:19888/jobhistory (for Job History Server) + +## Stop the Hadoop Services + + $ sudo /etc/init.d/hadoop-yarn-nodemanager stop + $ sudo /etc/init.d/hadoop-yarn-resourcemanager stop + $ for i in hadoop-hdfs-namenode hadoop-hdfs-datanode ; do sudo service $i stop; done + +# SPARK + +'NOTE:' Make sure you have followed above steps to set up Hadoop. +Change to hduser + + $ su - hduser + +## Configuring Spark + + export HADOOP_HOME=/usr/lib/hadoop + export HADOOP_PREFIX=$HADOOP_HOME + export HADOOP_OPTS="-Djava.library.path=$HADOOP_PREFIX/lib/native" + export HADOOP_LIBEXEC_DIR=/usr/lib/hadoop/libexec + export HADOOP_CONF_DIR=/etc/hadoop/conf + export HADOOP_COMMON_LIB_NATIVE_DIR=$HADOOP_HOME/lib/native + export HADOOP_COMMON_HOME=$HADOOP_HOME + export HADOOP_MAPRED_HOME=/usr/lib/hadoop-mapreduce + export HADOOP_HDFS_HOME=/usr/lib/hadoop-hdfs + export YARN_HOME=/usr/lib/hadoop-yarn + export HADOOP_YARN_HOME=/usr/lib/hadoop-yarn/ + export HADOOP_USER_NAME=hdfs + export CLASSPATH=$CLASSPATH:. + export CLASSPATH=$CLASSPATH:$HADOOP_HOME/hadoop-common-2.7.2.jar:$HADOOP_HOME/client/hadoop-hdfs-2.7.2.jar:$HADOOP_HOME/hadoop-auth-2.7.2.jar:/usr/lib/hadoop-mapreduce/*:/usr/lib/hive/lib/*:/usr/lib/hadoop/lib/*: + export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::") + export PATH=/usr/lib/hadoop/libexec:/etc/hadoop/conf:$HADOOP_HOME/bin/:$PATH + export SPARK_HOME=/usr/lib/spark + export PATH=$HADOOP_HOME\bin:$PATH + export SPARK_DIST_CLASSPATH=$HADOOP_HOME\bin\hadoop:$CLASSPATH:/usr/lib/hadoop/lib/*:/usr/lib/hadoop/lib/*:/usr/lib/hadoop-mapreduce/*:. + export CLASSPATH=$CLASSPATH:/usr/lib/hadoop/lib/*:. + + + $ source .bashrc + +## Verifying Spark Installation + + $ $SPARK_HOME/bin/spark-shell --master local[*] + +## Running SparkPi Example + +Once Spark is built successfully, try running the following pi example to calculate value of pi. The number at the end of the command is the number of splits. If needed, you can increase this number to stress out the CPU. + + $ $SPARK_HOME/bin/run-example SparkPi 100 + +# HIVE + +## Setting up environment for Hive + +You can set up the Hive environment by appending the following lines to ~/.bashrc file: + + export HADOOP_HOME=/usr/lib/hadoop + export HADOOP_PREFIX=$HADOOP_HOME + export HADOOP_OPTS="-Djava.library.path=$HADOOP_PREFIX/lib/native" + export HADOOP_LIBEXEC_DIR=/usr/lib/hadoop/libexec + export HADOOP_CONF_DIR=/etc/hadoop/conf + export HADOOP_COMMON_LIB_NATIVE_DIR=$HADOOP_HOME/lib/native + export HADOOP_COMMON_HOME=$HADOOP_HOME + export HADOOP_MAPRED_HOME=/usr/lib/hadoop-mapreduce + export HADOOP_HDFS_HOME=/usr/lib/hadoop-hdfs + export YARN_HOME=/usr/lib/hadoop-yarn + export HADOOP_YARN_HOME=/usr/lib/hadoop-yarn/ + export HADOOP_USER_NAME=hdfs + export CLASSPATH=$CLASSPATH:. + export CLASSPATH=$CLASSPATH:$HADOOP_HOME/hadoop-common-2.7.2.jar:$HADOOP_HOME/client/hadoop-hdfs-2.7.2.jar:$HADOOP_HOME/hadoop-auth-2.7.2.jar:/usr/lib/hive/lib/*:/usr/lib/hadoop/lib/*:. + export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::") + export PATH=/usr/lib/hadoop/libexec:/etc/hadoop/conf:$HADOOP_HOME/bin/:$PATH + export PATH=$HADOOP_HOME\bin:$PATH + export HIVE_HOME=/usr/lib/hive + export PATH=$PATH:$HIVE_HOME/bin + +The following command is used to execute ~/.bashrc file. + + $ source ~/.bashrc + +## Configuring hive + +To configure Hive with Hadoop, you need to edit the hive-env.sh file, which is placed in the $HIVE_HOME/conf directory. The following commands redirect to Hive config folder and copy the template file: + + $ cd $HIVE_HOME/conf + $ sudo cp hive-env.sh.template hive-env.sh + +Hive installation is completed successfully. Now you require an external database server to configure Metastore. We use Apache Derby database. + +## Downloading and Installing Apache Derby + +Follow the steps given below to download and install Apache Derby: + +## Downloading Apache Derby + +The following command is used to download Apache Derby. It takes some time to download. + + $ cd ~ + $ wget http://archive.apache.org/dist/db/derby/db-derby-10.4.2.0/db-derby-10.4.2.0-bin.tar.gz + + +The following command is used to verify the download: + + $ ls + +On successful download, you get to see the following response: + + db-derby-10.4.2.0-bin.tar.gz + +## Extracting and verifying Derby archive + +The following commands are used for extracting and verifying the Derby archive: + + $ tar zxvf db-derby-10.4.2.0-bin.tar.gz + $ ls + + +On successful download, you get to see the following response: + + db-derby-10.4.2.0-bin + db-derby-10.4.2.0-bin.tar.gz + +Copy the files from the extracted directory to the /usr/local/derby directory: + + $ sudo mv db-derby-10.4.2.0-bin /usr/local/derby + +## Setting up Environment for Derby + +Set up the Derby environment by appending the following lines to ~/.bashrc file: + + $ vi .bashrc + + export DERBY_HOME=/usr/local/derby + export PATH=$PATH:$DERBY_HOME/bin + export CLASSPATH=$CLASSPATH:$DERBY_HOME/lib/derby.jar:$DERBY_HOME/lib/derbytools.jar + +The following command is used to execute ~/.bashrc file: + + export DERBY_HOME=/usr/local/derby + export PATH=$PATH:$DERBY_HOME/bin + export CLASSPATH=$CLASSPATH:$DERBY_HOME/lib/derby.jar:$DERBY_HOME/lib/derbytools.jar + + $ source ~/.bashrc + +### Create a directory to store Metastore + +Create a directory named data in $DERBY_HOME directory to store Metastore data. + + $ sudo mkdir $DERBY_HOME/data + +Derby installation and environmental setup is now complete. + +## Configuring Metastore of Hive + +Configuring Metastore means specifying to Hive where the database is stored. You can do this by editing the hive-site.xml file, which is in the $HIVE_HOME/conf directory. First of all, copy the template file using the following command: + + $ cd $HIVE_HOME/conf + $ sudo cp hive-default.xml.template hive-site.xml + +Edit hive-site.xml and find entry 'javax.jdo.option.ConnectionURL' and modifiy the value as below: + + hive.exec.scratchdir + /tmp/hive-${user.name} + + hive.exec.local.scratchdir + /tmp/${user.name} + + hive.downloaded.resources.dir + /tmp/${user.name}_resources + + hive.scratch.dir.permission + 733 + +and change the values for the below properties like below: + + + javax.jdo.option.ConnectionURL + jdbc:derby:;databaseName=/usr/lib/hive/tmp/metastore_db;create=true + JDBC connect string for a JDBC metastore + + +Create a file named jpox.properties and add the following lines into it: + + $ sudo vi jpox.properties + + + javax.jdo.PersistenceManagerFactoryClass = + + org.jpox.PersistenceManagerFactoryImpl + org.jpox.autoCreateSchema = false + org.jpox.validateTables = false + org.jpox.validateColumns = false + org.jpox.validateConstraints = false + org.jpox.storeManagerType = rdbms + org.jpox.autoCreateSchema = true + org.jpox.autoStartMechanismMode = checked + org.jpox.transactionIsolation = read_committed + javax.jdo.option.DetachAllOnCommit = true + javax.jdo.option.NontransactionalRead = true + javax.jdo.option.ConnectionDriverName = org.apache.derby.jdbc.ClientDriver + javax.jdo.option.ConnectionURL = jdbc:derby://hadoop1:1527/metastore_db;create = true + javax.jdo.option.ConnectionUserName = APP + javax.jdo.option.ConnectionPassword = mine + +## Verifying Hive Installation + +Before running Hive, you need to create the /tmp folder and a separate Hive folder in HDFS. Here, we use the /user/hive/warehouse folder. You need to set write permission for these newly created folders as shown below: + +Make sure you are using hduser account. If not switch to hduser. + + $ su - hduser + +Now set them in HDFS before verifying Hive. Use the following commands: + + $ $HADOOP_HOME/bin/hadoop fs -mkdir /tmp + $ $HADOOP_HOME/bin/hadoop fs -mkdir -p /user/hive/warehouse + $ $HADOOP_HOME/bin/hadoop fs -chmod g+w /tmp + $ $HADOOP_HOME/bin/hadoop fs -chmod g+w /user/hive/warehouse + +'NOTE:' Before invoking hive make sure you have followed above instructions in installing and setting up Hadoop. Make sure hadoop services are running. + +Run Hive metastore service + + $ sudo service hive-metastore start + $ sudo $HIVE_HOME/bin/metatool -listFSRoot + +Create tmp directory to run Hive under. + + $ cd $HIVE_HOME + $ sudo mkdir tmp + $ sudo chown hduser tmp + $ cd tmp + +The following commands are used to verify Hive installation: + + $ $HIVE_HOME/bin/schematool -dbType derby -initSchema + $ hive -hiveconf hive.root.logger=DEBUG,console + +On successful installation of Hive, you get to see the following response: + + Logging initialized using configuration in jar:file:/home/hadoop/hive-0.9.0/lib/hive-common-0.9.0.jar!/hive-log4j.properties + Hive history file=/tmp/hadoop/hive_job_log_hadoop_201312121621_1494929084.txt + …………………. + hive> + +The following sample command is executed to display all the tables: + + hive> show tables; + OK + Time taken: 2.798 seconds + hive> + + +# Errors / Issues and Resolutions + +* If after creating hduser, trying to switch to hduser ( || $ su - hduser || ) gave the following error: + +/* ‘No directory, logging in with HOME=/ # + +Then do the following: +Exit to root user delete the hduser and recreate it. + + $ exit + $ sudo userdel hduser + $ sudo useradd -d /home/hduser -G hadoop -m hduser + +* If Teragen, TeraSort and TeraValidate error out with 'permission denied' exception. The following steps can be done: + + $ sudo groupadd supergroup + $ sudo usermod -g supergroup hduser + +* If for some weird reason, if you notice the config files (core-site.xml, hdfs-site.xml, etc) are empty. + +You may have delete all the packages and re-run the steps of installation from scratch. + + /* Error while formatting namenode With the following command: + + $ sudo /etc/init.d/hadoop-hdfs-namenode init + +* If you see the following error: WARN net.DNS: Unable to determine local hostname -falling back to "localhost" java.net.UnknownHostException: centos: centos at java.net.InetAddress.getLocalHost(InetAddress.java:1496) at org.apache.hadoop.net.DNS.resolveLocalHostname(DNS.java:264) at org.apache.hadoop.net.DNS.(DNS.java:57) + +Something is wrong in the network setup. Please check /etc/hosts file. + + $ sudo vi /etc/hosts + +The hosts file should like below: + + 127.0.0.1 localhost localhost.localdomain #hostname should have the output of $ hostname + + ::1 localhost + +Also try the following steps: + + $ sudo rm -Rf /app/hadoop/tmp + $ hadoop namenode -format + +* If you see the below error with Hive while doing 'schematool -initSchema -dbType derby': + + 'Error:' FUNCTION 'NUCLEUS_ASCII' already exists. (state=X0Y68,code=30000) org.apache.hadoop.hive.metastore.HiveMetaException: Schema initialization FAILED! Metastore state would be inconsistent !! Underlying cause: java.io.IOException : Schema script failed, errorcode 2 Use --verbose for detailed stacktrace. *** schemaTool failed *** + +Following actions need to be taken to resolve: + + $ cd $HIVE_HOME/tmp + mv metastore_db metastore_db.tmp + ../bin/schematool -initSchema -dbType derby + + +* If you get the following error with Hive: + + Error: Cannot get a connection, pool error Could not create a validated object, cause: A read-only user or a user in a read-only database is not permitted to disable read-only mode on a connection. org.datanucleus.exceptions.NucleusDataStoreException: Cannot get a connection, pool error Could not create a validated object, cause: A read-only user or a user in a read-only database is not permitted to disable read-only mode on a connection. + +Resolution is: delete all .lck files in $HIVE_HOME/tmp directory \ No newline at end of file From 263c3f422bb29686abbc2b857295adf24f0b3cf5 Mon Sep 17 00:00:00 2001 From: Alan Bennett Date: Thu, 19 Jan 2017 15:27:16 -0800 Subject: [PATCH 086/114] Update ReleaseNotes.md --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 5066bf5..8ef8098 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -36,7 +36,7 @@ - HiSilicon D05 - APM X-Gene Mustang - HP Proliant m400 -- Qualcomm Q2432 +- Qualcomm QDF2432 Software Development Platform (SDP) - Cavium Thunder X ## Known Issues @@ -69,7 +69,7 @@ - [2720](https://bugs.linaro.org/show_bug.cgi?id=2720) CentOS/Debian: CONFIG_ARM64_VA_BITS=48 breaks userspace - [2351](https://bugs.linaro.org/show_bug.cgi?id=2351) LTP: openat03 TBROK errno=EINVAL(22) Invalid argument -### QDF2432: +### Qualcomm QDF2432 Software Development Platform (SDP): - [2663](https://bugs.linaro.org/show_bug.cgi?id=2663) Debian: 'qemu-sys - tem-aarch64 -cpu host' causes host reboot - [2646](https://bugs.linaro.org/show_bug.cgi?id=2646) LTP: Kernel crashes in syscalls/ipc/msgctl10 test From 436f7df8c0381170a90db1403db61aa7bdd002b4 Mon Sep 17 00:00:00 2001 From: vchong Date: Sun, 22 Jan 2017 18:53:01 +0900 Subject: [PATCH 087/114] RPB1606: CE: HiKey: InstallDebianRPB: Add header number for LeMaker --- .../RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md index d14bb67..20b2af5 100644 --- a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md +++ b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md @@ -205,7 +205,7 @@ This section show how to install the Linaro based Debian operating system to you If you are still having trouble setting up fastboot, click here for a short tutorial video -2 - **Boot HiKey into Fastboot mode using J15 header** +2 - **Boot HiKey into Fastboot mode using J601 (LeMaker) / J15 (CircuitCo) header** - Link pins 1 and 2 - Link pins 5 and 6 From 4bf54f31c9302a051fbe316d12e898ffafae3bf9 Mon Sep 17 00:00:00 2001 From: Fathi Boudra Date: Wed, 25 Jan 2017 07:35:00 +0200 Subject: [PATCH 088/114] Add a link to openstack-venvs --- Reference-Platform/Platforms/Enterprise/OpenStack/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/OpenStack/README.md b/Reference-Platform/Platforms/Enterprise/OpenStack/README.md index 86a0e6f..5ea8162 100644 --- a/Reference-Platform/Platforms/Enterprise/OpenStack/README.md +++ b/Reference-Platform/Platforms/Enterprise/OpenStack/README.md @@ -11,7 +11,7 @@ location: http://repo.linaro.org/rpm/linaro-overlay/centos-7/repo The build scripts for the packages are available in this repository on the -`openstack-venvs` folder. These scripts are provided on as is basis, and they +[`openstack-venvs`](https://git.linaro.org/leg/sdi/openstack-ref-architecture.git/tree/openstack-venvs) folder. These scripts are provided on as is basis, and they are tailored specifically for Linaro's building environment. Use only at your own risk. From c62c7e7cc3f8a2ff16d16e833b88434ca58c17ad Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:03:51 -0800 Subject: [PATCH 089/114] Remove getting started section Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 903443c..93e1ab8 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -4,8 +4,6 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is ## Contents -- [Getting Started](GettingStarted/README.md) - - Learn more about the Enterprise Reference Platform, this is an ideal place to start. - [Installation](Installation/README.md) - Installation and build instructions for a variety of your Reference Platform components - [OpenStack](OpenStack/README.md) From d6cfb1ffcaf0d678fb021b2e3dc974ed94d1180a Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:16:53 -0800 Subject: [PATCH 090/114] Added one more level for ERP - description and forwarding Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/README.md | 26 +++++++------------ 1 file changed, 9 insertions(+), 17 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 93e1ab8..34c3d26 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -1,22 +1,14 @@ -# Enterprise Reference Platform - Documentation +# Enterprise Reference Platform -A comprehensive guide to using the Enterprise Reference Platform. This guide is written by the Linaro team with community contributions and links to third-party content. +The enterprise reference platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. For more information and support please visit the [ERP forum](https://discuss.linaro.org/c/erp). -## Contents +**Features:** -- [Installation](Installation/README.md) - - Installation and build instructions for a variety of your Reference Platform components -- [OpenStack](OpenStack/README.md) - - This section provides all the support code required to deploy a "Developer Cloud" -- [BigData](BigData/README.md) - - Installation instructions for Big Data Components. i.e., Hadoop, Spark and Hive -- [Support](Support/README.md) - - From bug reports and current issues, to forum access and other useful resources, we want to help you find answers +- Unified Linux Kernel +- Open Boot Firmware + - Compliant with ARM SBSA and SBBR specifications +- Debian and Centos Network Installers +- Openstack and Ceph Reference Deployments +- Built for Big Data Workloads *** - -#### Resources - -- [Release Notes](ReleaseNotes.md) -- [Previous Releases](PreviousReleases/README.md) -- [Document Contribution Policy](../../../ContributionPolicy.md) From 4366a7d7000dc9e59e5e53adf022754ab7822e59 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:18:10 -0800 Subject: [PATCH 091/114] Changed getting started to documentation Signed-off-by: Robert Wolff --- .../Enterprise/Documentation/README.md | 20 +++++++++++++ .../Enterprise/GettingStarted/README.md | 29 ------------------- 2 files changed, 20 insertions(+), 29 deletions(-) create mode 100644 Reference-Platform/Platforms/Enterprise/Documentation/README.md delete mode 100644 Reference-Platform/Platforms/Enterprise/GettingStarted/README.md diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/README.md new file mode 100644 index 0000000..57404f1 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Documentation/README.md @@ -0,0 +1,20 @@ +A comprehensive guide to using the Enterprise Reference Platform. This guide is written by the Linaro team with community contributions and links to third-party content. + +## Contents + +- [Installation](Installation/README.md) + - Installation and build instructions for a variety of your Reference Platform components +- [OpenStack](OpenStack/README.md) + - This section provides all the support code required to deploy a "Developer Cloud" +- [BigData](BigData/README.md) + - Installation instructions for Big Data Components. i.e., Hadoop, Spark and Hive +- [Support](Support/README.md) + - From bug reports and current issues, to forum access and other useful resources, we want to help you find answers + +*** + +#### Resources + +- [Release Notes](ReleaseNotes.md) +- [Previous Releases](PreviousReleases/README.md) +- [Document Contribution Policy](../../../ContributionPolicy.md) diff --git a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md deleted file mode 100644 index d075575..0000000 --- a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md +++ /dev/null @@ -1,29 +0,0 @@ -# Getting Started - -This page is designed to bring you up to speed with the Enterprise Reference Platform. You will find categorized information, links to additional resources, and paths forward to take you deeper into the platform. - -## Introduction - -The Enterprise Reference Platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. - -**Features:** - -- Unified Linux Kernel -- Open Boot Firmware - - Compliant with ARM SBSA and SBBR specifications -- Debian and Centos Network Installers -- Openstack and Ceph Reference Deployments -- Built for Big Data Workloads - -*** - -## Jump to... - -- [Approved Hardware](../Hardware/README.md) - - This is a list of all tested and approved Enterprise Reference Platform hardware -- [Installation](../Installation/README.md) - - From start to finish, set up your environment and install the Enterprise Reference Platform -- [OpenStack](../OpenStack/README.md) - - This section provides all the support code required to deploy a "Developer Cloud" -- [Support](../Support/README.md) - - Bug reports and current issues, forum access and other useful resources. We want to help you find answers From 5c804f3778b36f18bd68e6f3b0ad46aa6795c690 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:18:43 -0800 Subject: [PATCH 092/114] Added title for page Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Documentation/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/README.md index 57404f1..23c9285 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/README.md @@ -1,3 +1,5 @@ +# Enterprise Reference Platform - Documentation + A comprehensive guide to using the Enterprise Reference Platform. This guide is written by the Linaro team with community contributions and links to third-party content. ## Contents From 3a87a278755c4a018aafd539bd49807f7cbfd603 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:19:39 -0800 Subject: [PATCH 093/114] Changed some relative links Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Documentation/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/README.md index 23c9285..ddf0bf9 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/README.md @@ -17,6 +17,6 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is #### Resources -- [Release Notes](ReleaseNotes.md) -- [Previous Releases](PreviousReleases/README.md) -- [Document Contribution Policy](../../../ContributionPolicy.md) +- [Release Notes](../ReleaseNotes.md) +- [Previous Releases](../PreviousReleases/README.md) +- [Document Contribution Policy](../../../../ContributionPolicy.md) From 51beb7c2496aa7925f9bc9f0274f6c22c785ca91 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:20:59 -0800 Subject: [PATCH 094/114] Changed location to documentation folder Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/{ => Documentation}/BigData/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/BigData/README.md (99%) diff --git a/Reference-Platform/Platforms/Enterprise/BigData/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/BigData/README.md similarity index 99% rename from Reference-Platform/Platforms/Enterprise/BigData/README.md rename to Reference-Platform/Platforms/Enterprise/Documentation/BigData/README.md index 39ecd88..2d6ab52 100644 --- a/Reference-Platform/Platforms/Enterprise/BigData/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/BigData/README.md @@ -666,4 +666,4 @@ Following actions need to be taken to resolve: Error: Cannot get a connection, pool error Could not create a validated object, cause: A read-only user or a user in a read-only database is not permitted to disable read-only mode on a connection. org.datanucleus.exceptions.NucleusDataStoreException: Cannot get a connection, pool error Could not create a validated object, cause: A read-only user or a user in a read-only database is not permitted to disable read-only mode on a connection. -Resolution is: delete all .lck files in $HIVE_HOME/tmp directory \ No newline at end of file +Resolution is: delete all .lck files in $HIVE_HOME/tmp directory From 3637ac595604208dfd517e9cf4c00779ede407b5 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:22:11 -0800 Subject: [PATCH 095/114] Delete README.md --- Reference-Platform/Platforms/Enterprise/Downloads/README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 Reference-Platform/Platforms/Enterprise/Downloads/README.md diff --git a/Reference-Platform/Platforms/Enterprise/Downloads/README.md b/Reference-Platform/Platforms/Enterprise/Downloads/README.md deleted file mode 100644 index e69de29..0000000 From 77d8cfa8c9d750786e649c00af97a913db0c49e0 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:24:11 -0800 Subject: [PATCH 096/114] Changed location of hardware docs Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/{ => Documentation}/Hardware/README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Hardware/README.md (100%) diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/Hardware/README.md similarity index 100% rename from Reference-Platform/Platforms/Enterprise/Hardware/README.md rename to Reference-Platform/Platforms/Enterprise/Documentation/Hardware/README.md From 8a7f6c2cb56d12b2bcf7adbd086c1cfc4184a551 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:28:15 -0800 Subject: [PATCH 097/114] Moved folders around for new workflow Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/.DS_Store | Bin 0 -> 6148 bytes .../EECommon/DHCP-TFTP-Server-UEFI.md | 0 .../EECommon/Install-CentOS-7.md | 0 .../EECommon/Install-Debian-Jessie.md | 0 .../EECommon/Install-Fedora-23.md | 0 .../EECommon/ODPi-BigTop-Hadoop-Config-Run.md | 0 .../EECommon/ODPi-Hadoop-Installation.md | 0 .../EECommon/OpenStack-Liberty.md | 0 .../EECommon/UEFI-EDK2-Guide-EE.md | 0 .../Installation/Centos/README.md | 0 .../Installation/Debian/README.md | 0 .../Installation/Firmware/Build.md | 0 .../Installation/Firmware/Download.md | 0 .../Installation/Firmware/Install.md | 0 .../Installation/Firmware/README.md | 0 .../{ => Documentation}/Installation/README.md | 0 .../{ => Documentation}/OpenStack/README.md | 0 .../OpenStack/docs/architecture.md | 0 .../PreviousReleases/README.md | 0 .../RPB_15.12/EnterpriseEdition/README.md | 0 .../PreviousReleases/RPB_15.12/Highlights.md | 0 .../PreviousReleases/RPB_15.12/Known-Issues.md | 0 .../PreviousReleases/RPB_15.12/README.md | 0 .../RPB_16.03/EnterpriseEdition/Cello/README.md | 0 .../RPB_16.03/EnterpriseEdition/D02/README.md | 0 .../RPB_16.03/EnterpriseEdition/D03/README.md | 0 .../EnterpriseEdition/DHCP-TFTP-Server-UEFI.md | 0 .../EnterpriseEdition/HP-ProLiant-m400/README.md | 0 .../EnterpriseEdition/Install-CentOS-7.md | 0 .../EnterpriseEdition/Install-Debian-Jessie.md | 0 .../EnterpriseEdition/Install-Fedora-23.md | 0 .../ODPi-BigTop-Hadoop-Config-Run.md | 0 .../ODPi-Hadoop-Installation.md | 0 .../EnterpriseEdition/OpenStack-Liberty.md | 0 .../EnterpriseEdition/Overdrive/README.md | 0 .../RPB_16.03/EnterpriseEdition/README.md | 0 .../EnterpriseEdition/UEFI-EDK2-Guide-EE.md | 0 .../EnterpriseEdition/X-Gene-Mustang/README.md | 0 .../PreviousReleases/RPB_16.03/Highlights.md | 0 .../PreviousReleases/RPB_16.03/Known-Issues.md | 0 .../PreviousReleases/RPB_16.03/README.md | 0 .../RPB_16.03/ReleaseStatus-16.03.md | 0 .../RPB_16.06/EECommon/DHCP-TFTP-Server-UEFI.md | 0 .../RPB_16.06/EECommon/Install-CentOS-7.md | 0 .../RPB_16.06/EECommon/Install-Debian-Jessie.md | 0 .../RPB_16.06/EECommon/Install-Fedora-23.md | 0 .../EECommon/ODPi-BigTop-Hadoop-Config-Run.md | 0 .../EECommon/ODPi-Hadoop-Installation.md | 0 .../RPB_16.06/EECommon/OpenStack-Liberty.md | 0 .../RPB_16.06/EECommon/UEFI-EDK2-Guide-EE.md | 0 .../RPB_16.06/EnterpriseEdition/Cello/README.md | 0 .../RPB_16.06/EnterpriseEdition/D02/README.md | 0 .../RPB_16.06/EnterpriseEdition/D03/README.md | 0 .../EnterpriseEdition/HP-ProLiant-m400/README.md | 0 .../EnterpriseEdition/Overdrive/README.md | 0 .../EnterpriseEdition/Q2432LZB/README.md | 0 .../RPB_16.06/EnterpriseEdition/README.md | 0 .../EnterpriseEdition/ThunderX/README.md | 0 .../EnterpriseEdition/X-Gene-Mustang/README.md | 0 .../PreviousReleases/RPB_16.06/Highlights.md | 0 .../PreviousReleases/RPB_16.06/Known-Issues.md | 0 .../PreviousReleases/RPB_16.06/README.md | 0 .../{ => Documentation}/Support/README.md | 0 63 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 Reference-Platform/Platforms/Enterprise/.DS_Store rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/DHCP-TFTP-Server-UEFI.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/Install-CentOS-7.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/Install-Debian-Jessie.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/Install-Fedora-23.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/ODPi-BigTop-Hadoop-Config-Run.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/ODPi-Hadoop-Installation.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/OpenStack-Liberty.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/EECommon/UEFI-EDK2-Guide-EE.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/Centos/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/Debian/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/Firmware/Build.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/Firmware/Download.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/Firmware/Install.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/Firmware/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Installation/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/OpenStack/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/OpenStack/docs/architecture.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_15.12/EnterpriseEdition/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_15.12/Highlights.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_15.12/Known-Issues.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_15.12/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/Cello/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/D02/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/D03/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/DHCP-TFTP-Server-UEFI.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/HP-ProLiant-m400/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/Install-CentOS-7.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/Install-Debian-Jessie.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/Install-Fedora-23.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/ODPi-BigTop-Hadoop-Config-Run.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/ODPi-Hadoop-Installation.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/OpenStack-Liberty.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/Overdrive/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/UEFI-EDK2-Guide-EE.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/EnterpriseEdition/X-Gene-Mustang/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/Highlights.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/Known-Issues.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.03/ReleaseStatus-16.03.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/DHCP-TFTP-Server-UEFI.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/Install-CentOS-7.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/Install-Debian-Jessie.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/Install-Fedora-23.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/ODPi-BigTop-Hadoop-Config-Run.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/ODPi-Hadoop-Installation.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/OpenStack-Liberty.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EECommon/UEFI-EDK2-Guide-EE.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/Cello/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/D02/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/D03/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/HP-ProLiant-m400/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/Overdrive/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/Q2432LZB/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/ThunderX/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/EnterpriseEdition/X-Gene-Mustang/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/Highlights.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/Known-Issues.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/PreviousReleases/RPB_16.06/README.md (100%) rename Reference-Platform/Platforms/Enterprise/{ => Documentation}/Support/README.md (100%) diff --git a/Reference-Platform/Platforms/Enterprise/.DS_Store b/Reference-Platform/Platforms/Enterprise/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..5008ddfcf53c02e82d7eee2e57c38e5672ef89f6 GIT binary patch literal 6148 zcmeH~Jr2S!425mzP>H1@V-^m;4Wg<&0T*E43hX&L&p$$qDprKhvt+--jT7}7np#A3 zem<@ulZcFPQ@L2!n>{z**++&mCkOWA81W14cNZlEfg7;MkzE(HCqgga^y>{tEnwC%0;vJ&^%eQ zLs35+`xjp>T0 Date: Wed, 25 Jan 2017 08:33:15 -0800 Subject: [PATCH 098/114] Delete .DS_Store --- .../Platforms/Enterprise/.DS_Store | Bin 6148 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 Reference-Platform/Platforms/Enterprise/.DS_Store diff --git a/Reference-Platform/Platforms/Enterprise/.DS_Store b/Reference-Platform/Platforms/Enterprise/.DS_Store deleted file mode 100644 index 5008ddfcf53c02e82d7eee2e57c38e5672ef89f6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6148 zcmeH~Jr2S!425mzP>H1@V-^m;4Wg<&0T*E43hX&L&p$$qDprKhvt+--jT7}7np#A3 zem<@ulZcFPQ@L2!n>{z**++&mCkOWA81W14cNZlEfg7;MkzE(HCqgga^y>{tEnwC%0;vJ&^%eQ zLs35+`xjp>T0 Date: Wed, 25 Jan 2017 08:35:09 -0800 Subject: [PATCH 099/114] Added links at bottom of page Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 34c3d26..4a6ed8b 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -12,3 +12,8 @@ The enterprise reference platform is targeted to accelerate the high powered ARM - Built for Big Data Workloads *** + +Before you begin... + +1. Check out our list of ["Approved Hardware"](Documentation/Hardware/README.md) +2. Proceed to the ["Installation page"](Documentation/README.md) From f838f654e544911af6e22bc50b919b094981d9f5 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:35:34 -0800 Subject: [PATCH 100/114] Format fix Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 4a6ed8b..bfb0d0d 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -13,7 +13,7 @@ The enterprise reference platform is targeted to accelerate the high powered ARM *** -Before you begin... +## Before you begin... 1. Check out our list of ["Approved Hardware"](Documentation/Hardware/README.md) 2. Proceed to the ["Installation page"](Documentation/README.md) From dfd15fefc5d05ecd5b93e2a760a41cf51ee4b59c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:45:02 -0800 Subject: [PATCH 101/114] Relative link fix Signed-off-by: Robert Wolff --- .../Documentation/Installation/Firmware/Download.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/Installation/Firmware/Download.md b/Reference-Platform/Platforms/Enterprise/Documentation/Installation/Firmware/Download.md index e71f2e0..b3eb0eb 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/Installation/Firmware/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/Installation/Firmware/Download.md @@ -12,9 +12,9 @@ > Note: If hardware is not linked, [contact distributor](../../Hardware/README.md) for more information on available firmware. -- [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/uefi/) -- [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/uefi/) -- [OverDrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/uefi/) +- [D03](http://releases.linaro.org/reference-platform/enterprise/latest/uefi/release/d03/) +- [D05](http://releases.linaro.org/reference-platform/enterprise/latest/uefi/release/d05/) +- [OverDrive](http://releases.linaro.org/reference-platform/enterprise/latest/uefi/release/overdrive/) - X-Gene - m400 - QDF2432 From d2a937d1f7a37b4b4163578056818a00a092c4f4 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Wed, 25 Jan 2017 08:45:52 -0800 Subject: [PATCH 102/114] Relative link fix Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Documentation/Installation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/Installation/README.md index e70931b..676fb07 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/Installation/README.md @@ -2,7 +2,7 @@ This page offers generic installation instructions for the Enterprise Reference Platform on supported hardware. A list of approved hardware can be found in the ["Approved Hardware"](../Hardware/README.md) section of this documentation set. -Be sure to check out the [Release Notes](../ReleaseNotes.md) before installing. +Be sure to check out the [Release Notes](../../ReleaseNotes.md) before installing. *** From 0d58dfbddaa3d2475e659a094a77b2d62f9e9832 Mon Sep 17 00:00:00 2001 From: Victor Chong Date: Mon, 6 Feb 2017 03:23:36 +0000 Subject: [PATCH 103/114] rpb: hikey: InstallDebianRPB: Add fip.bin Add instructions to download and flash fip.bin as well Signed-off-by: Victor Chong --- .../ConsumerEdition/HiKey/InstallDebianRPB.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md index 20b2af5..d330c8d 100644 --- a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md +++ b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md @@ -19,20 +19,20 @@ This page provides download and installation instructions inteded for those inte #### Step 1: Read about the SD Card Method -The SD card method allows you to place a microSD card into the HiKey to automatically boot and install the Linux Desktop onto the board. This method is generally simpler and should be used by beginners. +The SD card method allows you to place a microSD card into the HiKey to automatically boot and install the Linux Desktop onto the board. This method is generally simpler and should be used by beginners. This method requires the following hardware: - HiKey with power supply - Host Linux machine (Linux, Mac OS X, or Windows) - MicroSD card with 4GB or more of storage - USB Mouse and/or keyboard -- HDMI Monitor with full size HDMI cable +- HDMI Monitor with full size HDMI cable *** #### Step 2: Download SD Card Image -**Debian Linux Reference Software Platform - SD Card Image** +**Debian Linux Reference Software Platform - SD Card Image** [SD Card Image - Direct Download](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/hikey-debian-jessie-alip-sdcard-*.img.gz) @@ -87,7 +87,7 @@ lsblk ```shell cd -#Example: +#Example: # = /home/YourUserName/Downloads #For this example we assume the "Debian SD Card Install Image" is in the Downloads folder. cd /home/YourUserName/Downloads @@ -161,7 +161,7 @@ Before clicking "OK": #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -184,9 +184,10 @@ This method requires the following hardware: *** -#### Step 3: Download Boot image and Root File System +#### Step 3: Download Boot firmware, image and Root File System -- **Debian Boot** ([**Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/hikey-boot-linux-*.uefi.img.gz)) +- **Debian Boot firmware** ([**Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/bootloader/fip.bin)) +- **Debian Boot image** ([**Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/hikey-boot-linux-*.uefi.img.gz)) - **Debian Rootfs** (**Download**) *** @@ -236,6 +237,7 @@ $ sudo fastboot devices ```shell $ sudo fastboot flash ptable .img $ sudo fastboot reboot +$ sudo fastboot flash fastboot fip.bin $ sudo fastboot flash boot .uefi.img $ sudo fastboot flash system hikey-rootfs-debian-jessie-alip-YYYYMMDD-nnn.emmc.img ``` From c57ee406763af946f11047cc9f1ba11f6c48523b Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Mon, 6 Feb 2017 07:57:53 -0800 Subject: [PATCH 104/114] Fixed relative link for previous releases. Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Documentation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/README.md index ddf0bf9..c3a243a 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/README.md @@ -18,5 +18,5 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is #### Resources - [Release Notes](../ReleaseNotes.md) -- [Previous Releases](../PreviousReleases/README.md) +- [Previous Releases](PreviousReleases/README.md) - [Document Contribution Policy](../../../../ContributionPolicy.md) From 74e2d5cb8723e022a21971e86d2b9f389a97a8f2 Mon Sep 17 00:00:00 2001 From: Victor Chong Date: Tue, 7 Feb 2017 18:07:13 +0000 Subject: [PATCH 105/114] RPB1606: CE: HiKey: InstallAOSP: Update link and instruction Signed-off-by: Victor Chong --- .../RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md index 317256b..5ff06bb 100644 --- a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md +++ b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md @@ -10,7 +10,7 @@ #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -76,7 +76,7 @@ $ sudo fastboot devices 0123456789abcdef fastboot ``` ->Note: If your HiKey is not being detected by fastboot, you might want to try [Board Recovery](https://github.com/96boards/documentation/wiki/HiKey-Board-Recovery) and return to this step once your board is ready +>Note: If your HiKey is not being detected by fastboot, you might want to try [Board Recovery](https://github.com/96boards/documentation/blob/master/ConsumerEdition/HiKey/Installation/BoardRecovery.md) and return to this step once your board is ready 3 - **Set HiKey into Recovery Mode using J15 header** @@ -97,6 +97,7 @@ GPIO3-1 | Link 5-6 | open ```shell $ sudo fastboot flash ptable ptable-aosp-8g.img $ sudo fastboot reboot +$ sudo fastboot flash fastboot fip.bin $ sudo fastboot flash boot boot_fat.uefi.img $ sudo fastboot flash cache cache.img $ sudo fastboot flash system system.img From 6590ac3dbf49b7e2f301d9911cc2aef7717a4ee4 Mon Sep 17 00:00:00 2001 From: Shovan Date: Tue, 21 Feb 2017 10:35:28 +0000 Subject: [PATCH 106/114] Fixed Broken url --- .../Platforms/Enterprise/Documentation/Support/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md index f21db2c..2c65af1 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md @@ -6,5 +6,5 @@ Please take advantage of the many Enterprise Reference Platform resources availa - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. - [Enterprise Forum](https://discuss.linaro.org/c/erp) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. -- [Report a bug!](../../../Extras/Report-a-bug.md) +- [Report a bug!](/Reference-Platform/Extras/Report-a-bug.md) - Instructions on how to report Enterprise Reference Platform bugs From c80b29934c8cbeeb322803e762287d9a4de80de5 Mon Sep 17 00:00:00 2001 From: Shovan Date: Tue, 21 Feb 2017 10:47:21 +0000 Subject: [PATCH 107/114] Fixed broken link --- .../Platforms/Enterprise/Documentation/Support/README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md index 2c65af1..5fe96b3 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md @@ -8,3 +8,6 @@ Please take advantage of the many Enterprise Reference Platform resources availa - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. - [Report a bug!](/Reference-Platform/Extras/Report-a-bug.md) - Instructions on how to report Enterprise Reference Platform bugs + + + From 0315895285167ee1871d2cbc28fa0f1fbc2ef7f4 Mon Sep 17 00:00:00 2001 From: Shovan Date: Tue, 21 Feb 2017 10:51:26 +0000 Subject: [PATCH 108/114] Fixing broken link Report a bug is not rendering on the website. I and hard linking to website page --- .../Platforms/Enterprise/Documentation/Support/README.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md b/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md index 5fe96b3..04b0b5b 100644 --- a/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md +++ b/Reference-Platform/Platforms/Enterprise/Documentation/Support/README.md @@ -6,8 +6,5 @@ Please take advantage of the many Enterprise Reference Platform resources availa - Current release notes for the Enterprise Reference Platform. Includes release notes and known issues. - [Enterprise Forum](https://discuss.linaro.org/c/erp) - The Enterprise Reference Platform has its very own forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out. -- [Report a bug!](/Reference-Platform/Extras/Report-a-bug.md) +- [Report a bug!](http://platforms.linaro.org/documentation/Reference-Platform/Extras/Report-a-bug.md/) - Instructions on how to report Enterprise Reference Platform bugs - - - From 9f56d8ededbe286029379e51be3b5968bf547fbd Mon Sep 17 00:00:00 2001 From: Victor Chong Date: Fri, 24 Feb 2017 10:09:37 +0000 Subject: [PATCH 109/114] hikey: Fix description of ptable file Fixes: https://github.com/Linaro/documentation/issues/30 Reported-by: Tony Zhang Signed-off-by: Victor Chong --- .../ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md | 4 ++-- .../ConsumerEdition/HiKey/InstallDebianRPB-16.03.md | 4 ++-- .../ConsumerEdition/HiKey/InstallAOSPRPB.md | 4 ++-- .../ConsumerEdition/HiKey/InstallDebianRPB.md | 12 ++++++------ .../ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md | 4 ++-- .../ConsumerEdition/HiKey/InstallDebianRPB-16.03.md | 4 ++-- .../ConsumerEdition/HiKey/InstallAOSPRPB.md | 2 +- .../ConsumerEdition/HiKey/InstallDebianRPB.md | 2 +- 8 files changed, 18 insertions(+), 18 deletions(-) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md index 317256b..415a761 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md @@ -10,7 +10,7 @@ #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -26,7 +26,7 @@ This method requires the following hardware: >Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** Build Folders (**Binaries** / **Image**) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md index 2928cb4..744c704 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md @@ -8,7 +8,7 @@ #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -24,7 +24,7 @@ This method requires the following hardware: > Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** **ptable-linux.img** ([**4G Download**](https://builds.96boards.org/releases/reference-platform/debian/hikey/16.03/bootloader/ptable-linux-4g.img) / [**8G Download**](https://builds.96boards.org/releases/reference-platform/debian/hikey/16.03/bootloader/ptable-linux-8g.img)) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md index 317256b..415a761 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md @@ -10,7 +10,7 @@ #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -26,7 +26,7 @@ This method requires the following hardware: >Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** Build Folders (**Binaries** / **Image**) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md index d14bb67..76134c2 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md @@ -19,20 +19,20 @@ This page provides download and installation instructions inteded for those inte #### Step 1: Read about the SD Card Method -The SD card method allows you to place a microSD card into the HiKey to automatically boot and install the Linux Desktop onto the board. This method is generally simpler and should be used by beginners. +The SD card method allows you to place a microSD card into the HiKey to automatically boot and install the Linux Desktop onto the board. This method is generally simpler and should be used by beginners. This method requires the following hardware: - HiKey with power supply - Host Linux machine (Linux, Mac OS X, or Windows) - MicroSD card with 4GB or more of storage - USB Mouse and/or keyboard -- HDMI Monitor with full size HDMI cable +- HDMI Monitor with full size HDMI cable *** #### Step 2: Download SD Card Image -**Debian Linux Reference Software Platform - SD Card Image** +**Debian Linux Reference Software Platform - SD Card Image** [SD Card Image - Direct Download](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/hikey-debian-jessie-alip-sdcard-*.img.gz) @@ -87,7 +87,7 @@ lsblk ```shell cd -#Example: +#Example: # = /home/YourUserName/Downloads #For this example we assume the "Debian SD Card Install Image" is in the Downloads folder. cd /home/YourUserName/Downloads @@ -161,7 +161,7 @@ Before clicking "OK": #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -177,7 +177,7 @@ This method requires the following hardware: > Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** **ptable-linux.img** ([**4G Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/bootloader/ptable-linux-4g.img) / [**8G Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/bootloader/ptable-linux-8g.img)) diff --git a/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md b/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md index 317256b..415a761 100644 --- a/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md +++ b/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallAOSPRPB-16.03.md @@ -10,7 +10,7 @@ #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -26,7 +26,7 @@ This method requires the following hardware: >Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** Build Folders (**Binaries** / **Image**) diff --git a/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md b/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md index 2928cb4..744c704 100644 --- a/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md +++ b/Reference-Platform/Releases/RPB_16.03/ConsumerEdition/HiKey/InstallDebianRPB-16.03.md @@ -8,7 +8,7 @@ #### Step 1: Read about the Fastboot Method -Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. +Fastboot is supported by the board and can be used for installs. This is for advanced users who are most likely modifying/customizing source code and will need to download such updates to the board for test/execution. This method requires the following hardware: - HiKey with power supply @@ -24,7 +24,7 @@ This method requires the following hardware: > Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** **ptable-linux.img** ([**4G Download**](https://builds.96boards.org/releases/reference-platform/debian/hikey/16.03/bootloader/ptable-linux-4g.img) / [**8G Download**](https://builds.96boards.org/releases/reference-platform/debian/hikey/16.03/bootloader/ptable-linux-8g.img)) diff --git a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md index 5ff06bb..b361b99 100644 --- a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md +++ b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallAOSPRPB.md @@ -26,7 +26,7 @@ This method requires the following hardware: >Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** Build Folders (**Binaries** / **Image**) diff --git a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md index d330c8d..1450860 100644 --- a/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md +++ b/Reference-Platform/Releases/RPB_16.06/ConsumerEdition/HiKey/InstallDebianRPB.md @@ -177,7 +177,7 @@ This method requires the following hardware: > Note: Some files have 4G and 8G options, download file which best matches your HiKey board. - All HiKey **CircuitCo boards** will use the **4G files** -- All HiKey **LeMaker 1G boards** will use the **4G files** +- All HiKey **LeMaker 1G boards** will use the **8G files** - All HiKey **LeMaker 2G boards** will use the **8G files** **ptable-linux.img** ([**4G Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/bootloader/ptable-linux-4g.img) / [**8G Download**](http://builds.96boards.org/releases/reference-platform/debian/hikey/16.06/bootloader/ptable-linux-8g.img)) From 68e66c77fb6b2e51e08bede484b96e085dbd910f Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Sun, 2 Apr 2017 09:48:06 -0700 Subject: [PATCH 110/114] Fixed broken link to OE doc Signed-off-by: Robert Wolff --- .../PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md index 7f936e4..946227c 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md @@ -28,4 +28,4 @@ *** - Access **bootloader** build from source instructions [here](BuildSourceBL.md) -- Access **OpenEmbedded** build from source instructions [here](../../CECommon/OE.md) +- Access **OpenEmbedded** build from source instructions [here](../../../../CECommon/OE.md) From 1d9265c1603393078d5f9ff1e80bbc093a1007b9 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Sun, 2 Apr 2017 09:49:20 -0700 Subject: [PATCH 111/114] Fixed broken links to known issues doc Signed-off-by: Robert Wolff --- .../RPB_16.06/ConsumerEdition/HiKey/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md index 946227c..6d680fb 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md @@ -14,14 +14,14 @@ |:-----------------------------:| | [Install Instructions](InstallDebianRPB.md) | | [Build from Source](BFSDebianRPB.md) | -| [Known issues](../../../Known-Issues.md) | +| [Known issues](../Known-Issues.md) | | **CE AOSP** | |:---------------------------:| | [Install Instructions](https://source.android.com/source/devices.html) | -| [Known issues](../../../Known-Issues.md) | +| [Known issues](../Known-Issues.md) | From f1c823542aa723bdc0c316126a0182bb84de0b6d Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Sun, 2 Apr 2017 09:49:58 -0700 Subject: [PATCH 112/114] Fixed links to known issues doc Signed-off-by: Robert Wolff --- .../RPB_16.06/ConsumerEdition/HiKey/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md index 6d680fb..8425c2e 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/HiKey/README.md @@ -14,14 +14,14 @@ |:-----------------------------:| | [Install Instructions](InstallDebianRPB.md) | | [Build from Source](BFSDebianRPB.md) | -| [Known issues](../Known-Issues.md) | +| [Known issues](../../Known-Issues.md) | | **CE AOSP** | |:---------------------------:| | [Install Instructions](https://source.android.com/source/devices.html) | -| [Known issues](../Known-Issues.md) | +| [Known issues](../../Known-Issues.md) | From 52e86b36d315b2fffa616f15404786705392d6fb Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Sun, 2 Apr 2017 09:50:47 -0700 Subject: [PATCH 113/114] Fixed broken links to OE and Known Issues docs Signed-off-by: Robert Wolff --- .../RPB_16.06/ConsumerEdition/DragonBoard-410c/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/DragonBoard-410c/README.md b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/DragonBoard-410c/README.md index cb2b5f5..44907f8 100644 --- a/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/DragonBoard-410c/README.md +++ b/Reference-Platform/Platforms/Consumer/PreviousReleases/RPB_16.06/ConsumerEdition/DragonBoard-410c/README.md @@ -10,8 +10,8 @@ |:-----------------------------:| | [Install Instructions](InstallDebianRPB-16.06.md) | | [Build from Source](BFSDebianRPB-16.06.md) | -| [Known issues](../../../Known-Issues.md) | +| [Known issues](../../Known-Issues.md) | *** -- Access generic **OpenEmbedded** build from source instructions [here](../../../CECommon/OE.md) +- Access generic **OpenEmbedded** build from source instructions [here](../../../../CECommon/OE.md) From 24d54c6b3018318f03946748fc0bafa6afb9d545 Mon Sep 17 00:00:00 2001 From: Nicolas Dechesne Date: Tue, 23 May 2017 11:31:08 +0200 Subject: [PATCH 114/114] Update OE.md --- Reference-Platform/CECommon/OE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/CECommon/OE.md b/Reference-Platform/CECommon/OE.md index 045eb01..06d0fa7 100644 --- a/Reference-Platform/CECommon/OE.md +++ b/Reference-Platform/CECommon/OE.md @@ -85,7 +85,7 @@ To manage the various git trees and the OpenEmbedded environment, a repo manifes To initialize your build environment, you need to run: mkdir oe-rpb && cd oe-rpb - repo init -u https://github.com/96boards/oe-rpb-manifest.git -b krogoth + repo init -u https://github.com/96boards/oe-rpb-manifest.git -b morty repo sync source setup-environment []
UEFI/EDK2
Go Back		Download
Get the latest pre-built firmware images		Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images		 Install
Instructions on how to install firmware		 Read more
Learn more about UEFI/EDK2 From 90449bb3c51c1e55de420f0846711e7fbcb15aac Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:34:06 -0800 Subject: [PATCH 050/114] Added download link Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/Install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index b077a60..83ccfd4 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -1,7 +1,7 @@ - + From 8cf45481c49160f93b2be4dca42e1f7dabd178f5 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:34:42 -0800 Subject: [PATCH 051/114] Added download link Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/Build.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md index 7e517e7..b4fc0e5 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Build.md @@ -1,7 +1,7 @@
UEFI/EDK2
Go Back		Download
Get the latest pre-built firmware images		Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images		 Install
Instructions on how to install firmware 		Read more
Learn more about UEFI/EDK2
- + From 8b3b14c1cd515b96f4270401f8fbc857f5587dc4 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:36:37 -0800 Subject: [PATCH 052/114] Changed a relative link for unavailable boards Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Firmware/Download.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md index b998fb0..ec566c1 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md @@ -14,4 +14,4 @@ - [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/uefi/) - [OverDrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/uefi/) -If you hardware is not listed here, please proceed to [Install](Install.md) page +If you hardware is not listed here, please proceed back to the [Installation](../README.md) page and begin from **Step 2** From 7936a56619ace3276b9b75fa82abf6af8061369f Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:41:17 -0800 Subject: [PATCH 053/114] Added list of hardware with links to installer downloads Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Centos/Download.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md new file mode 100644 index 0000000..ded589f --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md @@ -0,0 +1,9 @@ +# Choose your Hardware + +- [Overdrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/centos-installer/) +- [X-Gene](http://releases.linaro.org/reference-platform/enterprise/apm/x-gene/16.12/centos-installer/) +- [Thunder X](http://releases.linaro.org/reference-platform/enterprise/cavium/thunderx/16.12/centos-installer/) +- [m400](http://releases.linaro.org/reference-platform/enterprise/hpe/m400/16.12/centos-installer/) +- [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/centos-installer/) +- [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/centos-installer/) +- [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/centos-installer/) From afbf47595a03a7cdf1ddd273470cc62fc6b5d2fa Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:42:16 -0800 Subject: [PATCH 054/114] Added download relative links to installers Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index f3ab14e..7eab629 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -44,12 +44,12 @@ Choose your network installer, download or build, and proceed to the installatio
UEFI/EDK2
Go Back		Download
Get the latest pre-built firmware images		Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images 		Install
Instructions on how to install firmware		 Read more
Learn more about UEFI/EDK2
+ +
Centos - DownloadDownload Install
Debian Jessie - DownloadDownload Install
From 1311594f8896036244d828f0e802a5f357255733 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:42:53 -0800 Subject: [PATCH 055/114] Added install relative link Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/Centos/Download.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md index ded589f..71d4484 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md @@ -7,3 +7,5 @@ - [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/centos-installer/) - [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/centos-installer/) - [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/centos-installer/) + +Proceed to [Install](Install.md) From 2ea9a16012e9355878a8ba78666c9d75b12e2e0c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:43:31 -0800 Subject: [PATCH 056/114] Update Download.md --- .../Platforms/Enterprise/Installation/Centos/Download.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md index 71d4484..ce93d20 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md @@ -8,4 +8,4 @@ - [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/centos-installer/) - [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/centos-installer/) -Proceed to [Install](Install.md) +Proceed to [Install](README.md) From f76d9f94e345a24a46db3efbaccd0a831ad54b3e Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:43:57 -0800 Subject: [PATCH 057/114] Update Download.md --- .../Platforms/Enterprise/Installation/Centos/Download.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md index ce93d20..059a627 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md @@ -8,4 +8,4 @@ - [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/centos-installer/) - [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/centos-installer/) -Proceed to [Install](README.md) +Proceed to [Install](README.md) page From d9696d5c754b69c7fbac1afac3c69c0b68761b09 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:45:12 -0800 Subject: [PATCH 058/114] Added links to download options for installers Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Debian/Download.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md new file mode 100644 index 0000000..aba871a --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md @@ -0,0 +1,11 @@ +# Choose your Hardware + +- [Overdrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/debian-installer/) +- [X-Gene](http://releases.linaro.org/reference-platform/enterprise/apm/x-gene/16.12/debian-installer/) +- [Thunder X](http://releases.linaro.org/reference-platform/enterprise/cavium/thunderx/16.12/debian-installer/) +- [m400](http://releases.linaro.org/reference-platform/enterprise/hpe/m400/16.12/debian-installer/) +- [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/debian-installer/) +- [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/debian-installer/) +- [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/debian-installer/) + +Proceed to [Install](README.md) page From 1c52cc224d1bcf9d8977410ecb88e26be5d90f92 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 12:47:49 -0800 Subject: [PATCH 059/114] Update README.md Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Installation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index 7eab629..947ab75 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -11,7 +11,7 @@ Be sure to check out the [Release Notes](../ReleaseNotes.md) before installing. + From 88dab20bd45cb19d398c7793008a30e22b36ce4e Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 14:06:50 -0800 Subject: [PATCH 060/114] Update Download.md Signed-off-by: Robert Wolff Note: If hardware is not linked, [contact distributor](../../Hardware/README.md) for more information on available firmware. + - [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/uefi/) - [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/uefi/) - [OverDrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/uefi/) +- X-Gene +- m400 +- QDF2432 +- Thunder X -If you hardware is not listed here, please proceed back to the [Installation](../README.md) page and begin from **Step 2** +Proceed back to the [Installation](../README.md) page From 1ff57f7f821b60212f79f1915d4b240282479bb3 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 14:08:08 -0800 Subject: [PATCH 061/114] Update Download.md --- .../Platforms/Enterprise/Installation/Firmware/Download.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md index 553ad02..8a8925a 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md @@ -20,4 +20,4 @@ - QDF2432 - Thunder X -Proceed back to the [Installation](../README.md) page +Proceed back to the [Installation](../Install.md) page From 170f78748b72ce7cdf680c891c6c7adef7266e61 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Thu, 22 Dec 2016 14:08:18 -0800 Subject: [PATCH 062/114] Update Download.md --- .../Platforms/Enterprise/Installation/Firmware/Download.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md index 8a8925a..e71f2e0 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Download.md @@ -20,4 +20,4 @@ - QDF2432 - Thunder X -Proceed back to the [Installation](../Install.md) page +Proceed back to the [Installation](Install.md) page From c4e9c31c014b6d3c72b206598b79fb6908da7b8d Mon Sep 17 00:00:00 2001 From: Ricardo Salveti de Araujo Date: Thu, 5 Jan 2017 16:10:10 -0200 Subject: [PATCH 063/114] Update ReleaseNotes.md Adding additional bug links. --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index db2594c..7fdc43d 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -49,15 +49,15 @@ - Using Docker with XFS and Overlay Storage Driver: - Note that XFS file systems must be created with the -n ftype=1 option enabled for use as an overlay. With the rootfs and any file systems created during system installation, set the --mkfsoptions=-n ftype=1 parameters in the Anaconda kickstart. When creating a new file system after the installation, run the # mkfs -t xfs -n ftype=1 /PATH/TO/DEVICE command. To determine whether an existing file system is eligible for use as an overlay, run the # xfs_info /PATH/TO/DEVICE | grep ftype command to see if the ftype=1 option is enabled. - https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.2_Release_Notes/technology-preview-file_systems.html -- Installation via USB fails - bug 2655 +- Installation via USB fails - https://bugs.linaro.org/show_bug.cgi?id=2655 ### QDF2432: -- No support for on-board ethernet (emac) - bug 2603 +- No support for on-board ethernet (emac) - https://bugs.linaro.org/show_bug.cgi?id=2603 ### D03: -- Only 16 cores enabled (instead of 32) - bug 2635 +- Only 16 cores enabled (instead of 32) - https://bugs.linaro.org/show_bug.cgi?id=2635 - Fails to install/boot Debian/CentOS with the default boot argument - https://bugs.linaro.org/show_bug.cgi?id=2661 - Earlycon not working (no console output) - https://bugs.linaro.org/show_bug.cgi?id=2699 From 5a84e8f569c205805f557477fe73e7465640f815 Mon Sep 17 00:00:00 2001 From: Slimlogic Ltd Date: Fri, 13 Jan 2017 16:52:50 +0000 Subject: [PATCH 064/114] Update Install.md --- .../Installation/Firmware/Install.md | 48 +------------------ 1 file changed, 1 insertion(+), 47 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md index 83ccfd4..05ad24e 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/Firmware/Install.md @@ -12,52 +12,6 @@ Choose instructions from the approved hardware: *** -## D02 - -Flashing D02 requires the board to have a working ethernet connection to the FTP server hosting the firmware (since the recovery UEFI image provides an update path via FTP fetch + flash). Flashing also requires entering the Embedded Boot Loader (EBL). This can be reached by typing 'exit' on the UEFI shell that will bring you to a bios-like menu. Goto 'Boot Manager' to find EBL. - -### Clean flash - -First make sure the built firmware is available in your FTP server ('PV660D02.fd'): - -```shell -cp PV660D02.fd /srv/tftp/ -``` - -Now follow the steps below in order to fetch and flash the new firmware: - -1. Power off the board and unplug the power supply. -2. Push the dial switch **3. CPU0_SPI_SEL** to **off** (check [http://open-estuary.com/d02-2/](http://open-estuary.com/d02-2/) for the board picture) - - The board has two SPI flash chips, and this switch selects which one to boot from. -3. Power on the device, stop the boot from the serial console, and get into the the 'Embedded Boot Loader (EBL)' shell -4. Push the dial switch **3. CPU0_SPI_SEL** to **on** - - **NOTE:** make sure to run the step above before running 'biosupdate' (as it modifies the flash), or else the backup BIOS will also be modified and there will be no way to unbrick the board (unless sending it back to Huawei). -5. Download and flash the firmware file from the FTP server: -'biosupdate -u -p -f master' like -'D02 > biosupdate 10.0.0.10 -u anonymous -p anonymous -f PV660D02.fd master' -6. Exit the EBL console and reboot the board - -### Upgrade Firmware - -There are 2 options for updating the firmware, first via network and the second via USB storage. - -Network upgrade: - -1. Make sure the built firmware is available in your FTP server ('PV660D02.fd') -2. Stop UEFI boot, select 'Boot Manager' then 'Embedded Boot Loader (EBL)' -3. Download and flash the firmware file from the FTP server: -'biosupdate -u -p -f master', like -'D02 > biosupdate 10.0.0.10 -u anonymous -p anonymous -f PV660D02.fd master' -4. Exit the EBL console and reboot the board - -USB storage upgrade: -- Copy the '.fd' file to a FAT32 partition on USB (UEFI can only recognize FAT32 file system), then run the following command (from **EBL**): -'newbios fs1:\' - -On EBL fs1 is for USB first partition, while fs0 the ramdisk. - -*** - ## D03 Flashing D03 requires the board to have a working ethernet connection to the FTP server hosting the firmware (since the recovery UEFI image provides an update path via FTP fetch + flash). Flashing also requires entering the Embedded Boot Loader (EBL). This can be reached by typing 'exit' on the UEFI shell that will bring you to a bios-like menu. Goto 'Boot Manager' to find EBL. @@ -130,7 +84,7 @@ Depending on the size of the firmware image, flashrom might not be able to flash Example for the 4.5M based firmware: ```shell -dd if=/dev/zero of=FIRMWARE.ROM ibs=512K count=23 obs=1M oflag=append conv=notrunc +truncate --size=16M FIRMWARE.rom ``` Connect the SPI cable, unplug the power cord and flash SPI: From 960a058213b81b59f8c7357a2c328bfc20dc53f7 Mon Sep 17 00:00:00 2001 From: Martin Stadtler Date: Mon, 16 Jan 2017 16:22:51 +0000 Subject: [PATCH 065/114] Update ReleaseNotes.md --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 7fdc43d..30fd563 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -24,9 +24,8 @@ ## Enterprise Components - Docker 1.10.3 - OpenStack - - Not ready + - Mitaka - Ceph 10.2.3 - - Not ready - Spark 2.0 - OpenJDK 8 - QEMU 2.7 @@ -34,7 +33,6 @@ ## Supported Hardware Platforms - AMD Overdrive -- LeMaker Cello - HiSilicon D03 - HiSilicon D05 - APM X-Gene Mustang From 07e83523a5f1cc73e33395f63e06c80af64aaf4d Mon Sep 17 00:00:00 2001 From: Martin Stadtler Date: Mon, 16 Jan 2017 16:48:00 +0000 Subject: [PATCH 066/114] Added OpenStack release note notes --- .../Platforms/Enterprise/ReleaseNotes.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 30fd563..f0511c7 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -67,3 +67,13 @@ - UEFI boot entry not created after Debian installer finished - https://bugs.linaro.org/show_bug.cgi?id=2736 +### The SDI (OpenStack) components are released with the following known bugs: + +- 2549 "Ethernet hotplug fails on 16.06" - this is a known bug that +hasn't been fixed for this release. +- 2805 "dhcp lease is not freed after instance deleted" - this was a +regression on the kernel that is being fixed. A new validated kernel +will land next week with this fix in it. +- 2819 "Volume hot plug not working in 16.12" - This is a known issue +with this release that hasn't been fixed. + From 02db3fd7df6f897765d3fec0606041e7a2ca3f51 Mon Sep 17 00:00:00 2001 From: Fathi Boudra Date: Mon, 16 Jan 2017 19:25:27 +0200 Subject: [PATCH 067/114] release notes: use oneliner for OpenStack version/name --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index f0511c7..a9ecae8 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -23,8 +23,7 @@ ## Enterprise Components - Docker 1.10.3 -- OpenStack - - Mitaka +- OpenStack Mitaka - Ceph 10.2.3 - Spark 2.0 - OpenJDK 8 From 9297e5029f5a54a567605aee53bdbd9352035354 Mon Sep 17 00:00:00 2001 From: Slimlogic Ltd Date: Mon, 16 Jan 2017 17:26:20 +0000 Subject: [PATCH 068/114] Update ReleaseNotes.md --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index a9ecae8..7f76a12 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -9,7 +9,7 @@ ## UEFI -- Tianocore EDK II and OpenPlatformPkg containing reference implementations for Huawei D03/D05, AMD Overdrive and LeMaker Cello +- Tianocore EDK II and OpenPlatformPkg containing reference implementations for Huawei D03/D05 and AMD Overdrive ## Debian From 10e57be57d53cd478d0bb99de4454ea8fa689545 Mon Sep 17 00:00:00 2001 From: Milosz Wasilewski Date: Mon, 16 Jan 2017 23:05:51 +0000 Subject: [PATCH 069/114] ReleaseNotes: added known issues Known issues for hardware platforms and CentOS were added. Bugs are sorted in descending ID order Signed-off-by: Milosz Wasilewski --- .../Platforms/Enterprise/ReleaseNotes.md | 55 ++++++++++++++----- 1 file changed, 41 insertions(+), 14 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 7f76a12..1ae6ce8 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -46,33 +46,60 @@ - Using Docker with XFS and Overlay Storage Driver: - Note that XFS file systems must be created with the -n ftype=1 option enabled for use as an overlay. With the rootfs and any file systems created during system installation, set the --mkfsoptions=-n ftype=1 parameters in the Anaconda kickstart. When creating a new file system after the installation, run the # mkfs -t xfs -n ftype=1 /PATH/TO/DEVICE command. To determine whether an existing file system is eligible for use as an overlay, run the # xfs_info /PATH/TO/DEVICE | grep ftype command to see if the ftype=1 option is enabled. - https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.2_Release_Notes/technology-preview-file_systems.html -- Installation via USB fails - https://bugs.linaro.org/show_bug.cgi?id=2655 + +- [2801](https://bugs.linaro.org/show_bug.cgi?id=2801) sort out qemu/qemu-ev packaging in linaro-overlay for CentOS 7 +- [2778](https://bugs.linaro.org/show_bug.cgi?id=2778) qemu-system-aarch64 doesn't pull ipxe-roms-qemu package +- [2743](https://bugs.linaro.org/show_bug.cgi?id=2743) LTP: growfiles test cases failed +- [2728](https://bugs.linaro.org/show_bug.cgi?id=2728) openssl test suite test_req and test_verify failed exit major All +- [2725](https://bugs.linaro.org/show_bug.cgi?id=2725) No source RPM found for openssh-6.6.1p1-25.el7.aarch64 major All +- [2720](https://bugs.linaro.org/show_bug.cgi?id=2720) CentOS/Debian: CONFIG_ARM64_VA_BITS=48 breaks userspace +- [2701](https://bugs.linaro.org/show_bug.cgi?id=2701) libhugetlbfs test cases counters.sh heap-overflow and heapshrink failed +- [2694](https://bugs.linaro.org/show_bug.cgi?id=2694) CentOS: overlayfs: upper fs needs to support d_type +- [2681](https://bugs.linaro.org/show_bug.cgi?id=2681) Install will fail if RTC date is incorrect due to https +- [2655](https://bugs.linaro.org/show_bug.cgi?id=2655) kickstart file not available in ISO image +- [2363](https://bugs.linaro.org/show_bug.cgi?id=2363) LTP: # profil01 profil failed to record anything +- [2356](https://bugs.linaro.org/show_bug.cgi?id=2356) LTP: open14.c check file permissions failed normal All +- [2351](https://bugs.linaro.org/show_bug.cgi?id=2351) LTP: openat03 TBROK errno=EINVAL(22) Invalid argument normal All ### QDF2432: -- No support for on-board ethernet (emac) - https://bugs.linaro.org/show_bug.cgi?id=2603 +- [2663](https://bugs.linaro.org/show_bug.cgi?id=2663) Debian: 'qemu-sys - tem-aarch64 -cpu host' causes host reboot +- [2646](https://bugs.linaro.org/show_bug.cgi?id=2646) LTP: Kernel crashes in syscalls/ipc/msgctl10 test +- [2603](https://bugs.linaro.org/show_bug.cgi?id=2603) No support for on-board ethernet (emac) + +### D05: + +- [2788](https://bugs.linaro.org/show_bug.cgi?id=2788) kernel oops during hns_dsaf probe +- [2770](https://bugs.linaro.org/show_bug.cgi?id=2770) UEFI occasionally hangs +- [2715](https://bugs.linaro.org/show_bug.cgi?id=2715) CentOS: ngingx-apache-bench reports request failures +- [2712](https://bugs.linaro.org/show_bug.cgi?id=2712) network port is slow when using encrypted connection (SSH) +- [2657](https://bugs.linaro.org/show_bug.cgi?id=2657) Confusing Ethernet port sequence ### D03: -- Only 16 cores enabled (instead of 32) - https://bugs.linaro.org/show_bug.cgi?id=2635 -- Fails to install/boot Debian/CentOS with the default boot argument - https://bugs.linaro.org/show_bug.cgi?id=2661 -- Earlycon not working (no console output) - https://bugs.linaro.org/show_bug.cgi?id=2699 +- [2792](https://bugs.linaro.org/show_bug.cgi?id=2792) BMC bootdevice doesn't work with UEFI +- [2788](https://bugs.linaro.org/show_bug.cgi?id=2788) kernel oops during hns_dsaf probe +- [2774](https://bugs.linaro.org/show_bug.cgi?id=2774) System stucked when manually enabled function graph tracer and echo function_graph > /sys/kernel/debug/tracing/current_tracer +- [2732](https://bugs.linaro.org/show_bug.cgi?id=2732) LuvOS next doesn't boot on d03 +- [2699](https://bugs.linaro.org/show_bug.cgi?id=2699) Earlycon not working (no console output) +- [2661](https://bugs.linaro.org/show_bug.cgi?id=2661) Fails to install/boot Debian/CentOS with the default boot argument +- [2657](https://bugs.linaro.org/show_bug.cgi?id=2657) Confusing Ethernet port sequence +- [2635](https://bugs.linaro.org/show_bug.cgi?id=2635) Only 16 cores enabled (instead of 32) ### HP-m400 Moonshot: -- Boot medium is not updated after network installer - https://bugs.linaro.org/show_bug.cgi?id=2703 +- [2703](https://bugs.linaro.org/show_bug.cgi?id=2703) Boot medium is not updated after network installer ### Cavium (ThunderX) -- UEFI boot entry not created after Debian installer finished - https://bugs.linaro.org/show_bug.cgi?id=2736 +- [2773](https://bugs.linaro.org/show_bug.cgi?id=2773) UEFI Runtime regions are not aligned to 64 KB - buggy firmware? +- [2736](https://bugs.linaro.org/show_bug.cgi?id=2736) UEFI boot entry not created after Debian installer finished +- [2700](https://bugs.linaro.org/show_bug.cgi?id=2700) LTP test case oom01 restarted serial-getty and NetworkManager.service +- [2332](https://bugs.linaro.org/show_bug.cgi?id=2332) fork: Resource temporarily unavailable when building linux normal ThunderX ### The SDI (OpenStack) components are released with the following known bugs: -- 2549 "Ethernet hotplug fails on 16.06" - this is a known bug that -hasn't been fixed for this release. -- 2805 "dhcp lease is not freed after instance deleted" - this was a -regression on the kernel that is being fixed. A new validated kernel -will land next week with this fix in it. -- 2819 "Volume hot plug not working in 16.12" - This is a known issue -with this release that hasn't been fixed. +- [2819](https://bugs.linaro.org/show_bug.cgi?id=2819) "Volume hot plug not working in 16.12" - This is a known issue with this release that hasn't been fixed. +- [2805](https://bugs.linaro.org/show_bug.cgi?id=2805) "dhcp lease is not freed after instance deleted" - this was a regression on the kernel that is being fixed. A new validated kernel will land next week with this fix in it. +- [2549](https://bugs.linaro.org/show_bug.cgi?id=2549) "Ethernet hotplug fails on 16.06" - this is a known bug that hasn't been fixed for this release. From d562f2c774a2975bb9ad847231176e7d8b8310ad Mon Sep 17 00:00:00 2001 From: Milosz Wasilewski Date: Mon, 16 Jan 2017 23:12:23 +0000 Subject: [PATCH 070/114] ReleaseNotes: Added debian known issues Signed-off-by: Milosz Wasilewski --- .../Platforms/Enterprise/ReleaseNotes.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index 1ae6ce8..b96f5c0 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -61,6 +61,15 @@ - [2356](https://bugs.linaro.org/show_bug.cgi?id=2356) LTP: open14.c check file permissions failed normal All - [2351](https://bugs.linaro.org/show_bug.cgi?id=2351) LTP: openat03 TBROK errno=EINVAL(22) Invalid argument normal All +### Debian: + +- [2748](https://bugs.linaro.org/show_bug.cgi?id=2748) LTP: containers sub test case netns_breakns and netns_comm failed +- [2747](https://bugs.linaro.org/show_bug.cgi?id=2747) LTP test case isofs failed on D03, Thunderx and moonshot running Debian +- [2745](https://bugs.linaro.org/show_bug.cgi?id=2745) LTP: quota_remount_test01 failed on Debian Running on D03, moonshot and Thunderx platforms. +- [2744](https://bugs.linaro.org/show_bug.cgi?id=2744) LTP: writev01, writev03, writev04 test cases failed +- [2720](https://bugs.linaro.org/show_bug.cgi?id=2720) CentOS/Debian: CONFIG_ARM64_VA_BITS=48 breaks userspace +- [2351](https://bugs.linaro.org/show_bug.cgi?id=2351) LTP: openat03 TBROK errno=EINVAL(22) Invalid argument + ### QDF2432: - [2663](https://bugs.linaro.org/show_bug.cgi?id=2663) Debian: 'qemu-sys - tem-aarch64 -cpu host' causes host reboot @@ -70,6 +79,7 @@ ### D05: - [2788](https://bugs.linaro.org/show_bug.cgi?id=2788) kernel oops during hns_dsaf probe +- [2786](https://bugs.linaro.org/show_bug.cgi?id=2786) raid0 performance worse on debian comparing to centos - [2770](https://bugs.linaro.org/show_bug.cgi?id=2770) UEFI occasionally hangs - [2715](https://bugs.linaro.org/show_bug.cgi?id=2715) CentOS: ngingx-apache-bench reports request failures - [2712](https://bugs.linaro.org/show_bug.cgi?id=2712) network port is slow when using encrypted connection (SSH) From 9a0e8b8665f785095a7b5af4e6247920ecda8edb Mon Sep 17 00:00:00 2001 From: Milosz Wasilewski Date: Tue, 17 Jan 2017 13:13:23 +0000 Subject: [PATCH 071/114] ReleaseNotes: Removed resolved/fixed bugs Signed-off-by: Milosz Wasilewski --- Reference-Platform/Platforms/Enterprise/ReleaseNotes.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md index b96f5c0..d0e5d6e 100644 --- a/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md +++ b/Reference-Platform/Platforms/Enterprise/ReleaseNotes.md @@ -47,7 +47,6 @@ - Note that XFS file systems must be created with the -n ftype=1 option enabled for use as an overlay. With the rootfs and any file systems created during system installation, set the --mkfsoptions=-n ftype=1 parameters in the Anaconda kickstart. When creating a new file system after the installation, run the # mkfs -t xfs -n ftype=1 /PATH/TO/DEVICE command. To determine whether an existing file system is eligible for use as an overlay, run the # xfs_info /PATH/TO/DEVICE | grep ftype command to see if the ftype=1 option is enabled. - https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.2_Release_Notes/technology-preview-file_systems.html -- [2801](https://bugs.linaro.org/show_bug.cgi?id=2801) sort out qemu/qemu-ev packaging in linaro-overlay for CentOS 7 - [2778](https://bugs.linaro.org/show_bug.cgi?id=2778) qemu-system-aarch64 doesn't pull ipxe-roms-qemu package - [2743](https://bugs.linaro.org/show_bug.cgi?id=2743) LTP: growfiles test cases failed - [2728](https://bugs.linaro.org/show_bug.cgi?id=2728) openssl test suite test_req and test_verify failed exit major All @@ -105,7 +104,6 @@ - [2773](https://bugs.linaro.org/show_bug.cgi?id=2773) UEFI Runtime regions are not aligned to 64 KB - buggy firmware? - [2736](https://bugs.linaro.org/show_bug.cgi?id=2736) UEFI boot entry not created after Debian installer finished - [2700](https://bugs.linaro.org/show_bug.cgi?id=2700) LTP test case oom01 restarted serial-getty and NetworkManager.service -- [2332](https://bugs.linaro.org/show_bug.cgi?id=2332) fork: Resource temporarily unavailable when building linux normal ThunderX ### The SDI (OpenStack) components are released with the following known bugs: From 6de8190b3b64fc87494b92b332a2efc95b4a4e65 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 07:43:37 -0800 Subject: [PATCH 072/114] Added OpenStack md information Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/OpenStack/README.md | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 Reference-Platform/Platforms/Enterprise/OpenStack/README.md diff --git a/Reference-Platform/Platforms/Enterprise/OpenStack/README.md b/Reference-Platform/Platforms/Enterprise/OpenStack/README.md new file mode 100644 index 0000000..f7167b9 --- /dev/null +++ b/Reference-Platform/Platforms/Enterprise/OpenStack/README.md @@ -0,0 +1,105 @@ +# OpenStack + +This repository provides all the support code required to deploy a "Developer +Cloud". + +# OpenStack packages + +The OpenStack packages are built by Linaro and made available in the following +location: + +TBD + +The build scripts for the packages are available in this repository on the +`openstack-venvs` folder. These scripts are provided on as is basis, and they +are tailored specifically for Linaro's building environment. Use only at your +own risk. + +# Reference Architecture + +The reference architecture deploys a cloud that uses Ceph as backend for OpenStack. + +See block diagram of how the servers should be connected to the network and how to +spread the services on the different hosts on a default configuration in the [architecture document](docs/architecture.md). + +# Pre-requisites + + +1. All the servers are supposed to have CentOS or Debian installed and they are supposed to +have networking configured in a way that they can see/resolve each other's names. + +1. The nodes that will be used as Ceph OSDs need to have at least one extra harddrive for Ceph. + +1. The networking node should have 3 NICs connected as described in the [architecture document](docs/architecture.md). + +# Configuration + +Some example configuration files are provided in this repo as example, go through them and +generate the equivalent ones for your particular deployment: + + ansible/hosts.example + group_vars/all + +Ensure to use host names, instead of ips to avoid some known deployment issues. + +The playbook assumes your own files are in a folder called `ansible/secrets`, so the recommendation +is to place your files there. + +# The deployment + +The deployment can be split in two different parts. Ceph and OpenStack. + +## Deploying Ceph + +1) Monitors are deployed and the cluster bootstrapmd: + + ansible-playbook -K -v -i ./hosts ./site.yml --tags ceph-mon + +Check that the cluster is up and running by connecting to one of the monitors +and checking: + + ssh server1 + ceph daemon mon.server1 mon_status + +2) OSDs assume a full hard drive is dedicated to Ceph at least. A default +configuration if all the servers that will be OSDs have the same HD layout +can be spedified in group_vars/all as follows: + +``` +ceph_host_osds: + - sbX + - sbY + - sbZ +``` + +If some server has a different configuration, this will be specified in the +hostvars folder, in a file with the name of your server. For example: + +``` +$ cat hostvars/server1 + +ceph_host_osds: + - sbZ + - sbY +``` + +After configuring, the OSDs are deployed as follows: + + ansible-playbook -K -v -i ./secrets/hosts ./site.yml --tags ceph-osd + +2.1) In the case of setting up a cluster from scratch where ceph has been installed +previously, there is an option to force the resetting of all the disks (this +option WILL DELETE all the data on the OSDs). This option is not +idempotent, use at your own risk. It is safe to use if you have cleanly deployed +the machine and the disk to be used as OSD had a previously installed Ceph: + + --extra-vars 'ceph_force_prepare=true' + +## Deploying OpenStack + +OpenStack is deployed using Ansible with the playbook defined in the "ansible" +directory. You'll need to create the files "deployment-vars" and "hosts" to +match your environment. There are examples to help guide you. Once those files +are in place, OpenStack can be deployed with: + + ansible-playbook -K -v -i secrets/hosts site.yml From e2462ddb789048a82a4da13ec8df4edbbfc582a1 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 07:45:04 -0800 Subject: [PATCH 073/114] Added OpenStack option Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/README.md b/Reference-Platform/Platforms/Enterprise/README.md index 8b6d408..ff16e48 100644 --- a/Reference-Platform/Platforms/Enterprise/README.md +++ b/Reference-Platform/Platforms/Enterprise/README.md @@ -8,6 +8,8 @@ A comprehensive guide to using the Enterprise Reference Platform. This guide is - Learn more about the Enterprise Reference Platform, this is an ideal place to start. - [Installation](Installation/README.md) - Installation and build instructions for a variety of your Reference Platform components +- [OpenStack](OpenStack/README.md) + - This section provides all the support code required to deploy a "Developer Cloud" - [Support](Support/README.md) - From bug reports and current issues, to forum access and other useful resources, we want to help you find answers From 7c7033691cad5ce8477aac20daccf700ecb6712d Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 07:56:25 -0800 Subject: [PATCH 074/114] Remove hw choice for downloads page Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Centos/Download.md | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md deleted file mode 100644 index 059a627..0000000 --- a/Reference-Platform/Platforms/Enterprise/Installation/Centos/Download.md +++ /dev/null @@ -1,11 +0,0 @@ -# Choose your Hardware - -- [Overdrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/centos-installer/) -- [X-Gene](http://releases.linaro.org/reference-platform/enterprise/apm/x-gene/16.12/centos-installer/) -- [Thunder X](http://releases.linaro.org/reference-platform/enterprise/cavium/thunderx/16.12/centos-installer/) -- [m400](http://releases.linaro.org/reference-platform/enterprise/hpe/m400/16.12/centos-installer/) -- [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/centos-installer/) -- [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/centos-installer/) -- [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/centos-installer/) - -Proceed to [Install](README.md) page From ae4a56a8eee28b228ec86f42dc74411702dd88fc Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 07:56:49 -0800 Subject: [PATCH 075/114] Remove hw choice for downloads page Signed-off-by: Robert Wolff --- .../Enterprise/Installation/Debian/Download.md | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md diff --git a/Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md b/Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md deleted file mode 100644 index aba871a..0000000 --- a/Reference-Platform/Platforms/Enterprise/Installation/Debian/Download.md +++ /dev/null @@ -1,11 +0,0 @@ -# Choose your Hardware - -- [Overdrive](http://releases.linaro.org/reference-platform/enterprise/amd/overdrive/16.12/debian-installer/) -- [X-Gene](http://releases.linaro.org/reference-platform/enterprise/apm/x-gene/16.12/debian-installer/) -- [Thunder X](http://releases.linaro.org/reference-platform/enterprise/cavium/thunderx/16.12/debian-installer/) -- [m400](http://releases.linaro.org/reference-platform/enterprise/hpe/m400/16.12/debian-installer/) -- [D03](http://releases.linaro.org/reference-platform/enterprise/huawei/d03/16.12/debian-installer/) -- [D05](http://releases.linaro.org/reference-platform/enterprise/huawei/d05/16.12/debian-installer/) -- [QDF2432](http://releases.linaro.org/reference-platform/enterprise/qualcomm/qdf2432/16.12/debian-installer/) - -Proceed to [Install](README.md) page From 5f8bbef24e6c941bb5eb009bb73c5f82d9776ebd Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 07:57:40 -0800 Subject: [PATCH 076/114] Added new download link for installers Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/Installation/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index 947ab75..756d2f0 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -44,12 +44,12 @@ Choose your network installer, download or build, and proceed to the installatio
UEFI/EDK2 - Download
Get the latest pre-built firmware images		Download
Get the latest pre-built firmware images		 Build
Instructions for building latest firmware images		 Install
Instructions on how to install firmware		 Read more
Learn more about UEFI/EDK2
+ +
Centos - DownloadDownload Install
Debian Jessie - DownloadDownload Install
From 59b02025f74ad9e54386c2bd5190450258708529 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 08:18:55 -0800 Subject: [PATCH 077/114] Added support forum to top level text Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise.md b/Reference-Platform/Platforms/Enterprise.md index 4eb5e5e..f97e4fe 100644 --- a/Reference-Platform/Platforms/Enterprise.md +++ b/Reference-Platform/Platforms/Enterprise.md @@ -1,6 +1,6 @@ # Enterprise Reference Platform -The enterprise reference platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. +The enterprise reference platform is targeted to accelerate the high powered ARMv8 servers in both datacenter and cloud vertical markets. Industry standard firmware (SBBR and SBSA) and a unified Linux kernel are provided for all the supported platforms, simplifying software maintenance and deployment. The high level components such as Openstack, Ceph, Hadoop, and KVM are rigorously validated for each distribution. The enterprise software stack provides two builds based on Debian and Centos. The goal is to help bridge the gap between older technology present in today’s distributions and the latest ARM server optimizations. For more information and support please visit the [ERP forum](https://discuss.linaro.org/c/erp). **Features:** From 71d6b0aeddca3d6b1ab375fda2f906bf6fe90701 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 09:12:37 -0800 Subject: [PATCH 078/114] Removed Cello Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Hardware/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Hardware/README.md index fba00fc..8d98538 100644 --- a/Reference-Platform/Platforms/Enterprise/Hardware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Hardware/README.md @@ -3,7 +3,6 @@ List of approved hardware, ideal for testing the Enterprise Reference Platform. - [AMD Overdrive](http://www.amd.com/en-us/innovations/software-technologies/technologies-gaming/over-drive) -- [LeMaker Cello](http://www.lenovator.com/product/103.html) - [HiSilicon D03](http://open-estuary.org/d03/) - [HiSilicon D05](http://open-estuary.org/d05/) - [APM X-Gene Mustang](https://www.apm.com/products/data-center/x-gene-family/x-gene/) From cd0189996157f8333404f53ef78f6a67d4caddf9 Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 09:14:09 -0800 Subject: [PATCH 079/114] Added link for Qualcomm Board Signed-off-by: Robert Wolff --- Reference-Platform/Platforms/Enterprise/Hardware/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Hardware/README.md b/Reference-Platform/Platforms/Enterprise/Hardware/README.md index 8d98538..1844242 100644 --- a/Reference-Platform/Platforms/Enterprise/Hardware/README.md +++ b/Reference-Platform/Platforms/Enterprise/Hardware/README.md @@ -7,7 +7,7 @@ List of approved hardware, ideal for testing the Enterprise Reference Platform. - [HiSilicon D05](http://open-estuary.org/d05/) - [APM X-Gene Mustang](https://www.apm.com/products/data-center/x-gene-family/x-gene/) - [HP Proliant m400](https://www.cdw.com/shop/products/HPE-ProLiant-m400-X-Gene-2.4-GHz-64-GB-0-GB/3516636.aspx) -- Qualcomm Q2432 +- [Qualcomm Q2432](https://developer.qualcomm.com/) - [Cavium Thunder X](http://www.cavium.com/ThunderX_ARM_Processors.html) Proceed to [Installation](../Installation/README.md) page. From d04e79aae956b0517417875d815ac3c2c58f368c Mon Sep 17 00:00:00 2001 From: Robert Wolff Date: Tue, 17 Jan 2017 09:19:39 -0800 Subject: [PATCH 080/114] Added openstack option Signed-off-by: Robert Wolff --- .../Platforms/Enterprise/GettingStarted/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md index 8f6735a..d075575 100644 --- a/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md +++ b/Reference-Platform/Platforms/Enterprise/GettingStarted/README.md @@ -23,5 +23,7 @@ The Enterprise Reference Platform is targeted to accelerate the high powered ARM - This is a list of all tested and approved Enterprise Reference Platform hardware - [Installation](../Installation/README.md) - From start to finish, set up your environment and install the Enterprise Reference Platform +- [OpenStack](../OpenStack/README.md) + - This section provides all the support code required to deploy a "Developer Cloud" - [Support](../Support/README.md) - Bug reports and current issues, forum access and other useful resources. We want to help you find answers From 431dba1150f81a5011fcc313e6001c4d6e720a08 Mon Sep 17 00:00:00 2001 From: Fathi Boudra Date: Wed, 18 Jan 2017 09:45:56 +0200 Subject: [PATCH 081/114] Update README.md --- Reference-Platform/Platforms/Enterprise/Installation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Reference-Platform/Platforms/Enterprise/Installation/README.md b/Reference-Platform/Platforms/Enterprise/Installation/README.md index 756d2f0..e70931b 100644 --- a/Reference-Platform/Platforms/Enterprise/Installation/README.md +++ b/Reference-Platform/Platforms/Enterprise/Installation/README.md @@ -48,7 +48,7 @@ Choose your network installer, download or build, and proceed to the installatio 		Install
Debian Jessie + Debian Download Install