Merge pull request openshift#33982 from ktothill/TELCODOCS-213

TELCODOCS-213 D/S Doc: MGMT-3573, Assisted service support installing single node OCP - 2

modules/ztp-ai-install-ocp-clusters-on-bare-metal.adoc

@@ -0,0 +1,74 @@
+// Module included in the following assemblies:
+//
+// scalability_and_performance/ztp-deploying-disconnected.adoc
+
+[id="enabling-assisted-installer-service-on-bare-metal_{context}"]
+= Enabling assisted installer service on bare metal
+
+The Assisted Installer Service (AIS) deploys {product-title} clusters. {rh-rhacm-first} ships with AIS, which is deployed when the MultiClusterHub Operator is enabled on the {rh-rhacm} hub cluster.
+
+For distributed units (DUs), {rh-rhacm} supports {product-title} deployments, which run on a single bare metal host. The single node cluster acts as both a control plane and a worker node. {rh-rhacm} supports single node OpenShift deployments for {product-title} on top of a single bare-metal host.
+
+.Prerequisites
+
+* Install {product-title} {product-version} on a hub cluster.
+* Install {rh-rhacm} and create the `MultiClusterHub` resource.
+* Create persistent volume custom resources (CR) for database and file system storage.
+* You have installed the Openshift CLI (`oc`).
+
+.Procedure
+
+. Modify the `HiveConfig` resource to enable the feature gate for Assisted Installer:
++
+[source,terminal]
+----
+ $ oc patch hiveconfig hive --type merge -p '{"spec":{"targetNamespace":"hive","logLevel":"debug","featureGates":{"custom":{"enabled":["AlphaAgentInstallStrategy"]},"featureSet":"Custom"}}}'
+----
+
+. Modify the `provisioning` resource to allow the bare metal operator to watch all namespaces:
++
+[source,terminal]
+----
+ $ oc patch provisioning provisioning-configuration --type merge -p '{"spec":{"watchAllNamespaces": true }}'
+----
+
+. Create and save the `AgentServiceConfig` custom resource file containing this YAML:
++
+[source,yaml]
+----
+ kind: AgentServiceConfig
+ metadata:
+   name: agent
+   namespace: assisted-installer
+ spec:
+   databaseStorage:
+     volumeName: <db_pv_name> <1>
+     accessModes:
+     - ReadWriteOnce
+     resources:
+       requests:
+         storage: <db_storage_size> <2>
+   filesystemStorage:
+     volumeName: <fs_pv-name> <3>
+     accessModes:
+     - ReadWriteOnce
+     resources:
+       requests:
+         storage: <fs_storage_size> <4>
+   osImages:
+     - openshiftVersion: <ocp_version> <5>
+       rootfs: <rootfs_url> <6>
+       url: <iso_url> <7>
+----
+<1> The `PersistentVolume` name to use for database storage.
+<2> Volume size of the `db_pv_name` `PersistentVolume`.
+<3> The `PersistentVolume` name to use for file system storage.
+<4> Volume size of the `fs_pv_name` `PersistentVolume`.
+<5> {product-title} version to boot the single node OpenShift clusters.
+
+. Create the `AgentServiceConfig` object from the file:
++
+[source,terminal]
+----
+$ oc create -f <file-name>.yaml
+----