Deploy OpenStack in a Subcloud¶

StarlingX OpenStack is supported in Distributed Cloud environments. You can currently deploy it only on subclouds, not on the Central Cloud (System Controller). However, you will need to complete a few setup tasks in the Central Cloud before installing StarlingX OpenStack in any subcloud.

Procedure

Prepare the Central Cloud.
1. Create StarlingX OpenStack Group in LDAP. Before uploading the stx-openstack application to any subcloud, ensure the OpenStack user group is configured in LDAP on the System Controller. This involves creating the OpenStack group with a fixed Group ID.
```
~(keystone_admin)]$ sudo ldapaddgroup openstack 1001
```
  This step ensures that OpenStack-related files and processes have consistent group ownership across clouds.
2. Upload StarlingX OpenStack application with images. Use the –images option to upload the application tarball and fetch the container images up front.
```
~(keystone_admin)]$ system application-upload --images <openstack-application-tarball>
```
  This step extracts the deployment tarball, downloads all referenced container images, and pushes them to the local registry on the Central Cloud. This ensures that subclouds can access the required images during deployment.
Prepare the Subcloud.

Once the Central Cloud is configured, StarlingX OpenStack images will be in the Central Cloud registry. After you have StarlingX installed in the subcloud, you now can proceed with StarlingX OpenStack installation in the subcloud.
1. Upload the StarlingX OpenStack application tarball to the subcloud (if not already present).
```
~(keystone_admin)]$ system application-upload <application-tarball>
```
2. Apply the StarlingX OpenStack application to subcloud using the following command.
```
~(keystone_admin)]$ system application-apply stx-openstack
```
  Note
  
  This step may take several minutes to complete.
3. Confirm that the apply operation completed successfully.
```
~(keystone_admin)]$ system application-show stx-openstack
```