Browse Source

Update docs, simplify kernel installation on genesis

Manifests now include a specific kernel version
required for installation on genesis node.

Change-Id: I130b9ae70fbc2c8e94b648b81ce3d23e7cea12ae
Evgeny L 2 months ago
parent
commit
f2c0f4c855
1 changed files with 5 additions and 61 deletions
  1. 5
    61
      doc/source/authoring_and_deployment.rst

+ 5
- 61
doc/source/authoring_and_deployment.rst View File

@@ -613,55 +613,11 @@ e.g.:
613 613
 
614 614
 ::
615 615
 
616
-    platform:
617
-        image: 'xenial'
618
-        kernel: 'hwe-16.04'
619
-
620
-In this case, it is the hardware enablement kernel for 16.04. To find
621
-the exact kernel version that will be deployed, we must look into the
622
-simple-stream image cache that will be used by MaaS to deploy nodes
623
-with. Locate the ``data/images/ucp/maas/maas_cache`` key in within
624
-``airship-treasuremap/global/software/config/versions.yaml``. This
625
-is the image that you will need to fetch, using a node with docker
626
-installed that has access and can reach the site/location hosting the
627
-image. For example, from the **build node**, the command would take the
628
-form:
629
-
630
-::
631
-
632
-    sudo docker pull YOUR_SSTREAM_IMAGE
633
-
634
-Then, create a container from that image:
635
-
636
-::
637
-
638
-    cd ~
639
-    sudo sh -c "$(docker images | grep sstream-cache | head -1 | awk '{print $1}' > image_name)"
640
-    sudo docker create --name sstream $(cat image_name)
641
-
642
-Then use the container ID returned from the last command as follows:
643
-
644
-::
645
-
646
-    sudo docker start sstream
647
-    sudo docker exec -it sstream /bin/bash
648
-
649
-In the container, ``cd`` to the following location (substituting for the
650
-platform image and platform kernel identified in the host profile
651
-previously, and choosing the folder corresponding to the most current
652
-date if more than one are available) and run the ``file`` command on the
653
-``boot-kernel`` file:
654
-
655
-::
656
-
657
-    cd /var/www/html/maas/images/ephemeral-v3/daily/PLATFORM_IMAGE/amd64/LATEST_DATE/PLATFORM_KERNEL/generic
658
-    file boot-kernel
659
-
660
-This will produce the complete kernel version. E.g.:
661
-
662
-::
663
-
664
-    Linux kernel x86 boot executable bzImage, version 4.13.0-43-generic (buildd@lcy01-amd64-029) #48~16.04.1-Ubuntu S, RO-rootFS, swap_dev 0x7, Normal VGA
616
+  platform:
617
+    image: 'xenial'
618
+    kernel: 'hwe-16.04'
619
+    kernel_params:
620
+      kernel_package: 'linux-image-4.15.0-34-generic'
665 621
 
666 622
 In this example, the kernel version is ``4.13.0-43-generic``. Define any proxy
667 623
 environment variables needed for your environment to reach public ubuntu
@@ -677,18 +633,6 @@ If there are any later kernel versions installed, remove them with
677 633
 ``sudo apt remove``, so that the newly install kernel is the latest
678 634
 available.
679 635
 
680
-Lastly if you wish to cleanup your build node, you may run the
681
-following:
682
-
683
-::
684
-
685
-    exit # (to quit the container)
686
-    cd ~
687
-    sudo docker stop sstream
688
-    sudo docker rm sstream
689
-    sudo docker image rm $(cat image_name)
690
-    sudo rm image_name
691
-
692 636
 Install ntpdate/ntp
693 637
 ~~~~~~~~~~~~~~~~~~~
694 638
 

Loading…
Cancel
Save