Difference between revisions of "UMobj"

From UMIACS
Jump to navigation Jump to search
m (Derek moved page UMobj to Umobj)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This is a set of console utilities that are available on all UMIACS-supported Linux (RHEL5, RHEL6, Ubuntu) machines.  They are provided to support our [http://ceph.com Ceph] Object Stores so that our users may interact with them on the command line.   In addition, each Ceph Object Store in UMIACS has a fully-functional web application that allows access to your storage from a web browser.
+
The UMobj suite of utilities provide command-line access to the [https://obj.umiacs.umd.edu/obj UMIACS Object Store].  UMobj is preinstalled on all UMIACS-supported Linux machines.
  
For UMIACS-supported linux machines, these utilities are already installed and should be available in the standard [[PATH]].
+
==When to use UMobj==
 +
Use umobj if:
 +
* you have a large number of files to upload (hundreds or thousands of files)
 +
* you are uploading large files (files greater than 4GB in size)
  
For more information see the [[GitLab]] page for [https://gitlab.umiacs.umd.edu/staff/umobj/tree/master umobj].
+
==Setup==
 +
We highly recommend setting a few environmental variables containing your credentials for
 +
convenience.  When logged into the Object Store web interface (see list above), you can
 +
find these credentials on the user page.  E.g. https://obj.umiacs.umd.edu/obj/user/
 +
 
 +
For example, if you use the <tt>bash</tt> shell, you can add something like the following to your
 +
<tt>.bashrc</tt> or <tt>.bash_profile</tt>.
 +
 
 +
<pre>
 +
export OBJ_ACCESS_KEY_ID="31sdfadDFAHFDN+344qOEIS"
 +
export OBJ_SECRET_ACCESS_KEY="NDSMK3233adfahadflkkPDSH092DSJKDKDJKFDLSFLNK"
 +
export OBJ_SERVER="obj.umiacs.umd.edu"
 +
</pre>
 +
 
 +
Or in tcsh you can do the following or add it into your <tt>.tcshrc</tt>.
 +
 
 +
<pre>
 +
setenv OBJ_ACCESS_KEY_ID "31sdfadDFAHFDN+344qOEIS"
 +
setenv OBJ_SECRET_ACCESS_KEY "NDSMK3233adfahadflkkPDSH092DSJKDKDJKFDLSFLNK"
 +
setenv OBJ_SERVER "obj.umiacs.umd.edu"
 +
</pre>
 +
 
 +
==Detailed Usage==
 +
For an example of how to use UMobj, please see [[UMobj/Example]].
 +
 
 +
For complete usage information, please see the [[GitLab]] page for [https://gitlab.umiacs.umd.edu/staff/umobj/blob/master/README.md#umobj umobj].

Latest revision as of 16:28, 4 January 2021

The UMobj suite of utilities provide command-line access to the UMIACS Object Store. UMobj is preinstalled on all UMIACS-supported Linux machines.

When to use UMobj

Use umobj if:

  • you have a large number of files to upload (hundreds or thousands of files)
  • you are uploading large files (files greater than 4GB in size)

Setup

We highly recommend setting a few environmental variables containing your credentials for convenience. When logged into the Object Store web interface (see list above), you can find these credentials on the user page. E.g. https://obj.umiacs.umd.edu/obj/user/

For example, if you use the bash shell, you can add something like the following to your .bashrc or .bash_profile.

export OBJ_ACCESS_KEY_ID="31sdfadDFAHFDN+344qOEIS"
export OBJ_SECRET_ACCESS_KEY="NDSMK3233adfahadflkkPDSH092DSJKDKDJKFDLSFLNK"
export OBJ_SERVER="obj.umiacs.umd.edu"

Or in tcsh you can do the following or add it into your .tcshrc.

setenv OBJ_ACCESS_KEY_ID "31sdfadDFAHFDN+344qOEIS"
setenv OBJ_SECRET_ACCESS_KEY "NDSMK3233adfahadflkkPDSH092DSJKDKDJKFDLSFLNK"
setenv OBJ_SERVER "obj.umiacs.umd.edu"

Detailed Usage

For an example of how to use UMobj, please see UMobj/Example.

For complete usage information, please see the GitLab page for umobj.