Install Software Updates Before Initial CommissioningΒΆ

This section describes installing software updates before you can commission StarlingX.

About this task

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 StarlingX 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 StarlingX 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.

  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.


    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.


      The StarlingX software will automatically enable all interfaces and send out a DHCP request, so this may happen automatically if a DHCP 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.

  1. Install, configure and unlock nodes.


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