Upload images on Teklia's storage

Teklia provides a new service for uploading documents and images hosted with Ceph Object Gateway. It is much more similar to the standard IIIF upload but with some slight changes depending on the tool used. The account creation and the utilization of images after the upload is similar with the other Teklia's IIIF services.

Upload images using Cyberduck🔗

Cyberduck is a graphical application available on Microsoft Windows and Mac Os X.

1. install Cyberduck

2. start Cyberduck

3. open a new connection and configure it:

   • select Amazon S3 type
   • enter the server address: storage.teklia.com
   • enter your Access-Key
   • entrer your Secret access Key
   • select "More option" and add your bucket_name as Path
   • connect

4. you may be asked to enter your access key again at the first connection

• you can organize your files in folders (create folder option in cyberduck)

• you can now drag and drop files to upload them to Teklia storage servers

• you can check that the file are correctly transferred:

Upload images using WinSCP🔗

For Windows systems, you can use WinSCP which is also a graphical application for managing distant documents on S3 bucket.

1. install WinSCP

2. start WinSCP

3. Create a new connection and configure it:

   • select Amazon S3 protocol
   • enter the server address: storage.teklia.com
   • enter your Access-key
   • enter your Secret-key

• in advanced options, select Environment > S3, and change URL Style in Path instead of virtual-host.

• once you are connected, you need to select your bucket, click on Open directory/Bookmark or press Ctrl + O

• enter your and click ok to open your bucket

4. The left view represents your documents on your computer, the right one represents files in your bucket. Yu can upload by selecting documents and clicking Upload or with a drag and drop.

5. You can now create directories, list and delete documents.

Upload images using the Cyberduck CLI🔗

1. Install Cyberduck CLI using this documentation depending on which OS you are using https://trac.cyberduck.io/wiki/help/en/howto/cli
2. After installing the CLI, you should run the following command: duck --upload s3://storage.teklia.com/<your-bucket> <PATH to your data>
   • you should replace <your-bucket> with the name of your bucket
   • you should replace <PATH to your data> with the path to your data locally
3. You will be prompted to type your Access-Key which is your username
4. Once you provide your username, you will then be prompted to type your Secret access Key
5. The upload will then start and once it is done you will find your data in your bucket

Upload images using the Minio client mc🔗

1. Install the Minio client binary following the documentation https://docs.min.io/docs/minio-client-quickstart-guide.html
2. After installing the CLI, you should create an alias : mc alias set <alias-name> https://storage.teklia.com/ <access-key> <secret-key>
   • you should replace <alias-name> with the name you want to use to call this specific service.
   • you should replace <access-key> and <secret-key> with your credentials
3. You can now list buckets and documents with the following command : mc ls <alias-name>/<bucket-name>/<PATH>
4. You can upload your files with the mirror command mc mirror <your-file-or-directory> <alias-name>/<bucket-name>/<PATH>
5. In order to download files, you can use cp command: mc cp <alias-name>/<bucket-name>/<PATH> <your-file-or-directory>