Skip to content

AWS Troubleshooting

Exercises

  1. 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 on slurm-training-val (Slurm 25.11.4, ParallelCluster 3.15.0).
$ sinfo -R
REASON               USER      TIMESTAMP           NODELIST

$ scontrol show node batch-dy-compute-1 | grep -E '(Reason|State)='
   State=IDLE+CLOUD ThreadsPerCore=1 TmpDisk=0 Weight=1000 Owner=N/A MCS_label=N/A
  1. 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
Expected output: Validated 2026-04-15 on 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