# Troubleshooting Amazon Batch
<a name="troubleshooting"></a>

You might need to troubleshoot issues that are related to your compute environments, job queues, job definitions, or jobs. This chapter describes how to troubleshoot and resolve such issues in your Amazon Batch environment.

Amazon Batch uses IAM policies, roles, and permissions, and runs on Amazon EC2, Amazon ECS, Amazon Fargate, and Amazon Elastic Kubernetes Service infrastructure. To troubleshoot issues that are related to these services, see the following:
+ [Troubleshooting IAM](https://docs.amazonaws.cn/IAM/latest/UserGuide/troubleshoot.html) in the *IAM User Guide*
+ [Amazon ECS troubleshooting](https://docs.amazonaws.cn/AmazonECS/latest/userguide/troubleshooting.html) in the *Amazon Elastic Container Service Developer Guide*
+ [Amazon EKS troubleshooting](https://docs.amazonaws.cn/eks/latest/userguide/troubleshooting.html) in the *Amazon EKS User Guide*
+ [Troubleshoot EC2 instances](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/ec2-instance-troubleshoot.html) in the *Amazon EC2 User Guide*

**Contents**
+ [Amazon Batch](batch-troubleshooting.md)
  + [Optimal instance type configuration to receive automatic instance family updates](optimal-default-instance-troubleshooting.md)
  + [`INVALID` compute environment](invalid_compute_environment.md)
    + [Incorrect role name or ARN](invalid_compute_environment.md#invalid_service_role_arn)
    + [Repair an `INVALID` compute environment](invalid_compute_environment.md#repairing_invalid_compute_environment)
  + [Jobs stuck in a `RUNNABLE` status](job_stuck_in_runnable.md)
  + [Spot Instances not tagged on creation](spot-instance-no-tag.md)
  + [Spot Instances not scaling down](spot-fleet-not-authorized.md)
    + [Attach **AmazonEC2SpotFleetTaggingRole** managed policy to your Spot Fleet role in the Amazon Web Services Management Console](spot-fleet-not-authorized.md#spot-fleet-not-authorized-console)
    + [Attach **AmazonEC2SpotFleetTaggingRole** managed policy to your Spot Fleet role with the Amazon CLI](spot-fleet-not-authorized.md#spot-fleet-not-authorized-cli)
  + [Can't retrieve Secrets Manager secrets](troubleshooting-cant-specify-secrets.md)
  + [Can't override job definition resource requirements](override-resource-requirements.md)
  + [Error message when you update the `desiredvCpus` setting](error-desired-vcpus-update.md)
+ [Amazon Batch on Amazon EKS](batch-eks-troubleshooting.md)
  + [`INVALID` compute environment](batch_eks_invalid_compute_environment.md)
    + [Unsupported Kubernetes version](batch_eks_invalid_compute_environment.md#invalid_kubernetes_version)
    + [Instance profile doesn't exist](batch_eks_invalid_compute_environment.md#instance_profile_not_exist)
    + [Invalid Kubernetes namespace](batch_eks_invalid_compute_environment.md#invalid_kubernetes_namespace)
    + [Deleted compute environment](batch_eks_invalid_compute_environment.md#deleted_compute_environment)
    + [Nodes don't join the Amazon EKS cluster](batch_eks_invalid_compute_environment.md#batch_eks_node_not_join_cluster)
  + [Amazon Batch on Amazon EKS job is stuck in `RUNNABLE` status](batch_eks_job_stuck_in_runnable.md)
  + [Amazon Batch on Amazon EKS job is stuck in `STARTING` status](batch-eks-job-stuck-in-starting.md)
    + [Scenario: Persisted Volume Claim Attach or Mount Failure](batch-eks-job-stuck-in-starting.md#batch-eks-job-stuck-in-starting-scenario)
  + [Verify that the `aws-auth ConfigMap` is configured correctly](verify-configmap-config.md)
  + [RBAC permissions or bindings aren't configured properly](batch_eks_rbac.md)