diff --git a/installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc b/installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc index d68b5fc7b51b..f47c76424d61 100644 --- a/installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc +++ b/installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc @@ -16,12 +16,20 @@ In {product-title} version {product-version}, you can install a customized clust * You have a load balancing service you can use with the {ibm-power-vc-name} network you intend to use. * You have a DHCP server backing the {ibm-power-vc-name} network you intend to use. +include::modules/installation-ibm-powervc-infra-requirements.adoc[leveloffset=+1] + include::modules/installation-ibm-powervc-default-deployment.adoc[leveloffset=+1] +include::modules/installation-load-balancing-user-infra.adoc[leveloffset=+2] + +include::modules/installation-load-balancing-user-infra-example.adoc[leveloffset=+3] + include::modules/installation-obtaining-installer.adoc[leveloffset=+1] include::modules/installation-initializing.adoc[leveloffset=+1] +include::modules/installation-ibm-powervc-standard-config.adoc[leveloffset=+2] + [role="_additional-resources"] .Additional resources * xref:../../installing/installing_ibm_powervc/installation-config-parameters-ibm-powervc.adoc#installation-config-parameters-ibm-powervc[Installation configuration parameters for IBM PowerVC] diff --git a/modules/installation-ibm-powervc-infra-requirements.adoc b/modules/installation-ibm-powervc-infra-requirements.adoc new file mode 100644 index 000000000000..61c0a496ad06 --- /dev/null +++ b/modules/installation-ibm-powervc-infra-requirements.adoc @@ -0,0 +1,58 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc + +:_mod-docs-content-type: CONCEPT +[id="installation-ibm-powervc-infra-requirements_{context}"] += Infrastructure requirements for installing {product-title} on {ibm-power-vc-name} + +To support an {product-title} installation using the installation program, you need to prepare your {ibm-power-vc-name} environment. + +[id="installation-ibm-powervc-infra-requirements-account_{context}"] +== {ibm-power-vc-name} account privilege requirements + +When installing {product-title} on {ibm-power-vc-name} using the installation program, you must use an administrative account to ensure that you have all required permissions. + + +[id="installation-ibm-powervc-infra-requirements-image_{context}"] +== {ibm-power-vc-name} image requirements +You will need to import a {op-system-first} image. This can be found using the installation program. + +[source,terminal] +---- +$ openshift-install coreos print-stream-json | jq -r '.architectures.ppc64le.artifacts.openstack' | jq -r '.formats."qcow2.gz".disk.location' +---- + +Once downloaded from the resultant URL, you can import into {ibm-power-vc-name} using the `powervc-image-import` tool. + +[id="installation-ibm-powervc-infra-requirements-networking_{context}"] +== Networking requirements + +=== {ibm-power-vc-name} network +Installation requires at least one PowerVC network. Ideally the network should be dedicated to your {product-title} cluster and not shared with other workloads. + +It is recommended that the network is set as a DHCP network in {ibm-power-vc-name}. You must have a DHCP server set up to assign addresses for this network. When using this type of network, {ibm-power-vc-name} is not aware of the IP address that is assigned to the created servers. + +=== DNS records +DNS records pointing to loadbalancer service are required for installation. In each record, `` is the cluster name and `` is the cluster base domain that you specify when you install the cluster. A complete DNS record takes the form: `...`. + +.Required DNS records +[cols="1a,5a,3a",options="header"] +|=== + +|Component +|Record +|Description + +|API VIP +|`api...` +|This DNS A/AAAA or CNAME (Canonical Name) record must point to the load balancer for the cluster. This record must be resolvable by both clients external to the cluster and from all the nodes within the cluster. + +|API VIP +|`api-int...` +|This DNS A/AAAA or CNAME (Canonical Name) record must point to the load balancer for the cluster. This record must be resolvable by all the nodes within the cluster. + +|Ingress VIP +|`*.apps...` +|A wildcard DNS A/AAAA or CNAME record that points to the load balancer that targets the machines that run the Ingress router pods, which are the worker nodes by default. This record must be resolvable by both clients external to the cluster and from all the nodes within the cluster. +|=== \ No newline at end of file diff --git a/modules/installation-ibm-powervc-standard-config.adoc b/modules/installation-ibm-powervc-standard-config.adoc new file mode 100644 index 000000000000..0df0e12f2c93 --- /dev/null +++ b/modules/installation-ibm-powervc-standard-config.adoc @@ -0,0 +1,62 @@ +:_mod-docs-content-type: REFERENCE +[id="install-powervc-standard-config_{context}"] += Installation configuration for a cluster on {ibm-power-vc-name} with a user-managed load balancer + +The following example `install-config.yaml` file demonstrates how to configure a cluster that uses an external, user-managed load balancer. + +[IMPORTANT] +==== +This sample file is provided for reference only. You must obtain your +`install-config.yaml` file by using the installation program. +==== + +[source,yaml] +---- +apiVersion: v1 +baseDomain: mydomain.test +compute: +- architecture: ppc64le + hyperthreading: Enabled + name: worker + platform: + powervc: + zones: + - powervc-sample-project + replicas: 3 +controlPlane: + architecture: ppc64le + name: master + platform: + powervc: + zones: + - s1122 + replicas: 3 +metadata: + creationTimestamp: null + name: ocp-on-powervc +networking: + clusterNetwork: + - cidr: 10.100.0.0/14 + hostPrefix: 23 + machineNetwork: + - cidr: 10.100.32.0/20 + networkType: OVNKubernetes + serviceNetwork: + - 172.30.0.0/16 +platform: + powervc: + apiVIPs: + - 10.20.188.52 <1> + cloud: powervc + clusterOSImage: my-rhcos-image + defaultMachinePlatform: + type: my-powervc-project + ingressVIPs: + - 10.20.188.52 <1> + controlPlanePort: + fixedIPs: + - subnet: + id: ae643a65-d0fc-4408-90c6-a820340bfade <2> +---- +<1> Address of the user-manager load balancer. +<2> User-managed DHCP server is serving this subnet. \ No newline at end of file diff --git a/modules/installation-load-balancing-user-infra-example.adoc b/modules/installation-load-balancing-user-infra-example.adoc index 0cdc724e3b92..603352642d4d 100644 --- a/modules/installation-load-balancing-user-infra-example.adoc +++ b/modules/installation-load-balancing-user-infra-example.adoc @@ -11,6 +11,7 @@ // * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc // * installing/installing_ibm_z/installing-ibm-power.adoc // * installing/installing_ibm_z/installing-restricted-networks-ibm-power.adoc +// * installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc // * installing/installing_openstack/installing-openstack-installer-custom.adoc ifeval::["{context}" == "installing-openstack-installer-custom"] diff --git a/modules/installation-load-balancing-user-infra.adoc b/modules/installation-load-balancing-user-infra.adoc index fb2949710d65..a0f1bd6f9f21 100644 --- a/modules/installation-load-balancing-user-infra.adoc +++ b/modules/installation-load-balancing-user-infra.adoc @@ -11,6 +11,7 @@ // * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc // * installing/installing_ibm_z/installing-ibm-power.adoc // * installing/installing_ibm_z/installing-restricted-networks-ibm-power.adoc +// * installing/installing_ibm_powervc/installing-ibm-powervc-installer-custom.adoc // * installing/installing_openstack/installing-openstack-installer-custom.adoc ifeval::["{context}" == "installing-openstack-installer-custom"]