starlingx/docs
Code Issues Proposed changes
docs/doc/source/updates/kubernetes/installing-software-updates-before-initial-commissioning.rst
Ron Stone 0012d76f09 Add updates and upgrades content 
Some substitutions also added to accomodate StX vs partner file naming.
Add 750.006 alarm to performing-an-orchestrated-upgrade

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I33588f3c1b22cd0dbc96133cf8eb056c8c2e5162
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-05-17 07:12:27 -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.