Document URL: [1]: https://docs.openshift.com/container-platform/4.6/release_notes/ocp-4-6-release-notes.html#ocp-4-6-static-ip-config-with-ova Section Number and Name: Describe the issue: I found the documentation[1] for Static IP configuration for vSphere and also it is mentioned that the /var partitions now supported in RHCOS 4.6. Below details are available in the release notes page rather than a particular section of the component. ~~~ export IPCFG="ip=<ip>::<gateway>:<netmask>:<hostname>:<iface>:none nameserver=srv1 [nameserver=srv2 [nameserver=srv3 [...]]]" govc vm.change -vm "<vm_name>" -e "guestinfo.afterburn.initrd.network-kargs=${IPCFG}" ~~~ Suggestions for improvement: Can we put the static IP and details of /var filesystem in the vsphere chapters rather than release notes? Why do you put a general disk topic (separate /var) ONLY into the bare metal chapter? This applies to ALL platforms! The documentation of the "separate /var" feature is unclear about whether or not it is possible to add more than one disk/partition to RHCOS. Sometimes the doc is talking about partitions, in other parts about disks. We should make clearer what is possible and what isn't. Additional information: This is the customer's request to update the documentation properly as it makes confusion with the exact information.
Hello Avinash, Thank you for raising this concern. Since the time that this bug was reported, we have begun addressing the most critical aspect in regards to documenting the Static IP config details in vSphere docs and not just 4.6 release notes. This work is in final review and should be merged soon via https://github.com/openshift/openshift-docs/pull/27394. I have also created a separate PR (https://github.com/openshift/openshift-docs/pull/27810) with a small attempt to clarify partitions/nodes where I thought it might help. I'm uncertain whether OCP supports adding more than one disk/partition to RHCOS with separate /var partitioning, so I'm awaiting SME feedback. Lastly, it is asked: "Why do you put a general disk topic (separate /var) ONLY into the bare metal chapter? This applies to ALL platforms!" My understanding is that this feature is recommended only for bare metal installs but I'm also seeking SME feedback on this question. Moving to ON_QA.
PR has been approved by Dev/QE, waiting for peer review before merging.
https://github.com/openshift/openshift-docs/pull/27810 has been merged and cherry-picked to OCP 4.6, 4.7. Waiting to resolve a question in https://github.com/openshift/openshift-docs/pull/27394 before I merge and close this BZ and related https://bugzilla.redhat.com/show_bug.cgi?id=1898275.
https://github.com/openshift/openshift-docs/pull/27394 merged and CP'ed to 4.6, 4.7. Waiting to confirm changes are live on docs.openshift.com before closing this BZ. Also, closed related BZ https://bugzilla.redhat.com/show_bug.cgi?id=1898275.
Docs verified live on docs.openshift.com. vSphere UPI install docs: - https://docs.openshift.com/container-platform/4.6/installing/installing_vsphere/installing-vsphere.html#installation-vsphere-machines_installing-vsphere - https://docs.openshift.com/container-platform/4.6/installing/installing_vsphere/installing-vsphere-network-customizations.html#installation-vsphere-machines_installing-vsphere-network-customizations - https://docs.openshift.com/container-platform/4.6/installing/installing_vsphere/installing-restricted-networks-vsphere.html#installation-vsphere-machines_installing-restricted-networks-vsphere Bare metal install docs: - https://docs.openshift.com/container-platform/4.6/installing/installing_bare_metal/installing-bare-metal.html#installation-user-infra-machines-iso_installing-bare-metal - https://docs.openshift.com/container-platform/4.6/installing/installing_bare_metal/installing-bare-metal-network-customizations.html#installation-user-infra-machines-iso_installing-bare-metal-network-customizations - https://docs.openshift.com/container-platform/4.6/installing/installing_bare_metal/installing-restricted-networks-bare-metal.html#installation-user-infra-machines-iso_installing-restricted-networks-bare-metal Closing BZ.
Reopening this BZ as I have been asked to also provide the instructions for creating a separate /var partition in other UPI install docs: - CloudFormation templates for AWS: https://docs.openshift.com/container-platform/4.6/installing/installing_aws/installing-aws-user-infra.html 10:57 - ARM templates for Azure https://docs.openshift.com/container-platform/4.6/installing/installing_azure/installing-azure-user-infra.html 10:57 - Deployment Manager templates for GCP: https://docs.openshift.com/container-platform/4.6/installing/installing_gcp/installing-gcp-user-infra.html Cc: @agudi
Created https://github.com/openshift/openshift-docs/pull/28329 to add the /var partitioning procedure to UPI cloud provider docs.
SME/QE and peer reviewed. Merging content and cherrypicking to 4.6, 4.7.
Published on docs.openshift.com in UPI cloud provider docs in 4.6, 4.7. For example: https://docs.openshift.com/container-platform/4.7/installing/installing_aws/installing-aws-user-infra.html#installation-disk-partitioning-upi-templates_installing-aws-user-infra https://docs.openshift.com/container-platform/4.6/installing/installing_aws/installing-aws-user-infra.html#installation-disk-partitioning-upi-templates_installing-aws-user-infra Closing BZ.