From 0b14264f445d00baf25d8feaa63e1e0fad65489b Mon Sep 17 00:00:00 2001 From: Andreas Wellving Date: Thu, 7 Oct 2021 16:11:53 +0200 Subject: LXCR-11018 - Improve PXE install - Providing parameters to generate a json configuration: - Edge Management IP/FQDN - device id autogenerated from hardware identifier script - Management interface = the PXE boot interface (configured as DHCP) - Storing files on the device file system, for example to preprovision VNF images Change-Id: Iefd14ef1946a50be74ce819acbb0b94502405ce7 Signed-off-by: Andreas Wellving --- .../doc/advanced_configurations.xml | 45 ++++++++++++++++------ 1 file changed, 34 insertions(+), 11 deletions(-) diff --git a/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml b/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml index 5f20c7f..889ab98 100644 --- a/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml +++ b/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml @@ -47,9 +47,10 @@ An HTTP server must be available and accessible from the uCPE - devices in the provisioning network. Note that the installer will - use the same interface that the uCPE device is PXE-booted from, to - obtain an IP address using DHCP and access the HTTP server. + devices in the provisioning network if HTTP download is prefered. + Note that the installer will use the same interface that the uCPE + device is PXE-booted from, to obtain an IP address using DHCP and + access the HTTP server. @@ -92,7 +93,7 @@ Compress the Enea Edge Runtime .hddimg image for the uCPE device architecture using gzip and copy the resulting hddimg.gz file to the HTTP - server. + server or to the TFTP directory on the PXE server. @@ -100,9 +101,9 @@ Installation Configuration File An installation configuration file needs to be prepared on the - HTTP server. The format of the configuration file is a list of - "name = value" pairs and the available parameters - are described below: + HTTP server or on the TFTP directory on the PXE server. The format of + the configuration file is a list of "name = value" + pairs and the available parameters are described below: @@ -123,13 +124,34 @@ formatting and partitioning the drive. The default behavior is to proceed automatically without any user interaction. + + + staging_archive (optional). A tar.gz file + including files to be pre-staged on the device. + + + + edge_management_address (optional). Edge + Management IP/FQDN. + + + + deviceid_script (optional). Shell script that + the installer will run returning the DeviceId matching Edge Managment + settings. E.g. the script would return a HW identifier. + - Installation Configuration File Example: + Installation Configuration File Examples: image_url = http://192.168.1.100/enea-edge-runtime-xeon-d.hddimg.gz install_drive = /dev/sda + image_url = tftp://<Server IP>/enea_edge/enea-edge-runtime-xeon-d.hddimg.gz +staging_archive = tftp://<Server IP>/enea_edge/conf_files.tar.gz +edge_management_address = manager1.enea.com +deviceid_script = tftp://<Server IP>/enea_edge/deviceId + The installation configuration file needs to use the Linux end-of-line format (\n), not the Windows format (\r\n). @@ -142,14 +164,15 @@ install_drive = /dev/sda A PXE entry for the Enea Edge installation needs to be added as the default boot selection in the pxelinux configuration file (e.g /var/lib/tftpboot/pxelinux.cfg/default). The PXE - entry should have the following settings: + entry should have the following settings, where <protocol> could + be either of http or tftp: default enea_edge_runtime label enea_edge_runtime menu label ^ENEA_EDGE_INSTALLER kernel <Path to kernel> append root=/dev/ram0 initrd=<Path to initramfs> LABEL=pxe-installer \ - INSTALL_CFG=http://<Server IP>/<Path to install config file> \ + INSTALL_CFG=<protocol>://<Server IP>/<Path to install config file> \ console=ttyS0,115200 earlyprintk=ttyS0,115200 ipappend 2 @@ -1455,4 +1478,4 @@ Configuration complete. - \ No newline at end of file + -- cgit v1.2.3-54-g00ecf