Quick Guide - Linux OS

TABLE OF CONTENTS

• Creating a bucket 
• Creating a security key 
• Installing S3 to access your bucket
• Mounting a bucket
• Copy to bucket 
• Viewing the bucket
• Downloading a file from a bucket
• Deleting a file from a bucket

Creating a bucket 

See > how to create a bucket.

Creating a security key 

To create a key: open the BigStorage website > click on the hamburger icon to open the pages > select the keys page > add a key name, select the permission level and select 'Add key' 

For more information on naming conventions see: Bucket tag name and naming conventions.

The new key will be displayed on the keys page. The secret and access key can be found by selecting the icon under 'Reveal Keys'. Copy, and use this when you use your S3-Compatible client software to access the bucket.

Please note: You need to associate the security key to your buckets, for more information see > how do I grant access to the files in my bucket?

Installing S3 to access your bucket

1. ACCESS BUCKET - Install s3cmd with: 

   sudo apt-get update && sudo apt-get install s3cmd

   s3cmd --configure (setup access to s3)

2. CONFIGURE BUCKET
   • Access Key: ********
   • Secret Key: ***********
   • Default Region: Africa
   • S3 Endpoint: s3.bigstorage.io
   • DNS-style bucket+hostname:port template for accessing a bucket: %(bucket)s.s3.bigstorage.io
   • Encryption password: *********
   • Path to GPG program: /usr/bin/gpg
   • Use HTTPS protocol: True
   • HTTP Proxy server name:
   • HTTP Proxy server port: 0

You may also want to take at look at this site to check out other Linux packages: https://s3tools.org/repositories

Mounting a bucket

Install dependencies

apt-get install build-essential libfuse-dev libcurl4-openssl-dev libxml2-dev mime-support automake libtool

sudo apt install s3fs

echo ACCESS_KEY_ID:SECRET_ACCESS_KEY > ${HOME}/.passwd-s3fs
chmod 600 ${HOME}/.passwd-s3fs
s3fs mybucket /path/to/mountpoint -o passwd_file=${HOME}/.passwd-s3fs

s3fs <bucket-name> /mount/point -o use_path_request_style -o passwd_file=${HOME}/.passwd-s3fs,uid=`id -u`,umask=0077,mp_umask=0077 -o url=http://s3.bigstorage.io

fusermount -u /mount/point

Copy to bucket 

s3cmd put Pictures s3://bucket-name --recursive

Viewing the bucket

s3cmd ls s3://bucket-name

s3cmd ls s3://bucket-name/Pictures/

Downloading a file from a bucket

s3cmd get s3://bucket-name/<FILE_NAME> LOCAL_FILE

Deleting a file from a bucket

s3cmd del s3://bucket-name/<FILE_NAME>

Noticed a discrepancy or a bug? > Let Us Know!