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