OCP 4.22: Update documentation for GA of PowerVC IPI #112141
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 | ||
|
Collaborator
There was a problem hiding this comment. 🤖 [error] AsciiDocDITA.NestedSection: Level 2, 3, 4, and 5 sections are not supported in DITA. |
||
| 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 | ||
|
Collaborator
There was a problem hiding this comment. 🤖 [error] AsciiDocDITA.NestedSection: Level 2, 3, 4, and 5 sections are not supported in DITA. |
||
| DNS records pointing to loadbalancer service are required for installation. In each record, `<cluster_name>` is the cluster name and `<base_domain>` is the cluster base domain that you specify when you install the cluster. A complete DNS record takes the form: `<component>.<cluster_name>.<base_domain>.`. | ||
|
|
||
| .Required DNS records | ||
| [cols="1a,5a,3a",options="header"] | ||
| |=== | ||
|
|
||
| |Component | ||
| |Record | ||
| |Description | ||
|
|
||
| |API VIP | ||
| |`api.<cluster_name>.<base_domain>.` | ||
| |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.<cluster_name>.<base_domain>.` | ||
| |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.<cluster_name>.<base_domain>.` | ||
| |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. | ||
| |=== | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 | ||
|
Collaborator
There was a problem hiding this comment. 🤖 [error] AsciiDocDITA.ShortDescription: Assign [role="_abstract"] to a paragraph to use it as in DITA. |
||
|
|
||
| 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. | ||
|
Collaborator
There was a problem hiding this comment. 🤖 [error] AsciiDocDITA.CalloutList: Callouts are not supported in DITA. |
||
| <2> User-managed DHCP server is serving this subnet. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🤖 [error] AsciiDocDITA.ShortDescription: Assign [role="_abstract"] to a paragraph to use it as in DITA.