Upload images on Teklia's ceph.iiif

    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: ceph.iiif.teklia.com
      • enter your Access-Key
      • entrer your Secret access Key
      • select "More option" and add your bucket_name as Path
      • connect
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    1. you may be asked to enter your access key again at the first connection
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    • you can organize your files in folders (create folder option in cyberduck)
    Create folder in cyberduck
    Create folder in cyberduck
    • you can now drag and drop files to upload them to Teklia storage servers
    Import files in cyberduck
    Import files in cyberduck
    • you can check that the file are correctly transferred:
    Check imported files in cyberduck
    Check imported files in cyberduck

    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: ceph.iiif.teklia.com
      • enter your Access-key
      • enter your Secret-key
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    • in advanced options, select Environment > S3, and change URL Style in Path instead of virtual-host.
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    • once you are connected, you need to select your bucket, click on Open directory/Bookmark or press Ctrl + O
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    • enter your and click ok to open your bucket
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    1. 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.
    Cyberduck settings for ceph.iiif.teklia.com
    Cyberduck settings for ceph.iiif.teklia.com
    1. 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://ceph.iiif.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://ceph.iiif.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. In order to upload files, you can use mirror command: mc mirror <alias-name>/<bucket-name>/<PATH> <your-file-or-directory>
    5. You can also upload your files with the same command mc mirror <your-file-or-directory> <alias-name>/<bucket-name>/<PATH>