Mbaney at 16:10, 11 March 2026

2026-03-11T16:10:44Z

← Older revision		Revision as of 16:10, 11 March 2026
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 ~~http~~://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY></pre>		:<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 : ~~http~~://obj.umiacs.umd.edu		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 ~~http~~://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY> --api S3v2</pre>		** 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>

Ekr597: Created page

2025-09-11T18:38:18Z

Created page

New page

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 [[Modules|module tree]].
:<pre>module add mc</pre>
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 [[OBJ#LabGroups | LabGroup]]. You can find these in the [https://obj.umiacs.umd.edu/obj/user/ Object Store].

Running the following command to create the host "obj".
:<pre>mc config host add obj http://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>.

<pre>
$ mc config host ls
...
obj
URL : http://obj.umiacs.umd.edu
AccessKey : (redacted)
SecretKey : (redacted)
API : s3v4
Path : auto
...
</pre>

==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".
<pre>
$ 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
</pre>

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]].
* <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 http://obj.umiacs.umd.edu <ACCESS_KEY> <SECRET_KEY> --api S3v2</pre>

MinIO Client - Revision history

Mbaney at 16:10, 11 March 2026

Ekr597: Created page