AWS Troubleshooting
Exercises¶
- Interpret capacity error node states
A cluster shows the following sinfo output. What happened, and what should you do?
PARTITION AVAIL TIMELIMIT NODES STATE NODELIST
gpu* up infinite 1 down# gpu-dy-p4d-1
gpu* up infinite 7 down~ gpu-dy-p4d-[2-8]
gpu* up infinite 8 idle~ gpu-dy-g5-[1-8]
Hint / Solution
Node `gpu-dy-p4d-1` failed to launch (likely `InsufficientInstanceCapacity` for p4d.24xlarge). The `down#` state means it was the node that tried to launch. The `down~` nodes are other p4d nodes in the same compute resource, pre-emptively disabled by fast insufficient capacity fail-over. The `gpu-dy-g5` nodes are a different compute resource (g5 instances) and are still `idle~` (available). The job should automatically requeue to the g5 compute resource. **To verify:** `scontrol show nodes gpu-dy-p4d-1 | grep Reason` **If the job didn't requeue:** Check that both compute resources are in the same queue and that the job's constraints allow g5 instances. Expected output: Validated 2026-04-15 onslurm-training-val (Slurm 25.11.4, ParallelCluster 3.15.0).
- Diagnose a bootstrap failure
Your cluster has entered protected mode. No jobs are running. How do you find out what went wrong and recover?
Hint / Solution
# 1. Confirm protected mode
pcluster describe-compute-fleet --cluster-name mycluster --region us-east-2
# Look for "status": "PROTECTED"
# 2. Find which queue is affected
sinfo
# Partitions showing INACTIVE = protected mode triggered
# 3. Find the failing nodes
sudo grep "Node bootstrap error" /var/log/parallelcluster/clustermgtd
# 4. Check the compute node logs (get IP from step 3)
# SSH or SSM to the compute node, then:
sudo tail -100 /var/log/cloud-init-output.log
# 5. Fix the root cause (custom action, security group, etc.)
# 6. Exit protected mode
pcluster update-compute-fleet --cluster-name mycluster \
--region us-east-2 --status START_REQUESTED
slurm-training-val (Slurm 25.11.4, ParallelCluster 3.15.0).
$ sinfo
PARTITION AVAIL TIMELIMIT NODES STATE NODELIST
batch* up infinite 2 idle~ batch-dy-compute-[3-4]
batch* up infinite 2 idle batch-dy-compute-[1-2]
debug up infinite 2 idle~ debug-dy-small-[1-2]
gpu up infinite 1 idle~ gpu-dy-t4-1
highmem up infinite 1 idle~ highmem-dy-large-1
$ sudo grep 'Node bootstrap error' /var/log/parallelcluster/clustermgtd 2>/dev/null | tail -5 || echo '(no bootstrap errors found)'
2026-04-14 22:10:56,42 - [slurm_plugin.slurm_resources:is_bootstrap_failure] - WARNING - Node bootstrap error: Node gpu-dy-t4-1(172.31.89.235) failed to register to the Slurm management daemon, node state: IDLE+CLOUD+DRAIN+INVALID_REG
2026-04-14 23:25:44,43 - [slurm_plugin.slurm_resources:is_bootstrap_failure] - WARNING - Node bootstrap error: Node gpu-dy-t4-1(172.31.87.111) failed to register to the Slurm management daemon, node state: IDLE+CLOUD+DRAIN+INVALID_REG
2026-04-15 00:12:44,44 - [slurm_plugin.slurm_resources:is_bootstrap_failure] - WARNING - Node bootstrap error: Node gpu-dy-t4-1(172.31.80.161) failed to register to the Slurm management daemon, node state: IDLE+CLOUD+DRAIN+INVALID_REG
$ sudo tail -3 /var/log/parallelcluster/clustermgtd
2026-04-15 02:06:44,45 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Found the following unhealthy dynamic nodes: (x1) ['debug-dy-small-2(debug-dy-small-2)']
2026-04-15 02:06:44,45 - [slurm_plugin.clustermgtd:_handle_unhealthy_dynamic_nodes] - INFO - Setting unhealthy dynamic nodes to down and power_down.
2026-04-15 02:06:44,46 - [slurm_plugin.clustermgtd:_terminate_orphaned_instances] - INFO - Checking for orphaned instance
References¶
- ParallelCluster: Troubleshooting Scaling Issues
- ParallelCluster: Slurm Cluster Protected Mode
- ParallelCluster: Fast Insufficient Capacity Fail-Over
- ParallelCluster: Retrieving and Preserving Logs
- ParallelCluster: EC2 Console Output Logs
- PCS: Troubleshooting Compute Node Bootstrap
- PCS: General Troubleshooting
- Slurm Troubleshooting (general) — generic Slurm troubleshooting module