MCamp859 59426f4afc R4 updates to landing page and install guides
Updated main docs landing page with R4 links
Updated Installation index page: promote R4 to supported, archive R3,
and added R5 (latest) folder.

Depends-On: https://review.opendev.org/742989
Change-Id: Ie8b918c2537def374de5cf6aeb0105e595ef5978
Signed-off-by: MCamp859 <maryx.camp@intel.com>
2020-08-05 16:41:13 -04:00

2.7 KiB

Install StarlingX OpenStack

These instructions assume that you have completed the following OpenStack-specific configuration tasks that are required by the underlying StarlingX Kubernetes platform:

  • All nodes have been labeled appropriately for their OpenStack role(s).
  • The vSwitch type has been configured.
  • The nova-local volume group has been configured on any node's host, if running the compute function.

Install application manifest and helm-charts

  1. Get the latest StarlingX OpenStack application (stx-openstack) manifest and helm charts. Use one of the following options:

    • Private StarlingX build. See Build-stx-openstack-app for details.

    • Public download from CENGN StarlingX mirror.

      After you select a release, helm charts are located in centos/outputs/helm-charts.

  2. Load the stx-openstack application's package into StarlingX. The tarball package contains stx-openstack's Airship Armada manifest and stx-openstack's set of helm charts. For example:

    system application-upload stx-openstack-<version>-centos-stable-latest.tgz

    This will:

    • Load the Armada manifest and helm charts.
    • Internally manage helm chart override values for each chart.
    • Automatically generate system helm chart overrides for each chart based on the current state of the underlying StarlingX Kubernetes platform and the recommended StarlingX configuration of OpenStack services.
  3. Apply the stx-openstack application in order to bring StarlingX OpenStack into service. If your environment is preconfigured with a proxy server, then make sure HTTPS proxy is set before applying stx-openstack.

    system application-apply stx-openstack

    Note

    To set the HTTPS proxy at bootstrap time, refer to Ansible Bootstrap Configurations.

    To set the HTTPS proxy after installation, refer to Docker Proxy Configuration.

  4. Wait for the activation of stx-openstack to complete.

    This can take 5-10 minutes depending on the performance of your host machine.

    Monitor progress with the command:

    watch -n 5 system application-list

Next steps

Your OpenStack cloud is now up and running.

See access for details on how to access StarlingX OpenStack.