summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEvgeny L <eli@mirantis.com>2019-02-01 21:41:12 +0000
committerEvgeny L <eli@mirantis.com>2019-02-01 21:41:12 +0000
commitf2c0f4c855260ed338ff6edbd265191b37d4a1dd (patch)
tree436b7cf816e48556a08cabc59e0ecbb68e696d3d
parent19c53a6d6bdc7430f58c9f8a4b0e9fd7dbba1e54 (diff)
Update docs, simplify kernel installation on genesis
Manifests now include a specific kernel version required for installation on genesis node. Change-Id: I130b9ae70fbc2c8e94b648b81ce3d23e7cea12ae
Notes
Notes (review): Code-Review+2: Kaspars Skels <kaspars.skels@gmail.com> Code-Review+2: Roman Gorshunov <roman.gorshunov@att.com> Workflow+1: Roman Gorshunov <roman.gorshunov@att.com> Verified+2: Zuul Submitted-by: Zuul Submitted-at: Mon, 04 Feb 2019 16:41:18 +0000 Reviewed-on: https://review.openstack.org/634498 Project: openstack/airship-treasuremap Branch: refs/heads/master
-rw-r--r--doc/source/authoring_and_deployment.rst66
1 files changed, 5 insertions, 61 deletions
diff --git a/doc/source/authoring_and_deployment.rst b/doc/source/authoring_and_deployment.rst
index 85847cf..6118dda 100644
--- a/doc/source/authoring_and_deployment.rst
+++ b/doc/source/authoring_and_deployment.rst
@@ -613,55 +613,11 @@ e.g.:
613 613
614:: 614::
615 615
616 platform: 616 platform:
617 image: 'xenial' 617 image: 'xenial'
618 kernel: 'hwe-16.04' 618 kernel: 'hwe-16.04'
619 619 kernel_params:
620In this case, it is the hardware enablement kernel for 16.04. To find 620 kernel_package: 'linux-image-4.15.0-34-generic'
621the exact kernel version that will be deployed, we must look into the
622simple-stream image cache that will be used by MaaS to deploy nodes
623with. Locate the ``data/images/ucp/maas/maas_cache`` key in within
624``airship-treasuremap/global/software/config/versions.yaml``. This
625is the image that you will need to fetch, using a node with docker
626installed that has access and can reach the site/location hosting the
627image. For example, from the **build node**, the command would take the
628form:
629
630::
631
632 sudo docker pull YOUR_SSTREAM_IMAGE
633
634Then, 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
642Then 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
649In the container, ``cd`` to the following location (substituting for the
650platform image and platform kernel identified in the host profile
651previously, and choosing the folder corresponding to the most current
652date 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
660This 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
665 621
666In this example, the kernel version is ``4.13.0-43-generic``. Define any proxy 622In this example, the kernel version is ``4.13.0-43-generic``. Define any proxy
667environment variables needed for your environment to reach public ubuntu 623environment 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``sudo apt remove``, so that the newly install kernel is the latest 633``sudo apt remove``, so that the newly install kernel is the latest
678available. 634available.
679 635
680Lastly if you wish to cleanup your build node, you may run the
681following:
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
692Install ntpdate/ntp 636Install ntpdate/ntp
693~~~~~~~~~~~~~~~~~~~ 637~~~~~~~~~~~~~~~~~~~
694 638