Home

Info about the glacier client

To start the glacier client you need to install Java. You can download it here:

http://www.java.com/de/download/

Glacier is a command line client. You start it with

java -jar glacier.jar

Before you can use the glacier client you have to configure it with the command:

java -jar glacier.jar configure

It will ask you for your Amazon AWS access key and secret key. This data will be saved to the file .awscredentials in your home directory.

If you don't add any arguments it will print out a short help text. Right now it supports 5 commands (put, get, delete, getinv, configure) and 5 options (--vault, --file, --id, --description, --region). The command has to be the first argument, the options can be given in any order.

Commands:

put
Puts an archive onto amazon glacier. In order to do so it needs at least the options --vault and --file. If no description is given glacier uses the filename as description.

get
Gets an archive from amazon glacier. It needs the options --vault, --id and --file.

delete
Deletes an archive on amazon glacier. It needs the options --vault and --id.

getinv
Retrieves a vaults inventory. It needs the option --vault. If no filename (--file) is given glacier uses <vault>_inventory.txt instead.</vault>

configure
Creates the file .awscredentials in your home directrory. You have to enter you amazon aws access key and your secret key. No options needed here.

Options:

--vault
The amazon glacier vault you want to access.

--file
Filename that is used for put, get or getinv commands.

--id
Archive id used to get or delete archives.

--description
Description uploaded together with you archive. If no description is given glacier uses the filename of your upload.

--region
Amazon AWS region you use. Default is "us-east-1".

Examples

** ATTENTION: Downloading archives and inventories from Amazon Glacier takes A LOT OF TIME. You'll probably have to wait 3 to 5 hours before your download even starts!!!**

Upload a zip file to vault MyVault on Amazon Glacier:

java -jar glacier.jar put --vault MyVault --file MyHolidayPictures.zip

Retrieve a vaults inventory:

java -jar glacier.jar getinv --vault MyVault