UMobj: Difference between revisions

From UMIACS
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
The UMobj suite of utilities support command line access to UMIACS Object Stores.  UMobj is best suited to large numbers of file operations, like uploading or downloading thousands of files at once.  In addition, each Object Store has a fully-featured web application that allows you convenient access to your files from a web browser.
The UMobj suite of utilities provide command-line access to UMIACS Object Stores.  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)
==Supported object storage clusters==
* https://obj.umiacs.umd.edu/obj
* https://obj.umiacs.umd.edu/obj
* https://gembox.cbcb.umd.edu/gembox
* https://gembox.cbcb.umd.edu/gembox
For UMIACS-supported linux machines, these utilities are already installed.


==Setup==
==Setup==
Setting a few environmental variables containing your credentials you'll need to
We highly recommend setting a few environmental variables containing your credentials for
use for the Object Store is a good idea.  When logged into the
convenience.  When logged into the Object Store web interface (see list above), you can
web interface, you can find these credentials on the user page.  E.g.
find these credentials on the user page.  E.g. https://obj.umiacs.umd.edu/obj/user/
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
For example, if you use the <tt>bash</tt> shell, you can add something like the following to your

Revision as of 15:36, 9 March 2018

The UMobj suite of utilities provide command-line access to UMIACS Object Stores. 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)

Supported object storage clusters

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.