Orchesto is a multi-point object storage gateway compatible with the Amazon S3 API.
Table of contents
1. Start the service
To use Orchesto the first time, you need to explicitly accept the End-User License Agreement (EULA) by setting the
ACCEPT_EULA environment variable to
Y. Then, start Orchesto like so:
2. Setup using the browser
Go to the management console in your web browser:
Replace 127.0.0.1 with the IP address that works for you.
The first time you visit the management console, you see the welcome page with the admin access keys. This security credential allows you to use and manage the Orchesto object storage service, as well as create new security credentials.
Make sure you store the admin access keys in a secure location. Then, select Continue to access the dashboard.
The dashboard shows the current status of the server and connected storage providers. Select Add backend to connect a new storage provider.
On the left-hand side of the management console is the sidebar, which provides access to all principle management functions such as the dashboard.
Access the object browser by selecting Buckets in the sidebar. Then, to make all buckets you access in the storage provider available through Orchesto, select Add Virtual Bucket and choose Add All under the Backing Bucket input field.
You can connect to any number of storage providers and make any combination of buckets available through the gateway.
Orchesto is compatible with the Amazon S3 API, so you can use any Amazon S3 compatible client to upload and download data. Configure the client with the object storage endpoint and credentials to get started.
The object storage endpoint is the same as the management console in your web browser:
For example, the AWS Command Line Interface (CLI) can be configured with your Orchesto credentials like so:
$ aws configure AWS Access Key ID [None]: EUMOATRNYXRBLOKNXYD8 AWS Secret Access Key [None]: KTRUdnMAskpCc7ph/8Om0muMYYcRcxT4H7Kel3ZU Default region name [None]: Default output format [None]:
Then, include the object storage endpoint via the
--endpoint-url option when you use the AWS CLI.
$ aws s3 ls --endpoint-url http://127.0.0.1:9090 2018-05-17 10:14:27 acropolitan 2018-05-17 10:14:32 concretely 2018-05-17 10:14:32 confabulate 2018-05-17 10:14:31 cylindrocellular 2018-05-17 10:14:27 debasingly 2018-05-17 10:14:28 distinctiveness 2018-05-17 10:14:31 huari 2018-05-17 10:14:31 inexactitude 2018-05-17 10:14:33 nonbotanical 2018-05-17 10:14:31 olefinic 2018-05-17 10:14:32 overbulk 2018-05-17 10:14:27 poligraphical 2018-05-17 10:14:31 polyopic 2018-05-17 10:14:31 potful 2018-05-17 10:14:33 rutherfordite 2018-05-17 10:14:27 sportsmanlike 2018-05-17 10:14:27 suprachorioidal 2018-05-17 10:14:32 unsymbolically