Skip to content

Latest commit

 

History

History
30 lines (24 loc) · 1.51 KB

README.md

File metadata and controls

30 lines (24 loc) · 1.51 KB

aws-s3-speed

A project we use in www.takipi.com to test upload speeds to Amazon Simple Storage Service (S3) regions.

Installation

a. Fork / Get the code and run
mvn clean compile assembly:single
b. Download latest snapshot
https://s3.amazonaws.com/app-takipi-com/tests/aws-s3-speed-0.0.6-jar-with-dependencies.jar

Usage

You will need your AWS access keys.
Make sure you have buckets in all AWS regions or use the CREATE mode.
The prefix and suffix are concatenated to the bucket name such as: aws-speed-test-eu-1-06-mar-2013
java -jar aws-s3-speed-0.0.6-jar-with-dependencies.jar AWS_KEY AWS_SECRET PREFIX SUFFIX

Running the test:
Use the RUN mode (make sure AWS access keys, prefix and suffix are the same as when you run it with CREATE
The reason it's a two way process is because you should wait a few minutes before running the test to make sure the DNS servers will easily find all your buckets around the world and won't affect the first round of the test.

Cleanup buckets:
Use DELETE mode to remove buckets

ROUNDS: Number of rounds to test, usually 12 (since we remove the best and worst scores before averaging)
SIZE: SMALL=1KB, MEDIUM=5MB, BIG=10MB, HUGE=100MB
METHOD:
SDK = Uses AWS SDK S3Client putObject (uses HttpClient).
PLAIN = Sign a link and uses plain HttpsURLConnection output stream
java -jar aws-s3-speed-0.0.6-jar-with-dependencies.jar RUN AWS_KEY AWS_SECRET PREFIX SUFFIX ROUNDS BIG SDK