MinIO Client
The MinIO Client is a comprehensive single binary (Go) command line client for cloud based storage services.
Installing the MinIO Client(mc)
mc is available on all UMIACS-supported RHEL machines through adding it via our software module tree.
module add mc
For other operating systems or non UMIACS-supported hosts, the instructions to download and install it are found at https://docs.min.io/enterprise/aistor-object-store/reference/cli/#quickstart.
Setup the MinIO Client(mc)
To connect to Obj you'll need to configure mc by adding a host with your ACCESS_KEY and SECRET_KEY.
- The ACCESS_KEY and SECRET_KEY can either be for your personal account or a LabGroup. You can find these in the Object Store.
Running the following command to create the host "obj".
mc config host add obj http://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY>
You can see what host(s) you have configured with the command mc config host ls
.
$ mc config host ls ... obj URL : http://obj.umiacs.umd.edu AccessKey : (redacted) SecretKey : (redacted) API : s3v4 Path : auto ...
Running the MinIO Client(mc)
To use most commands, specify the host you created and bucket name. For example the following to list the contents of the bucket "iso".
$ mc ls obj/iso [2017-02-10 16:45:04 EST] 3.5GiB rhel-server-7.3-x86_64-dvd.iso [2017-02-13 12:21:33 EST] 4.0GiB rhel-workstation-7.3-x86_64-dvd.iso
The full MinIO Client documentation can be found here: https://docs.min.io/enterprise/aistor-object-store/reference/cli/#command-quick-reference.
Troubleshooting
If you receive an error message, please check if it matches one of the error messages below. If you don't see the error message below, please reach out to the HelpDesk.
- The provided 'x-amz-content-sha256' header does not match what was computed.
- The MinIO Client has issues handling empty files. You can have it use an older api to handle these files by re-running the config command and specifying the api.
mc config host add obj http://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY> --api S3v2
- The MinIO Client has issues handling empty files. You can have it use an older api to handle these files by re-running the config command and specifying the api.