starlingx/docs
Code Issues Proposed changes
4b29310c6f
docs/doc/source/updates/kubernetes/installing-software-updates-before-initial-commissioning.rst
Ron Stone dd8efe5f85 Upgrades edits (r6,r7,dsR6,dsR7) 
Copy edits for typos, markup and other technical issues.
Fix case typo
Fix merge conflicts.
Resolve FixMe issues.
Minor copy edit updates.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I7d710d3faa957c1cb66cc18c9a248a567e7c580f
2022-10-27 06:34:33 -04:00

3.4 KiB
Raw Blame History

Install Software Updates Before Initial Commissioning

This section describes installing software updates before you can commission .

This procedure assumes that the software updates to install are available on a USB flash drive, or from a server reachable by controller-0.

When initially installing the software, it is required that you install the latest available updates on controller-0 before running Ansible Bootstrap Playbook, and before installing the software on other hosts. This ensures that:

  • The software on controller-0, and all other hosts, is up to date when the cluster comes alive.
  • You reduce installation time by avoiding updating the system right after an out-of-date software installation is complete.

  1. Install software on controller-0.

    Use the bootable ISO image to initialize controller-0.

    This step takes you to the point where you use the console port to log in to controller-0 as user sysadmin.

  2. Populate the storage area.

    Upload the updates from the USB flash drive using the command sw-patch upload or sw-patch upload-dir as described in Populating the Storage Area <populating-the-storage-area>.

  3. Delete the update files from the root drive.

    After the updates are uploaded to the storage area, the original files are no longer required. You must delete them to ensure enough disk space to complete the installation.

    Caution

    If the original files are not deleted before the updates are applied, the installation may fail due to a full disk.

  4. Apply the updates.

    Apply the updates using the command sw-patch apply --all.

    The updates are now in the repository, ready to be installed.

  5. Install the updates on the controller.

    $ sudo sw-patch install-local
Patch installation is complete.
Please reboot before continuing with configuration.

    This command installs all applied updates on controller-0.

  6. Reboot controller-0.

    You must reboot the controller to ensure that it is running with the software fully updated.

    $ sudo reboot

  7. Bootstrap system on controller-0.

    1. Configure an IP interface.

      Note

      The software will automatically enable all interfaces and send out a request, so this may happen automatically if a Server is present on the network. Otherwise, you must manually configure an IP interface.

    2. Run the Ansible Bootstrap Playbook. This can be run remotely or locally on controller-0.

Once all hosts in the cluster are initialized and they are all running fully updated software. The cluster is up to date.