MinIO Client: Difference between revisions
Created page |
No edit summary |
||
| Line 11: | Line 11: | ||
Running the following command to create the host "obj". | Running the following command to create the host "obj". | ||
:<pre>mc config host add obj | :<pre>mc config host add obj https://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY></pre> | ||
You can see what host(s) you have configured with the command <code>mc config host ls</code>. | You can see what host(s) you have configured with the command <code>mc config host ls</code>. | ||
| Line 19: | Line 19: | ||
... | ... | ||
obj | obj | ||
URL : | URL : https://obj.umiacs.umd.edu | ||
AccessKey : (redacted) | AccessKey : (redacted) | ||
SecretKey : (redacted) | SecretKey : (redacted) | ||
| Line 40: | Line 40: | ||
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]]. | 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]]. | ||
* <i>The provided 'x-amz-content-sha256' header does not match what was computed.</i> | * <i>The provided 'x-amz-content-sha256' header does not match what was computed.</i> | ||
** 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. <pre>mc config host add obj | ** 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. <pre>mc config host add obj https://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY> --api S3v2</pre> | ||
Latest revision as of 16:10, 11 March 2026
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 https://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 : https://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 https://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.