Setup an object storage client

Prerequisites

Object Storage access credentials
You can generate credentials by following the steps described in Create Object Storage credentials.

Setup of an Object Storage Client

Install s3cmd client

To install thes3cmdclient you can follow the steps in the official installation guide.

After the installation you can run the following command to ensure the client is installed correctly:

s3cmd --version

You should receive back output with the version of installed client. This guide is based on the version 2.2.0.

Configure your client: make settings

In order to use the s3cmd you need to specify the settings to interact with your Object Storage Service. The client supports you with configuration wizard.

Run the following command to launch an interactive form.

s3cmd --configure

It will ask you for the following information:

Configure your client: test your settings

After defining all parameters, the new settings will be presented to you. If they look correct you can test it by enteringY.

New settings: Access Key:  Secret Key:  Default Region: US S3 Endpoint: object.storage.eu01.onstackit.cloud DNS-style bucket+hostname:port template for accessing a bucket: object.storage.eu01.onstackit.cloud/%(bucket) Encryption password: Path to GPG program: /usr/bin/gpg Use HTTPS protocol: True HTTP Proxy server name: HTTP Proxy server port: 0 Test access with supplied credentials? [Y/n] y

Configure your client: save your configuration

If the test was successful, you should see this output. You can save the new configuration by enteringy.

Please wait, attempting to list all buckets... Success. Your access key and secret key worked fine:-) Now verifying that encryption works... Not configured. Never mind. Save settings? [y/N] y

Now your client is successfully configured and can be used to manage your Object Storage Service. The created configuration files is named.s3cfgand is stored in your home directory.

You can add / modify options if needed on the.s3cfg file. For a list of all available parameters on the.s3cfg see the official documentation