From ada6628801b853aadf20e76c70a6ff1746e9bb80 Mon Sep 17 00:00:00 2001 From: Janelle Neczypor Date: Fri, 4 Apr 2025 11:30:53 -0700 Subject: [PATCH] OSDOCS-5815 --- .../rosa-hcp-sts-creating-a-cluster-quickly.adoc | 14 ++++++++++++++ .../rosa-shared-vpc-config.adoc | 2 +- .../rosa-sts-creating-a-cluster-quickly.adoc | 13 +++++++++++++ ...sts-creating-a-cluster-with-customizations.adoc | 13 +++++++++++++ 4 files changed, 41 insertions(+), 1 deletion(-) diff --git a/rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly.adoc b/rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly.adoc index 2abbd4d021..0960b00312 100644 --- a/rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly.adoc +++ b/rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly.adoc @@ -92,6 +92,20 @@ include::modules/rosa-hcp-vpc-terraform.adoc[leveloffset=+3] [discrete] include::modules/rosa-hcp-vpc-manual.adoc[leveloffset=+2] + +[id="troubleshooting_shared-vpc-hcp_vpc-creation"] +==== Troubleshooting + +If your cluster fails to install, check these common troubleshooting issues: + +* Make sure your link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html[DHCP option set] includes a domain name, and ensure that the domain name does not include any spaces or capital letters. +* If your VPC uses a custom DNS resolver (the `domain name servers` field of your DHCP option set is not `AmazonProvideDNS`), make sure it is able to properly resolve the private hosted zones configured in Route53. + +For more information about troubleshooting ROSA cluster installations, see xref:../support/troubleshooting/rosa-troubleshooting-installations.adoc#rosa-troubleshooting-installations[Troubleshooting {product-title} installations]. + +===== Get support +If you need additional xref:../support/getting-support.adoc#getting-support[support], visit the Red Hat Customer Portal to review knowledge base articles, submit a support case, and review additional product documentation and resources. + [discrete] include::modules/rosa-hcp-vpc-subnet-tagging.adoc[leveloffset=+3] diff --git a/rosa_install_access_delete_clusters/rosa-shared-vpc-config.adoc b/rosa_install_access_delete_clusters/rosa-shared-vpc-config.adoc index ac35a7fe7c..0b1b297a13 100644 --- a/rosa_install_access_delete_clusters/rosa-shared-vpc-config.adoc +++ b/rosa_install_access_delete_clusters/rosa-shared-vpc-config.adoc @@ -57,4 +57,4 @@ include::modules/rosa-sharing-vpc-creation-and-sharing.adoc[leveloffset=+1] include::modules/rosa-sharing-vpc-dns-and-roles.adoc[leveloffset=+1] include::modules/rosa-sharing-vpc-hosted-zones.adoc[leveloffset=+1] -include::modules/rosa-sharing-vpc-cluster-creation.adoc[leveloffset=+1] +include::modules/rosa-sharing-vpc-cluster-creation.adoc[leveloffset=+1] \ No newline at end of file diff --git a/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc b/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc index b606b3eece..29fd8698e4 100644 --- a/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc +++ b/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc @@ -32,6 +32,19 @@ include::modules/rosa-sts-understanding-aws-account-association.adoc[leveloffset include::modules/osd-aws-vpc-required-resources.adoc[leveloffset=+1] +[id="troubleshooting_vpc-creation"] +=== Troubleshooting + +If your cluster fails to install, check these common troubleshooting issues: + +* Make sure your link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html[DHCP option set] includes a domain name, and ensure that the domain name does not include any spaces or capital letters. +* If your VPC uses a custom DNS resolver (the `domain name servers` field of your DHCP option set is not `AmazonProvideDNS`), make sure it is able to properly resolve the private hosted zones configured in Route53. + +For more information about troubleshooting ROSA cluster installations, see xref:../support/troubleshooting/rosa-troubleshooting-installations.adoc#rosa-troubleshooting-installations[Troubleshooting {product-title} installations]. + +==== Get support +If you need additional xref:../support/getting-support.adoc#getting-support[support], visit the Red Hat Customer Portal to review knowledge base articles, submit a support case, and review additional product documentation and resources. + [role="_additional-resources"] .Additional resources diff --git a/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc b/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc index 93bf3588e6..43d4c41fb1 100644 --- a/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc +++ b/rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc @@ -30,6 +30,19 @@ include::modules/rosa-sts-arn-path-customization-for-iam-roles-and-policies.adoc include::modules/rosa-sts-support-considerations.adoc[leveloffset=+1] include::modules/osd-aws-vpc-required-resources.adoc[leveloffset=+1] +[id="troubleshooting_shared-vpc_vpc-creation"] +=== Troubleshooting + +If your cluster fails to install, check these common troubleshooting issues: + +* Make sure your link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html[DHCP option set] includes a domain name, and ensure that the domain name does not include any spaces or capital letters. +* If your VPC uses a custom DNS resolver (the `domain name servers` field of your DHCP option set is not `AmazonProvideDNS`), make sure it is able to properly resolve the private hosted zones configured in Route53. + +For more information about troubleshooting ROSA cluster installations, see xref:../support/troubleshooting/rosa-troubleshooting-installations.adoc#rosa-troubleshooting-installations[Troubleshooting {product-title} installations]. + +==== Get support +If you need additional xref:../support/getting-support.adoc#getting-support[support], visit the Red Hat Customer Portal to review knowledge base articles, submit a support case, and review additional product documentation and resources. + [role="_additional-resources"] .Additional resources