Bug 2181618

Summary: [GSS][doc test day] Links are not proper for "Planning your deployment" guide
Product: [Red Hat Storage] Red Hat OpenShift Data Foundation Reporter: Geo Jose <gjose>
Component: documentationAssignee: Kusuma <kbg>
Status: VERIFIED --- QA Contact: Disha Walvekar <dwalveka>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 4.12CC: kramdoss, odf-bz-bot
Target Milestone: ---Keywords: NoDocsQEReview
Target Release: ODF 4.12.2   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Geo Jose 2023-03-24 19:26:17 UTC
Describe the issue:
 Incorrect the hyper links in  "Planning your deployment" guide.

Describe the task you were trying to accomplish:
 Multiple links are broken/incorrect redirection and this needs to fix.

Suggestions for improvement:
Check "Additional information" Section 

Document URL:
https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html/planning_your_deployment/index

Chapter/Section Number and Title:
 Check "Additional information" Section 
 
Product Version:
  RHODF 4.12

Environment Details:
  NA
  
Any other versions of this document that also needs this update:
 NA.

Comment 2 Geo Jose 2023-03-24 19:31:15 UTC
Additional information:
These are the sections which needs correction:

1)
 6.3. Cores versus vCPUs and hyperthreading
 Hyper link for "calculation of cores" is not working

2)
7.1.3. VMware vSphere
 Hyper link "VMware vSphere infrastructure requirements." is incorrect.S

3)
7.2.1. Red Hat Ceph Storage
 Hyper link to the "installation guide" is incorrect.

4)
7.3. Resource requirements
  Hyper link for "CPU units" is not working.

5)
7.7.2. Segregating storage traffic using Multus
a) Hyper link "Creating network attachment definitions" for bare metal, is redirecting to https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_using_bare_metal_infrastructure/index#creating-network-attachment-definitions_rhodf and the link got changed as https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_using_bare_metal_infrastructure/index#creating-network-attachment-definitions_local-bare-metal

b) Hyper link "Creating network attachment definitions" for VMware, is redirecting to https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_on_vmware_vsphere/index#creating-network-attachment-definitions_rhodf and the link got changed as https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_on_vmware_vsphere/index#creating-network-attachment-definitions_cloud-storage

6)
7.7.3. Recommended network configuration and requirements for a Multus configuration
a) The hyperlink in See "Creating Multus networks" for the necessary steps to configure a Multus based configuration on bare metal https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html/deploying_openshift_data_foundation_using_bare_metal_infrastructure/index#creating-multus-networks_bm seems to point to index. Which needs to point https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html/deploying_openshift_data_foundation_using_bare_metal_infrastructure/deploy-using-local-storage-devices-bm#creating-multus-networks_local-bare-metal

b) The hyperlink in See "Creating Multus networks" for the necessary steps to configure a Multus based configuration on VMware https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html/deploying_openshift_data_foundation_on_vmware_vsphere/index#creating-multus-networks_vmware and the link got changed as https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_on_vmware_vsphere/index#creating-multus-networks_cloud-storage

7) 
Chapter 9. Disconnected environment

In correct hyper link("Installing guide") in: For more information, see the Red Hat Knowledgebase solution A newly deployed OCS 4 cluster status shows as "Degraded", Why? and Configuring chrony time service of the "Installing guide" in OpenShift Container Platform documentation.

https://access.redhat.com/documentation/en-us/openshift_container_platform/4.12/html-single/installing/index#installation-special-config-crony_installing-customizing
https://access.redhat.com/documentation/en-us/openshift_container_platform/4.12/html-single/installing/index#installation-special-config-chrony_installing-customizing

8) 
Chapter 11. Next steps

 Deploying OpenShift Data Foundation using Microsoft Azure 
https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_using_microsoft_azure/index
https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_using_microsoft_azure_and_azure_red_hat_openshift/index


9)
 Deploying OpenShift Data Foundation using Red Hat Virtualization Platform 
https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_openshift_data_foundation_using_red_hat_virtualization_platform/index
https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.12/html-single/deploying_and_managing_openshift_data_foundation_using_red_hat_virtualization_platform/index

Regards,
Geo Jose