ec2-consistent-snapshot release 0.1-9

| 9 Comments | 0 TrackBacks | Bookmark and Share

Thanks to everybody who submitted bug reports and feature requests for ec2-consistent-snapshot, software which can be used to create consistent EBS snapshots on Amazon EC2 especially for use with XFS and/or MySQL.

A new release (0.1-9) has been published to the Alestic PPA. This release provides the following fixes and enhancements:

  • Read MySQL “host” parameter from .my.cnf if provided. (closes: bug#485978)

  • Support quoted values in .my.cnf (closes: bug#454184)

  • Require Net::Amazon::EC2 version 0.11 or higher. (closes: bug#490686)

  • Require xfsprogs package. (closes: bug#493420)

  • Replace “/etc/init.d/mysql stop” with “mysqladmin shutdown”. (closes: bug#497557)

  • Document —description option which was added earlier. (closes: bug#487692)

If you already have ec2-consistent-snapshot installed, you can upgrade using commands like:

sudo apt-get update
sudo apt-get install ec2-consistent-snapshot

If you don’t yet have the Alestic PPA set up, run these commands first:

codename=$(lsb_release -cs)
echo "deb http://ppa.launchpad.net/alestic/ppa/ubuntu $codename main"|
  sudo tee /etc/apt/sources.list.d/alestic-ppa.list    
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BE09C571

If you find bugs or think of feature requests, please submit them.

No TrackBacks

TrackBack URL: http://alestic.com/mt/mt-tb.cgi/62

9 Comments

Eric,

Thanks for all the great work with this utility. I'm using it in several production systems. It's been a real time saver

-David

Thanks for creating this as well as everything else you've created. Very helpful for developers trying to get started with serious EC2 setups. I've tried to create my first snapshot using this script. I have a mysql database running on a raid of 4 volumes. This database is slaving from another. When I run ec2-consistent-snapshot, I get the following:

ec2-consistent-snapshot \
> --region us-east-1 \
> --xfs-filesystem /mnt/db \
> --mysql \
> vol-1 vol-2 vol-3 vol-4
ec2-consistent-snapshot: master_log_file="mysql-bin.000467", master_log_pos=98
ec2-consistent-snapshot: ERROR: create_snapshot: Attribute (progress) does not pass the type constraint because: Validation failed for 'Str' failed with value undef at /usr/local/share/perl/5.10.0/Net/Amazon/EC2.pm line 828
Net::Amazon::EC2::create_snapshot(undef, 'VolumeId', 'vol-1', 'Description', 'ec2-consistent-snapshot') called at /usr/bin/ec2-consistent-snapshot line 136
eval {...} called at /usr/bin/ec2-consistent-snapshot line 134
main::ebs_snapshot('ARRAY(0xa34dc50)', 'us-east-1', 'ec2-consistent-snapshot') called at /usr/bin/ec2-consistent-snapshot line 90

Yes, I changed the volume ids above. The first snapshot gets created, but everything else dies. Any thoughts?

myles: This is a known defect in Net::Amazon::EC2 version 0.12. Jeff Kim is releasing a new version which will correct this problem, so keep an eye on CPAN and upgrade when it's available.
http://search.cpan.org/~jkim/Net-Amazon-EC2/

Hello,

Thanks for creating this tool. I am planning to use it to backup my ubuntu EC2 instance.

I have been getting errors with and without using sudo. With sudo, it throws up error about keys and takes no snapshot. Without sudo, it throws up error about xfs_freeze, but does creates a snapshot.

Any help will be much appreciated.

regards,

anil


ubuntu@domU-12-31-38-00-0D-41:/mnt2/aks$ sudo ec2-consistent-snapshot --xfs-filesystem /mnt2 --description "mnt2 source" vol-f3ba039a
ec2-consistent-snapshot: ERROR: Can't find AWS access key or secret access key at /usr/bin/ec2-consistent-snapshot line 76.
xfs_freeze: cannot unfreeze filesystem mounted at /mnt2: Invalid argument
ec2-consistent-snapshot: ERROR: xfs_freeze -u /mnt2: failed(256)

ubuntu@domU-12-31-38-00-0D-41:/mnt2/aks$ ec2-consistent-snapshot --xfs-filesystem /mnt2 --description "mnt2 source" vol-f3ba039a
xfs_freeze: cannot freeze filesystem at /mnt2: Operation not permitted
ec2-consistent-snapshot: ERROR: xfs_freeze -f /mnt2: failed(256)
snap-7c432e14
xfs_freeze: cannot unfreeze filesystem mounted at /mnt2: Operation not permitted
ec2-consistent-snapshot: ERROR: xfs_freeze -u /mnt2: failed(256)

Anil:

By default sudo will clear your environment which may include the pointers to your AWS credentials.

Try adding the -E option to pass environment variables in to the command:

sudo -E ec2-consistent-snapshot [...]

Alternatively, you could put your AWS credentials in one of the files that ec2-consistent-snapshot looks for.

Much gratitude for all your work Eric - you're a titan openness and developer education.

Question:

I have a 10.04 EBS boot AMI with a single XFS-formatted root volume containing a LAMP stack. I want to snap the entire root file system (including MySQL) for backup purposes, and it's working using:

sudo ec2-consistent-snapshot --aws-access-key-id XXXXXXXXXXXXXX --aws-secret-access-key XXXXXXXXXXXXXX --xfs-filesystem / --description "root_snapshot $(date +'%Y-%m-%d %H:%M:%S')" vol-XXXXXXX

Do I gain any benefit/consistency by including the --mysql option, or the mysql username and password options? Or is it unnecessary because I'm snapping the entire root file system?

Thanks again.

Ben

Ben: The --mysql option causes ec2-consistent-snapshot to flush the database changes to disk before initiating the snapshot. This helps ensure that the database files are consistent.

We have been using a precursor of this technique in a production system for about 18 months. Suddenly MySQL started "going away" with clockwork every time the script ran. MySQL support concluded "the 'SYSTEM ec2-create-snapshot $VOLUME_NAME' did not return in a hurry / got suck and hence filesystem access stayed suspended."

A reboot of the server was necessary to recover.

Is this something others have experienced? Is this potential lockup solved with ec2-consistent-snapshot?

The exact script we were running is:

#!/bin/sh
export EC2_HOME=/root/ec2-api-tools-1.3-24159
export EC2_PRIVATE_KEY=/root/.ec2/pk-*********.pem
export EC2_CERT=/root/.ec2/cert-********.pem
export JAVA_HOME=/usr/lib/jvm/java-6-openjdk
export PATH=$PATH:$EC2_HOME/bin
MYSQLUSER=UUUUUUU
MYSQLPASS=PPPPPPP

# Obtain instance data
INSTANCE_NAME=`curl -s http://169.254.169.254/2008-02-01/meta-data/instance-id`
echo "Instance: $INSTANCE_NAME"
VOLUME_NAME=`ec2-describe-volumes | grep $INSTANCE_NAME | grep -o "vol-\S*"`
echo "Volume: $VOLUME_NAME"
VOLUME_LOCATION=/mnt/data

mysql -u$MYSQLUSER -p$MYSQLPASS FLUSH TABLES WITH READ LOCK;
SHOW MASTER STATUS;
SYSTEM xfs_freeze -f /mnt/data
SYSTEM ec2-create-snapshot $VOLUME_NAME
SYSTEM xfs_freeze -u /mnt/data
UNLOCK TABLES;
EXIT
EOF

# Delete older snapshots (oldest 2).
NUMBER_SNAPSHOTS=`ec2-describe-snapshots | grep $VOLUME_NAME | wc -l` echo "Snapshots: $NUMBER_SNAPSHOTS"
if [ "$NUMBER_SNAPSHOTS" -gt "200" ]; then
# Delete oldest two.
ec2-describe-snapshots | grep $VOLUME_NAME | sort -k 5 | head -2 | awk '{print "Deleting: " $2; system("ec2-delete-snapshot " $2)}'
#ec2-describe-snapshots | grep $VOLUME_NAME | sort -k 5 | head -2 | awk '{print "Deleting: " $2}'
fi

Eric:

ec2-consistent-snapshot may help avoid the locking problem. The script has a lot of timeout and retry operations to prevent issues like this.

Leave a comment

Stay Updated

Subscribe with email address:
 Subscribe with a reader
Join the EC2 Ubuntu Google Group
Follow Eric Hammond on Twitter

More Entries

Move a Running EBS Boot Instance to New Hardware on Amazon EC2
Amazon EC2 has been experiencing some power issues in a portion of one of their many data centers. Even though…
One Weekend to Prototype CrowdPhoto.net using AWS Technologies
On Friday evening (2 days ago) I and a number of other high octane LA individuals came to LA StartupWeekend…
Ubuntu AMIs available for Amazon EC2 in Asia Pacific (Singapore)
Amazon EC2 just launched the Asia Pacific region with data centers in Singapore. The standard Ubuntu and Debian AMIs (Amazon…
Ubuntu 10.04 Lucid Released for Amazon EC2
Ubuntu 10.04 Lucid was released on Amazon EC2 right on schedule today along with the rest of the normal Ubuntu…
Upgrading Servers to Ubuntu 10.04 Lucid on Amazon EC2
Ubuntu 10.04 Lucid is expected to be released this Thursday (April 29, 2010). This is the first LTS (long term…
Identifying When a New EBS Volume Has Completed Initialization From an EBS Snapshot
On Amazon EC2, you can create a new EBS volume from an EBS snapshot using a command like ec2-create-volume --availability-zone…
New releases of Ubuntu and Debian Images for Amazon EC2 (20100319)
Note: I do not recommend that new users start with these AMIs. These AMIs run with older versions of Amazon’s…
SCALE 8x Talk Notes: EC2 Beginners Workshop
At SCALE 8x (Southern California Linux Expo, Feb 2010) I did a walkthrough demonstrating how to use the AWS console…
The BitSource Interview of Eric Hammond (SCALE, EC2)
Matthew Sacks, of The BitSource, made the mistake of asking me some questions about Amazon EC2, so I rambled on…
Resizing the Root Disk on a Running EBS Boot EC2 Instance
In a previous article I described how to run an EBS boot AMI with a larger root disk size than…
New Ubuntu 8.04.3 Hardy AMIs for Amazon EC2
Scott Moser (Canonical) built and released new Ubuntu 8.04.3 LTS Hardy images and AMIs for Amazon EC2. I also published…
Southern California Linux Expo - Februrary 19-21, 2010 at the Westin LAX
The 8th Southern California Linux Expo (aka SCaLE 8x) is a community organized, non-profit event. Those words and the…
Public EBS Boot AMIs for Ubuntu on Amazon EC2
If you’ve been following along, you probably know that I have been recommending that folks using EC2 switch to the…
How to Report Bugs with Ubuntu on Amazon EC2: ubuntu-bug
The official Ubuntu AMIs published by Canonical for EC2 starting in October have proven to be solid and production worthy.…
Three Ways to Protect EC2 Instances from Accidental Termination and Loss of Data
Here are a few little-publicized benefits that were launched with Amazon EC2’s new EBS boot instances: You can lock them…
Building EBS Boot AMIs Using Canonical's Downloadable EC2 Images
In the last article, I described how to use the vmbuilder software to build an EBS boot AMI from scratch…
Building EBS Boot and S3 Based AMIs for EC2 with Ubuntu vmbuilder
Here’s my current recipe for how to build an Ubuntu 9.10 Karmic AMI, either the new EBS boot or the…
Call for testers (building EBS boot AMIs with Ubuntu vmbuilder)
I’m polishing up an article about how to build images from scratch with Ubuntu vmbuilder, both for S3 based AMIs…
ec2-consistent-snapshot release 0.1-9
Thanks to everybody who submitted bug reports and feature requests for ec2-consistent-snapshot, software which can be used to create consistent…
Listing Recent Prices for EC2 Spot Instances
The new spot instances on EC2 are a great way to get some extra compute power at a price you…