Merge pull request #20420 from maxwelldb/shiftstack-swiftless-osdocs922

Swiftless ShiftStack installation - OSDOCS923

Author: maxwelldb

installing/installing_openstack/installing-openstack-installer-custom.adoc

@@ -14,7 +14,7 @@ In {product-title} version {product-version}, you can install a customized clust
 xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
 processes.
 
-* Have access to a {rh-openstack} administrator's account
+* Have a storage service installed in {rh-openstack}, like Block Storage (Cinder) or Object Storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 
 * Have metadata service enabled in {rh-openstack}
 

installing/installing_openstack/installing-openstack-installer-kuryr.adoc

@@ -14,7 +14,7 @@ In {product-title} version {product-version}, you can install a customized clust
 xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
 processes.
 
-* Have access to an {rh-openstack} administrator's account
+* Have a storage service installed in {rh-openstack}, like Block Storage (Cinder) or Object Storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 
 include::modules/installation-osp-about-kuryr.adoc[leveloffset=+1]
 include::modules/installation-osp-default-kuryr-deployment.adoc[leveloffset=+1]

modules/installation-osp-default-deployment.adoc

@@ -22,20 +22,19 @@ Your quota must meet the following requirements to run the {product-title} insta
 |Subnets               | 1
 |RAM                   | 112 GB
 |vCPUs                 | 28
-|Volume storage        | 175 GB
+|Volume storage        | 275 GB
 |Instances             | 7
 |Security groups       | 3
 |Security group rules  | 60
-|Swift containers      | 2
-|Swift objects         | 1
-|Swift available space | 10 MB or more
 |================================
 
-[NOTE]
-Swift space requirements vary depending on the size of the bootstrap Ignition file and image registry.
-
 A cluster might function with fewer than recommended resources, but its performance is not guaranteed.
 
+[IMPORTANT]
+====
+If OpenStack Object Storage (Swift) is available and operated by a user account with the `swiftoperator` role, it is used as the default backend for the {product-title} image registry. In this case, the volume storage requirement is 175GB. Swift space requirements vary depending on the size of the image registry.
+====
+
 [NOTE]
 By default, your security group and security group rule quotas might be low. If you encounter problems, run `openstack quota set --secgroups 3 --secgroup-rules 60 <project>` to increase them.
 

modules/installation-osp-enabling-swift.adoc

@@ -7,14 +7,20 @@
 [id="installation-osp-enabling-swift_{context}"]
 = Enabling Swift on OpenStack
 
-{product-title} on {rh-openstack-first} uses https://docs.openstack.org/security-guide/object-storage.html[OpenStack Object Storage (Swift)] to store and serve user configuration files.
+Swift is operated by a user account with the `swiftoperator` role. Add the role to an account before you run the installation program.
 
-Swift is operated by a user account with the `swiftoperator` role.
+[IMPORTANT]
+====
+If link:https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html-single/storage_guide/index#ch-manage-containers[OpenStack Object Storage (Swift)] is available, {product-title} on {rh-openstack-first} uses it as the image registry storage. If it is unavailable, the installation program relies on the OpenStack Block Storage service (Cinder).
+
+If Swift is present and you want to use it, you must enable access to it. If it is not present, or if you do not want to use it, skip this section.
+====
 
 .Prerequisites
 
-* A {rh-openstack} administrator account on the target environment
-* On Ceph RGW, https://docs.ceph.com/docs/master/radosgw/config-ref/#swift-settings[the `account in url` option must be enabled]
+* You have a {rh-openstack} administrator account on the target environment.
+* The Swift service is installed.
+* On link:https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/index#ceph-rgw[Ceph RGW], the `account in url` option is enabled.
 
 .Procedure
 
@@ -26,4 +32,4 @@ To enable Swift on {rh-openstack}:
 $ openstack role add --user <user> --project <project> swiftoperator
 ----
 
-Your {rh-openstack} deployment can now use Swift to store and serve files.
+Your {rh-openstack} deployment can now use Swift for the image registry.