HyperShift
Troubleshooting HyperShift on AWS
Initializing search
    openshift/hypershift
    • Home
    • Getting started
    • How-to guides
    • Self-Managed Laboratories
    • Recipes
    • Reference
    • Contribute
    • Videos
    openshift/hypershift
    • Home
    • Getting started
    • How-to guides
      • Agentic SDLC
      • Audit Log Persistence
      • Automated Machine Management
        • Configuring Machines in HyperShift
        • Manage node-level performance profiling with Performance Profile Controller
        • Node tuning
        • NodePool lifecycle
        • Scaling down data plane to Zero
      • Autoscaling
        • AI-Assisted CI Jobs
        • CI Infrastructure
        • Daily CI Health Check Procedures
        • Documentation Preview
        • Exposing the Hosted Control Plane Services
        • Global Pull Secret
        • HCP Networking Requirements
        • Multi-arch on Hosted Control Planes
      • Configure Metrics Sets
      • Configure OCP components
        • Configuring Custom API Server Certificate in HostedCluster
        • Configuring OAuth Server Certificates
        • Custom Kube API Server DNS Configuration
      • Create Monitoring Dashboard per Hosted Cluster
      • Disaster Recovery
        • Disaster Recovery CLI
        • Disaster recovery on Hosted Control Planes
        • Disaster recovery on Hosted Control Planes with OADP-1.5+
        • Etcd Recovery
        • Prerequisites
      • Disconnected
        • Configuring disconnected workloads in the HostedCluster through ImageContentSources
        • Disconnected workarounds
        • How to Configure TLS Certificates for Disconnected Deployments
        • IDMS/ICSP Config for Management Cluster
        • Known Issues
      • Distribute Hosted Cluster workloads
      • Feature Gates
      • HyperShift Operator Install
      • Pause Reconciliation
      • PKI and Certificates
        • Break-Glass Credentials
        • Internal Control Plane Certificates
          • Create an Agent cluster
          • Create Heterogeneous NodePools on Agent HostedClusters
          • Exposing HCP Services
          • Global Pull Secret
          • Other SDN providers
          • Create Arm NodePools on AWS HostedClusters
          • Create AutoNode hosted clusters
          • Create AWS Hosted Cluster in Multiple Zones
          • Create AWS infra and IAM resources separately
          • Define Custom KubeAPI Name
          • Deploy AWS private clusters
          • Disaster Recovery
          • Etcd backup/restore (manual process)
          • External DNS
          • Global Pull Secret
          • Other SDN providers
          • Shared VPC
          • Troubleshooting
            • Debug Disaster Recovery - Hosted Cluster Migration
            • Debug why nodes have not joined the cluster
        • Azure
          • Global Pull Secret
            • Create an Azure cluster with Additional Options
            • Create an Azure Hosted Cluster on AKS
            • Using Azure Scheduler
            • Self-Managed Azure HyperShift Overview
            • Autoscaling for Self-Managed Azure HostedClusters
            • Azure Workload Identity Setup for Self-Managed Clusters
            • Create a Self-Managed Azure HostedCluster
            • Create Azure IAM resources separately
            • Create Azure infrastructure separately
            • Deploy Azure private clusters
            • Setup Azure Management Cluster for HyperShift
          • Troubleshooting
            • Debug Why Azure Nodes Have Not Joined
        • GCP
          • Create a GCP Hosted Cluster
          • Create GCP IAM Resources
          • Create GCP Infrastructure
          • GCP E2E CI Job (e2e-gke)
          • Setup GCP Management Cluster
          • Configuring Network
          • Create a Kubevirt cluster
          • External Infrastructure
          • Global Pull Secret
          • GPU Devices
          • Ingress and DNS configuration
          • Performance Tuning
          • Storage Overview
          • Troubleshooting a KubeVirt cluster
          • Create a None cluster
          • Exposing HCP Services
          • Global Pull Secret
        • OpenStack
          • Additional ports for Nodepools
          • Availability Zones
          • Create a HostedCluster on OpenStack
          • Delete a HostedCluster on OpenStack
          • Global Pull Secret
          • Performance guide
          • Prerequisites for OpenStack
          • Create PowerVS Hosted Cluster
          • Create PowerVS Infra resources separately
          • Global Pull Secret
          • Prerequisites
      • Resource-Based Control Plane Autoscaling
      • Restart Control Plane Components
      • Troubleshooting
      • Upgrades
      • MultiCluster Engine and Agent provider
        • IPv4
          • Hypervisor
            • Bare Metal Requisites
            • Packaging
            • Network Manager Dispatcher
            • BMC Access for Metal3
            • Hypervisor system config
          • Dns
          • Registry
          • Management Cluster
            • Networking
            • Openshift Compact IPv4
          • Webserver
          • Mirroring and Image Content Sources
            • Mirroring
            • Image Content Policies
          • Multicluster Engine
            • ACM/MCE Deployment
            • Agent Service Config
          • TLS Certificates
          • HostedCluster
            • Hosted Cluster Object
            • Node Pools
            • Infra Env
            • Worker Nodes
            • Bare Metal Hosts
          • Finishing Deployment
            • Watching the Control Plane
            • Watching the Data Plane
        • IPv6
          • Hypervisor
            • Bare Metal Requisites
            • Packaging
            • Network Manager Dispatcher
            • BMC Access for Metal3
            • Hypervisor system config
          • Dns
          • Registry
          • Management Cluster
            • Networking
            • Openshift Compact IPv6
          • Webserver
          • Mirroring and Image Content Sources
            • Mirroring
            • Image Content Policies
          • Multicluster Engine
            • ACM/MCE Deployment
            • Agent Service Config
          • TLS Certificates
          • HostedCluster
            • Hosted Cluster Object
            • Node Pools
            • Infra Env
            • Worker Nodes
            • Bare Metal Hosts
          • Finishing Deployment
            • Watching the Control Plane
            • Watching the Data Plane
        • Dual Stack
          • Hypervisor
            • Bare Metal Requisites
            • Packaging
            • Network Manager Dispatcher
            • BMC Access for Metal3
            • Hypervisor system config
          • Dns
          • Registry
          • Management Cluster
            • Networking
            • Openshift Compact Dual
          • Webserver
          • Mirroring and Image Content Sources
            • Mirroring
            • Image Content Policies
          • Multicluster Engine
            • ACM/MCE Deployment
            • Agent Service Config
          • TLS Certificates
          • HostedCluster
            • Hosted Cluster Object
            • Node Pools
            • Infra Env
            • Worker Nodes
            • Bare Metal Hosts
          • Finishing Deployment
            • Watching the Control Plane
            • Watching the Data Plane
    • Recipes
        • Expose Data Plane Ingress via MetalLB
        • Replace the default CRI-O runtime
        • Configure SPO with Audit Logging and Seccomp
        • ACM/MCE HyperShift Operator Overrides
    • Reference
      • Architecture
          • PrivateLink
          • PrivateLink
        • Multicluster Engine and Agent
          • Secrets CSI Usage
          • Shared Ingress
            • Overview
            • HostedCluster Configuration
            • Key Vault Secrets
            • SecretProviderClass
            • Pod Volume Mounts
            • Authentication Flow
      • API
      • Concepts and Personas
      • Controller architecture
      • Project goals
      • Infrastructure
        • AWS
        • Azure (Self-Managed)
        • Azure (ARO HCP)
        • Agent
      • Konnectivity in HyperShift
      • Manifests
          • 4.9
          • 4.10
          • 4.11
          • 4.12
          • 4.13
      • Multi-platform support
      • NodePool Rollouts
      • Openshift behaviour deviations
        • Upgrade 4.17 > 4.18
          • ARO HCP E2E Test Artifacts Navigation Guide
      • SLOs
      • Versioning Support
      • Service Publishing Strategy Reference
    • Contribute
      • HO/CPO Release Process
      • OCP Branching Tasks
      • Custom Images
      • Onboard a Platform
      • Run Tests
      • Develop in Cluster
      • Run hypershift-operator locally
      • CPO Overrides
      • Contribute to docs
    • Videos

    Troubleshooting HyperShift on AWS

    This section of the HyperShift documentation contains pages related to troubleshooting specific issues when using the AWS cloud provider.

    • Debug Missing Nodes
    • Debug Disaster Recovery Issues
    Made with Material for MkDocs