From 99bd8c9f9f6cfd3c362697016dc4e4c986f200d9 Mon Sep 17 00:00:00 2001 From: Sona Sarmadi Date: Mon, 11 Dec 2017 12:38:15 +0100 Subject: Removed section ”2.2 – Enea NFV Access Installer”. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Sona Sarmadi --- .../doc/getting_started.xml | 296 +-------------------- 1 file changed, 1 insertion(+), 295 deletions(-) diff --git a/doc/book-enea-nfv-access-guide/doc/getting_started.xml b/doc/book-enea-nfv-access-guide/doc/getting_started.xml index b6cf927..5972a90 100644 --- a/doc/book-enea-nfv-access-guide/doc/getting_started.xml +++ b/doc/book-enea-nfv-access-guide/doc/getting_started.xml @@ -1,4 +1,4 @@ - + @@ -42,300 +42,6 @@ Use dash as the default system shell (/bin/sh)? No -
- Enea NFV Access Installer - - The easiest way to get started with Enea NFV Access is by using the - installer provided for each supported architecture in this release. Each - installer guides you in the creation of a bootable Enea NFV Access - installation on a physical media. - -
- Prerequisites - - The following files are needed on the development host - machine: - - - - A GRUB.efi binary - available from the GNU - GRUB download page. - - - - For booting from an SSD/HDD: a rootfs that needs to be - installed on the board (e.g. - [path_to_EneaNFV_Access_folder]/[architecture]/inteld1521/images/enea-nfv-access/enea-nfv-access.tar.gz). - - - - For USB booting: a development based rootfs (e.g. - [path_to_EneaNFV_Access_folder]/[architecture]/inteld1521/images/enea-nfv-access-dev/enea-nfv-access-dev-inteld1521.tar.gz). - - - - Using the installer on the development host requires the - following: - - - - A physical drive of 16GB or larger - - - - Root permissions - - -
- -
- Installer Setup and Usage - - To install Enea NFV Access on a physical - drive - - - - Go to the installer location: # cd [path_to_EneaNFV_Access_folder]/[architecture]/install/ -nfv-installer/script-installer - - - - Execute the script file, this will bring you to the installer - prompt: # sudo ./nfv_installer.sh - - - - Optionally, press ENTER to see the list of available - commands:help - displays a guide on how to use the installer -list-params - lists all available parameters -list-steps - lists the installer steps and the parameters that they depend on -set - sets a parameter (e.g. set drive=/dev/sda) -clear - clears a parameter (e.g. clear drive) -list-partitions - lists current drives and partitions -dry - performs a simulation test run -run - executes the installer, using the values you set for each parameter -q or quit - exits the script - - - - Set the required parameters depending on what steps you want - to run: - - - When using the installer for the first time, make sure to - set ALL parameters in order to be able to run all steps. See - "Example 2" - for details. - - - # set <parameter_name>=<parameter_value> - - - - drive=</dev/sdaX> - the drive - to partition - - - - grub_binary=<file> - points - to the GRUB executable to be installed - where grub_destination is set. - - - - grub_destination=<drive> - - specifies the partition where GRUB will be - installed - - - - rootfs_destination=<drive> - - specifies the partition where the rootfs - will be deployed, used by GRUB to boot off - of. - - - - rootfs_targz=<rootfs.tar.gz - file> - the archive of the Enea NFV Access - rootfs you wish to unpack to where - rootfs_destination is set. Which file you - unpack depends on whether you booting from an SSD/HDD or from a - USB drive. - - - - - - Optionally, perform a test run before affecting the actual - layout of the physical media with the command: dry - - - - Run the installer: run - - - - Exit the script: quit - - - - The Enea NFV Access installer creates a bootable media by - performing three steps. Each step is executed or not depending on - whether certain parameters are set: - - - - Format drive - creates a 512MB partition - which will be used by GRUB, and another to be - used for the rootfs (it should occupy the rest - of the physical media minus the first partition). This step depends - on the following parameter(s): drive= - - - - GRUB install - Installs the - grub_binary on the drive set for - grub_destination. A grub.cfg - file will be created that will be configured to boot off of - rootfs_destination. This step depends on the - following parameters:grub_destination= -grub_binary= -rootfs_destination= - - - - Root Filesystem install - - Copies and unpacks the files found in - rootfs_targz to the - rootfs_destination. This step depends on the - following parameters:rootfs_targz= -rootfs_destination= - - - - After using the installer and setting up the bootable media, - connect it to the target machine and configure the target machine to use - it as a primary boot device. -
- -
- Examples of Execution - - Below are a few examples of setups that the Enea NFV Access - installer can be used for: - - - Partitioning a drive - - set drive=/dev/sda -run - - - - Partitioning a drive, installing GRUB and a Root - Filesystem: - - set drive=/dev/sda -set grub_destination=/dev/sda1 -set grub_binary=/home/user/grub-binary.efi -set rootfs_destination=/dev/sda2 -set rootfs_targz=/home/user/rootfs.tar.gz -run - - - - Deploying ONLY a root filesystem: - - set rootfs_destination=/dev/sda2 -set rootfs_targz=/home/user/rootfs.tar.gz -run - -
- -
- Troubleshooting - - GRUB might display the following errors if the default - configuration is set to use hd0 as the primary - drive for booting: - - - - error: no such partition - - - - error: disk not found - - - - These errors have two possible causes: - - - - The drive where Enea NFV Access was installed is not - identified as hd0 by BIOS. - - - - BIOS has assigned the hd0 label to a - different drive (e.g. a USB stick) than the one where Enea NFV - Access was installed. - - - - To rectify these problems the primary boot drive must be assigned - to the correct partition. - - To change the partition for the primary boot - drive - - - - Restart the host and in the GRUB - selection screen, enter the command line by pressing - C: - - - - - - - - - - List all of the available partitions with - ls: partition list example - - - - In order to identify where Enea NFV Access was installed, for - each available partition run ls - <partition>: ls hd0 - - - - After identifying the partition, return to the GRUB selection - screen by pressing esc - - - - Press e to edit and set the boot partition - to the one identified previously: edit and set partition example - - - - To reboot to see if the change worked, press: - F10 - - -
-
-
NFV Access Release content -- cgit v1.2.3-54-g00ecf