Troubleshoot Amazon EC2 instance hibernation
Use this information to help diagnose and fix issues that you might encounter when hibernating an instance.
Hibernation issues
Can't hibernate immediately after launch
If you try to hibernate an instance too quickly after you've launched it, you get an error.
You must wait for about two minutes for Linux instances and about five minutes for Windows instances after launch before hibernating.
Takes too long to transition from stopping to stopped, and memory state not restored after start
If it takes a long time for your hibernating instance to transition from the
stopping
state to stopped
, and if the memory state is
not restored after you start, this could indicate that hibernation was not properly
configured.
Linux instances
Check the instance system log and look for messages that are related to
hibernation. To access the system log, connect to the instance or use the get-console-output
command. Find the log lines from the hibinit-agent
. If the log lines
indicate a failure or the log lines are missing, there was most likely a failure
configuring hibernation at launch.
For example, the following message indicates that the instance root volume is not
large enough: hibinit-agent: Insufficient disk space. Cannot create setup for
hibernation. Please allocate a larger root device.
If the last log line from the hibinit-agent
is hibinit-agent:
Running: swapoff /swap
, hibernation was successfully configured.
If you do not see any logs from these processes, your AMI might not support hibernation. For information about supported AMIs, see Prerequisites for Amazon EC2 instance hibernation. If you used your own Linux AMI, make sure that you followed the instructions for Configure a Linux AMI to support hibernation.
Windows Server 2016 and later
Check the EC2 launch log and look for messages that are related to
hibernation. To access the EC2 launch log, connect to the instance and
open the
C:\ProgramData\Amazon\EC2-Windows\Launch\Log\Ec2Launch.log
file in a text editor. If you're using EC2Launch v2, open
C:\ProgramData\Amazon\EC2Launch\log\agent.log
.
Note
By default, Windows hides files and folders under
C:\ProgramData
. To view EC2 Launch directories and
files, enter the path in Windows Explorer or change the folder properties to
show hidden files and folders.
Find the log lines for hibernation. If the log lines indicate a failure or the log lines are missing, there was most likely a failure configuring hibernation at launch.
For example, the following message indicates that hibernation failed to configure:
Message: Failed to enable hibernation.
If the error message
includes decimal ASCII values, you can convert the ASCII values to plain text in
order to read the full error message.
If the log line contains HibernationEnabled: true
, hibernation was
successfully configured.
Windows Server 2012 R2 and earlier
Check the EC2 config log and look for messages that are related to
hibernation. To access the EC2 config log, connect to the instance and
open the C:\Program
Files\Amazon\Ec2ConfigService\Logs\Ec2ConfigLog.txt
file in a
text editor. Find the log lines for SetHibernateOnSleep
. If the log
lines indicate a failure or the log lines are missing, there was most likely a
failure configuring hibernation at launch.
For example, the following message indicates that the instance root volume is not
large enough: SetHibernateOnSleep: Failed to enable hibernation: Hibernation
failed with the following error: There is not enough space on the
disk.
If the log line is SetHibernateOnSleep: HibernationEnabled: true
,
hibernation was successfully configured.
Windows instance size
If you’re using a T3 or T3a Windows instance with less than 1 GB of RAM, try increasing the size of the instance to one that has at least 1 GB of RAM.
Instance "stuck" in the stopping state
If you hibernated your instance and it appears "stuck" in the
stopping
state, you can forcibly stop it. For more information, see
Troubleshoot Amazon EC2 instance stop issues.
Can’t start Spot Instance immediately after hibernate
If you try to start a Spot Instance within two minutes of hibernating it, you might get the following error:
You failed to start the Spot Instance because the associated Spot Instance request is not in
an appropriate state to support start.
Wait for about two minutes for Linux instances and about five minutes for Windows instances and then retry starting the instance.
Resume Spot Instances failed
If your Spot Instance was hibernated successfully but failed to resume, and instead rebooted (a fresh restart where the hibernated state is not retained), it might be because the user data contained the following script:
/usr/bin/enable-ec2-spot-hibernation
Remove this script from the User data field in the launch template, and then request a new Spot Instance.
Note that even if the instance failed to resume, without the hibernated state
preserved, the instance can still be started in the same way as starting from the
stopped
state.