Work with EC2Rescue for Linux - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Work with EC2Rescue for Linux

The following are common tasks you can perform to get started using this tool.

Run EC2Rescue for Linux

You can run EC2Rescue for Linux as shown in the following examples.

Example: Run all modules

To run all modules, run EC2Rescue for Linux with no options:

./ec2rl run

Some modules require root access. If you are not a root user, use sudo to run these modules as follows:

sudo ./ec2rl run
Example: Run a specific module

To run only specific modules, use the --only-modules parameter:

./ec2rl run --only-modules=module_name --arguments

For example, this command runs the dig module to query the amazon.com domain:

./ec2rl run --only-modules=dig --domain=amazon.com
Example: View the results

You can view the results in /var/tmp/ec2rl:

cat /var/tmp/ec2rl/logfile_location

For example, view the log file for the dig module:

cat /var/tmp/ec2rl/2017-05-11T15_39_21.893145/mod_out/run/dig.log

Upload the results

If Amazon Web Services Support has requested the results or to share the results from an S3 bucket, upload them using the EC2Rescue for Linux CLI tool. The output of the EC2Rescue for Linux commands should provide the commands that you need to use.

Example: Upload results to Amazon Web Services Support
./ec2rl upload --upload-directory=/var/tmp/ec2rl/2017-05-11T15_39_21.893145 --support-url="URLProvidedByAWSSupport"
Example: Upload results to an S3 bucket
./ec2rl upload --upload-directory=/var/tmp/ec2rl/2017-05-11T15_39_21.893145 --presigned-url="YourPresignedS3URL"

For more information about generating pre-signed URLs for Amazon S3, see Uploading Objects Using Pre-Signed URLs.

Create backups

Create a backup for your instance, one or more volumes, or a specific device ID using the following commands.

Example: Back up an instance using an Amazon Machine Image (AMI)
./ec2rl run --backup=ami
Example: Back up all volumes associated with the instance
./ec2rl run --backup=allvolumes
Example: Back up a specific volume
./ec2rl run --backup=volumeID

Get help

EC2Rescue for Linux includes a help file that gives you information and syntax for each available command.

Example: Display the general help
./ec2rl help
Example: List the available modules
./ec2rl list
Example: Display the help for a specific module
./ec2rl help module_name

For example, use the following command to show the help file for the dig module:

./ec2rl help dig