UMIACS - User contributions [en]

ConferenceRooms/Recording

2019-09-26T16:21:09Z

Jowenscs: /* Conference Quick Setup */

==Background==
[https://obsproject.com/ Open Broadcaster Software (OBS)] is free and open source software for video recording and live streaming. It is simple to set up and highly customizable. At UMIACS, it is the software we recommend to users looking to either record or stream on either their personal computers or in a conference room or auditorium setting.

==Conference Quick Setup==
Below are steps outlining how to start recording or streaming your meetings. If, at any point, you have questions or need other assistance, feel free to reach out to the [[HelpDesk | UMIACS Help Desk]].
# Select the source you'd like to route to the computer via the "Shared Media" option on the Crestron control panel. This will route the source through the A/V Bridge to the conference room computer.
# [https://github.com/obsproject/obs-studio/releases Download (windows zip file)] and/or launch OBS on the conference room computer and do not run the auto-configuration wizard.
# Set up video.
## Click the + under the Sources pane at the bottom and select Video Capture Device. Leave everything at default and hit OK.
## Ensure the proper device is selected to get the video to show up. In larger conference rooms and auditoriums with an A/V cabinet, this will usually be called 'AV Bridge'.
## Click OK and resize the window to take up the entirety of the canvas.
## If the output appears blurry or fuzzy, try setting the Resolution/FPS Type to Custom by right clicking the source -> Properties and changing it from Device Default. '''This seems to be particularly important in the larger conference rooms and auditoriums, as the A/V stack's default resolution is not the highest supported one (720p).''' Change resolution to the highest available one. You probably want to leave FPS at Match Output FPS.
# Ensure audio settings look OK.
#* The default microphone for the system should already be set up to record audio. It is listed as Mic/Aux under the Mixer pane at the bottom. If you want to use an alternate microphone, click on the cog -> Properties and change the device.
#* Keep in mind that by default, Desktop Audio is recorded as well. If the user running the conference expects to play media during the conference that they do not want being picked up in the stream or recording itself, click the megaphone icon under Desktop Audio by default to mute it.
# Set up either streaming, recording, or both as follows.

'''Streaming''':
# Go to File -> Settings -> Stream and select the service you want to use (99% of the time probably YouTube or Twitch).
# Locate your stream key for the account you want to use. For YouTube/Twitch, there is a helpful link right there that takes you to the proper place to get this.
#* YouTube: https://www.youtube.com/live_dashboard, near the bottom
#* Twitch: https://www.twitch.tv/username/dashboard/settings, at the top (replace username with your username). You can also link your account directly if you want.
# Enter your key and hit OK.
# Click Start Streaming under the Control pane at the bottom.

'''Recording''':
# Go to File -> Settings -> Output and change the recording path to something appropriate and click OK. If in a conference room, this should be an external SSD or the internal drive. We have observed that using external HDDs may introduce dropped frames due to encoding lag because of I/O bottlenecks.
# Click Start Recording under the Control pane at the bottom.

ConferenceRooms/Recording

2019-09-26T16:20:30Z

Jowenscs: /* Conference Quick Setup */

==Background==
[https://obsproject.com/ Open Broadcaster Software (OBS)] is free and open source software for video recording and live streaming. It is simple to set up and highly customizable. At UMIACS, it is the software we recommend to users looking to either record or stream on either their personal computers or in a conference room or auditorium setting.

==Conference Quick Setup==
Below are steps outlining how to start recording or streaming your meetings. If, at any point, you have questions or need other assistance, feel free to reach out to the [[UMIACS Help Desk | HelpDesk]].
# Select the source you'd like to route to the computer via the "Shared Media" option on the Crestron control panel. This will route the source through the A/V Bridge to the conference room computer.
# [https://github.com/obsproject/obs-studio/releases Download (windows zip file)] and/or launch OBS on the conference room computer and do not run the auto-configuration wizard.
# Set up video.
## Click the + under the Sources pane at the bottom and select Video Capture Device. Leave everything at default and hit OK.
## Ensure the proper device is selected to get the video to show up. In larger conference rooms and auditoriums with an A/V cabinet, this will usually be called 'AV Bridge'.
## Click OK and resize the window to take up the entirety of the canvas.
## If the output appears blurry or fuzzy, try setting the Resolution/FPS Type to Custom by right clicking the source -> Properties and changing it from Device Default. '''This seems to be particularly important in the larger conference rooms and auditoriums, as the A/V stack's default resolution is not the highest supported one (720p).''' Change resolution to the highest available one. You probably want to leave FPS at Match Output FPS.
# Ensure audio settings look OK.
#* The default microphone for the system should already be set up to record audio. It is listed as Mic/Aux under the Mixer pane at the bottom. If you want to use an alternate microphone, click on the cog -> Properties and change the device.
#* Keep in mind that by default, Desktop Audio is recorded as well. If the user running the conference expects to play media during the conference that they do not want being picked up in the stream or recording itself, click the megaphone icon under Desktop Audio by default to mute it.
# Set up either streaming, recording, or both as follows.

'''Streaming''':
# Go to File -> Settings -> Stream and select the service you want to use (99% of the time probably YouTube or Twitch).
# Locate your stream key for the account you want to use. For YouTube/Twitch, there is a helpful link right there that takes you to the proper place to get this.
#* YouTube: https://www.youtube.com/live_dashboard, near the bottom
#* Twitch: https://www.twitch.tv/username/dashboard/settings, at the top (replace username with your username). You can also link your account directly if you want.
# Enter your key and hit OK.
# Click Start Streaming under the Control pane at the bottom.

'''Recording''':
# Go to File -> Settings -> Output and change the recording path to something appropriate and click OK. If in a conference room, this should be an external SSD or the internal drive. We have observed that using external HDDs may introduce dropped frames due to encoding lag because of I/O bottlenecks.
# Click Start Recording under the Control pane at the bottom.

ConferenceRooms/Recording

2019-09-26T16:05:33Z

Jowenscs: Created page with "==Background== [https://obsproject.com/ Open Broadcaster Software (OBS)] is free and open source software for video recording and live streaming. It is simple to set up and hi..."

==Background==
[https://obsproject.com/ Open Broadcaster Software (OBS)] is free and open source software for video recording and live streaming. It is simple to set up and highly customizable. At UMIACS, it is the software we recommend to users looking to either record or stream on either their personal computers or in a conference room or auditorium setting.

==Conference Quick Setup==
# Select the source you'd like to route to the computer via the "Shared Media" option on the Crestron control panel. This will route the source through the A/V Bridge to the conference room computer.
# [https://github.com/obsproject/obs-studio/releases Download (windows zip file)] and/or launch OBS on the conference room computer and do not run the auto-configuration wizard.
# Set up video.
## Click the + under the Sources pane at the bottom and select Video Capture Device. Leave everything at default and hit OK.
## Ensure the proper device is selected to get the video to show up. In larger conference rooms and auditoriums with an A/V cabinet, this will usually be called 'AV Bridge'.
## Click OK and resize the window to take up the entirety of the canvas.
## If the output appears blurry or fuzzy, try setting the Resolution/FPS Type to Custom by right clicking the source -> Properties and changing it from Device Default. '''This seems to be particularly important in the larger conference rooms and auditoriums, as the A/V stack's default resolution is not the highest supported one (720p).''' Change resolution to the highest available one. You probably want to leave FPS at Match Output FPS.
# Ensure audio settings look OK.
#* The default microphone for the system should already be set up to record audio. It is listed as Mic/Aux under the Mixer pane at the bottom. If you want to use an alternate microphone, click on the cog -> Properties and change the device.
#* Keep in mind that by default, Desktop Audio is recorded as well. If the user running the conference expects to play media during the conference that they do not want being picked up in the stream or recording itself, click the megaphone icon under Desktop Audio by default to mute it.
# Set up either streaming, recording, or both as follows.

'''Streaming''':
# Go to File -> Settings -> Stream and select the service you want to use (99% of the time probably YouTube or Twitch).
# Locate your stream key for the account you want to use. For YouTube/Twitch, there is a helpful link right there that takes you to the proper place to get this.
#* YouTube: https://www.youtube.com/live_dashboard, near the bottom
#* Twitch: https://www.twitch.tv/username/dashboard/settings, at the top (replace username with your username). You can also link your account directly if you want.
# Enter your key and hit OK.
# Click Start Streaming under the Control pane at the bottom.

'''Recording''':
# Go to File -> Settings -> Output and change the recording path to something appropriate and click OK. If in a conference room, this should be an external SSD or the internal drive. We have observed that using external HDDs may introduce dropped frames due to encoding lag because of I/O bottlenecks.
# Click Start Recording under the Control pane at the bottom.

Iribe/ConferenceRooms

2019-09-26T16:03:42Z

Jowenscs: /* Room Capabilities */

== Types of Rooms ==
; [[Iribe/ConferenceRooms/Moderated | Moderated Rooms]]
: Seminar and large conference areas must be scheduled through the designated moderator for the room.
; [[Iribe/ConferenceRooms/AutoAccept | Auto-Accept Rooms]]
: These 6-12 person rooms are scheduled, but will automatically accept your meeting without requiring moderation.
; [[Iribe/ConferenceRooms/HuddleRoom | Huddle Rooms]]
: Meant for last-minute, short-term meetings for one to three people or for personal phone calls.
: Huddle rooms can only be scheduled at the touch panel. They cannot be scheduled ahead of time through Google Calendar.

== Common Tasks ==
* [[Iribe/ConferenceRooms/View | Viewing one or more rooms]]
* [[Iribe/ConferenceRooms/Reserve | Reserving a room]]
* [[Iribe/ConferenceRooms/Moderation | [Moderator] Approving a room request ]]
* [[Iribe/ConferenceRooms/Moderation | [Moderator] Enabling notifications for pending requests ]]

== Viewing ==
Conference room availability can be [[Iribe/ConferenceRooms/View | viewed]] with UMD’s Google Calendar system or from a touch panel outside each individual room. The touch panel quickly allows you to see the status of the room: red if the room is reserved right now and green if it is open.

We also offer a [[Iribe/ConferenceRooms/List|list]] of conference rooms scheduled with the UMD Google Calendar system.

== Scheduling ==
Conference rooms are [[Iribe/ConferenceRooms/Reserve | reserved]] with UMD’s Google Calendar system along with a touch panel outside the room. The touch panel quickly allows you to see the status of the room: red if the room is reserved right now and green if it is open. You can walk up to the panel and reserve the room if it is unoccupied within the next 12 hours (non-moderated rooms only).

== Room Capabilities ==
Our conference rooms have different AV capabilities based on the size of the room you are using. We are still working with the AV contractors on a number of the capabilities in these rooms, but you should at a minimum be able to plug in your laptop to display to the projector and screen(s). In the future we will outline and give sessions on how to effectively use the different functionalities in our conference rooms.

* [[Iribe/ConferenceRooms/Solstice | Solstice Mersive Pods]]
* [[Iribe/ConferenceRooms/Recording | Recording and Streaming]]

Modules

2019-06-12T17:46:58Z

Jowenscs: /* GNU Modules */

=GNU Modules=

Many large Institutions use the concept of Modules to load software into users environment. It provides a way to add and remove, if later needed, environmental variables that provide access to UMIACS large set of software we offer on our Red Hat Enterprise Linux ([[RedHat]]) and [[Ubuntu]] 14.04 platforms. This works by customizing your shell environment, this is done automatically for the two major shell families bash/sh (default shell) and tcsh/csh. If you use a alternate shell please look to source the appropriate script for your shell in <tt>/usr/share/Modules/init</tt>

Initially your module environment is empty though included in your ModulePath is local operating system specific modules, locally built software modules and binary software modules (Matlab, Intel Compiler, etc...).

==Available Software==
To see if a piece of software is available you use the <tt>module avail</tt> command. This can be given a trailing prefix on the command line to search a subset of the available software.

<pre>
[derek@supernova ~]$ module avail matlab

---------------------------------------- /opt/common/.modulefiles -----------------------------------------
matlab/2007b matlab/2008b matlab/2010a matlab/2011a matlab/2012a
matlab/2008a matlab/2009b matlab/2010b matlab/2011b matlab/2012b
</pre>

<pre>
[derek@supernova ~]$ module avail gcc

-------------------------------------- /opt/local/stow/.modulefiles ---------------------------------------
gcc/4.6.0 gcc/4.7.2(default) gcc/boost/1.53.0
</pre>

There may be a (default) module otherwise the most recent version of software is loaded when specified.

==Adding Modules into your Environment==
You can simply add a module into your environment by using the <tt>module add <module></tt> command.

<pre>
[derek@supernova ~]$ module add matlab
</pre>

You can also specify a specific version of the software when we have multiple ones available.

<pre>
[derek@supernova ~]$ module add cuda/5.0.35
</pre>

==Listing Modules==
You can list the currently loaded modules in your environment by using the '''list''' command.

<pre>
[derek@supernova:~ ] $ module list
Currently Loaded Modulefiles:
1) R/3.1.2 2) kile/2.1 3) vim/7.4
</pre>

==Showing a Module==
You can show what the module is going to add to your environment (and the dependencies that will be added) with the '''show''' command.

<pre>
[derek@supernova:~ ] $ module show fftw
-------------------------------------------------------------------
/opt/local/stow/.modulefiles/fftw/3.3.4:

prepend-path PATH /opt/local/stow/fftw-3.3.4/bin
prepend-path CPATH /opt/local/stow/fftw-3.3.4/include
prepend-path LIBRARY_PATH /opt/local/stow/fftw-3.3.4/lib
prepend-path LD_RUN_PATH /opt/local/stow/fftw-3.3.4/lib
prepend-path MANPATH /opt/local/stow/fftw-3.3.4/share/man
prepend-path PKG_CONFIG_PATH /opt/local/stow/fftw-3.3.4/lib/pkgconfig
-------------------------------------------------------------------
</pre>

==Removing Modules in your Environment==
If you want to remove a module because it conflicts or you want to clean up your environment you can by using the <tt>module rm <module></tt> command.

==Using Modules in Scripts==
To use modules within a shell script or interpreted language you will need to load a file from <tt>/usr/share/Modules/init</tt> into your program.

===Bash===
<pre>
. /usr/share/Modules/init/bash
module add gcc
</pre>

===Tcsh===
<pre>
source /usr/share/Modules/init/tcsh
module add gcc
</pre>

==Modules in Non-Interactive Shell Sessions==

In non-interactive shell sessions (non-login shells), the Modules configuration environment will not automatically load. If you will need the use of Modules in non-interactive Torque jobs or other similar sessions, you will need to include the following in your shell init scripts:

===Bash===
<pre>
. /usr/share/Modules/init/bash
. /etc/profile.d/ummodules.sh
</pre>

===Tcsh===
<pre>
source /usr/share/Modules/init/tcsh
source /etc/profile.d/ummodules.csh
</pre>

==Additional Help==
You can type <tt>module</tt> with no arguments for a full list of commands or <tt>man module</tt> for further information.

===Online Resources===
*[http://modules.sourceforge.net/ Project Page (SourceForge)]
*[http://modules.sourceforge.net/docs/Modules-Paper.pdf Introduction to Modules]
*[http://sourceforge.net/p/modules/wiki/FAQ/ Modules FAQ]
*[http://modules.sourceforge.net/docs/user-setup.pdf user-setup]

GitLab

2018-11-16T14:42:37Z

Jowenscs: /* Two Factor Authentication */

GitLab is source code collaboration software based on [https://git-scm.com/ Git] source control management. It allows users to create their own repositories and share them with other users/groups or publicly. It supports built-in project wikis, code review, and issue tracking for each project. A full list of features can be found on the [https://www.gitlab.com/gitlab-ce GitLab] website.

All code is hosted on-site on UMIACS servers and is backed up nightly. We give all UMIACS users 5 projects with a soft limit of 400Mb per project. Projects that you create inside of a group namespace still count towards your project limit. UMIACS Staff can help create Lab groups (called namespaces) and delegate authority to manage the group to one or more faculty members. Permissions are assigned within GitLab.

To get started, navigate to the following URL in your browser and enter your UMIACS credentials:

https://gitlab.umiacs.umd.edu

Note: There might be issues connecting to GitLab if you are using an older git client. Therefore, please make sure you update your git client.
If you use TortoiseGit, please make sure it is updated to versions above TortoiseGit 2.1.x.x.

==GitLab Offsite Collaborators==
Any UMIACS user can now create an unlimited number of offsite
collaborator accounts for our Security Groups, GitLab and Object Store. These accounts can not create
repositories or groups, but may be given access to your repositories or
groups. You can find this utility in our [https://intranet.umiacs.umd.edu/requests Requests] application under [https://intranet.umiacs.umd.edu/requests/accounts UMIACS Collaborators].

==User Documentation==
GitLab provides user documentation that can be accessed at https://gitlab.umiacs.umd.edu/help. <b>Note:</b> you will need to log in to view this page.

Some of the most useful sections include:
* Permissions and user roles - https://gitlab.umiacs.umd.edu/help/user/permissions.md
* GitLab markdown for wikis and READMEs - https://gitlab.umiacs.umd.edu/help/user/markdown.md

==Two Factor Authentication==
GitLab offers Two Factor Authentication (2FA) though a mobile device. GitLab's setup information for 2FA can be found at https://gitlab.umiacs.umd.edu/help/user/profile/account/two_factor_authentication.md#two-factor-authentication

It is recommended that you use the Google Authenticator mobile application, however the mobile application "Duo" also will work. Once the application is installed there are two ways to finalize setup.
* Scan the QR code with your phone's camera.
* Enter the details provided to add the entry manually.

After you have set up 2FA, to log in just enter the six-digit pin number from your phone when prompted.

==Repository URLs==
Users can download and clone directories from the remote repository using git clone. There are two different URLs that can be used: HTTPS and SSH.
You can view the URL underneath the Project title in the Project tab. Change the displayed URL by clicking on the URL type you want to see.
===SSH===
The SSH URL is more direct, though it is harder to set up. In order to do so, you will have to add an SSH key to your Gitlab account. Instructions to do so can be found [https://gitlab.umiacs.umd.edu/help/ssh/README here]. Once you have the SSH key added, you can log in without having to enter any credentials from the machine and account for which you created the SSH key.
===HTTPS===
The HTTPS URL is easier to set up- you just clone directly from the repository using the HTTPS URL. However, you will have to re-enter your credentials for GitLab every single time that you attempt to commit to, push to, pull from, or otherwise access the remote repository.

==Make GitLab projects public==
Making projects public grants access to everyone. Projects can only made public by the owner. To make your projects on GitLab public and make repo accessible to everyone, follow the steps below:
1. Go to your projects page https://gitlab.umiacs.umd.edu/<username>/<yourProjectName>.
For example: https://gitlab.umiacs.umd.edu/suzantrt/someNewAwesomeProject
2. Click on '''Settings'''.

3. Scroll down to '''Project Visibility'''. Choose '''Public''' from the drop-down menu.

4. Scroll down and click on '''Save Changes'''

5. Scroll down to '''Repository''' under '''Project Visibility''' and select '''Everyone with access''' from the drop-down menu.

6. Click on '''Save Changes'''.

Now your project has become public with its repository accessible anyone with access.

Creating service admin user on macOS

2018-11-15T15:20:03Z

Jowenscs: /* Creating the new account */

When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Store require an admin user name and password, and if the pre-existing password is the same as your UMIACS domain login password, revealing it to the Terp Store technician would represent a security vulnerability. To remedy this, you must create a new temporary user account with administrator privileges that the Terp Store technicians can use to service your machine.

==Creating the new account==

* Make sure you are logged in to an administrator account on your MacBook
# Navigate to System Preferences (Click on the Apple Logo at the top lefthand side of the screen, and select "System Preferences" from the dropdown menu)
# From the System Preferences menu, select "Users and Groups"
# At the bottom left corner of the window, click the lock to allow changes to your settings (It will most likely require your password to make changes)
# On the lefthand side of the screen where it lists the users currently on the machine, click on the '+' button to add a new user
# By default, the new account will be set to a Standard account. Select the "New Account" dropdown menu and choose "Administrator" from the list [[Image:Administrator.png|400px]]
# The new user's full name should be "Service Admin," and the account name should be "serviceadmin"
# The password is up to you, so long as it's not the same as your UMIACS account password or your UMD Directory ID password [[Image:CompletedUserAccount.png|400px]]
# Select "Create User"

When prompted by TerpTrader, you should give this account's credentials to the technician, '''not''' your UMIACS account credentials. Once the service is completed, the account can be deleted.

Creating service admin user on macOS

2018-11-15T14:52:21Z

Jowenscs: /* Creating the new account */

When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Store require an admin user name and password, and if the pre-existing password is the same as your UMIACS domain login password, revealing it to the Terp Store technician would represent a security vulnerability. To remedy this, you must create a new temporary user account with administrator privileges that the Terp Store technicians can use to service your machine.

==Creating the new account==

* Make sure you are logged in to an administrator account on your MacBook
* Navigate to System Preferences (Click on the Apple Logo at the top lefthand side of the screen, and select "System Preferences" from the dropdown menu)
* From the System Preferences menu, select "Users and Groups"
* At the bottom left corner of the window, click the lock to allow changes to your settings (It will most likely require your password to make changes)
* On the lefthand side of the screen where it lists the users currently on the machine, click on the '+' button to add a new user
* By default, the new account will be set to a Standard account. Select the "New Account" dropdown menu and choose "Administrator" from the list [[Image:Administrator.png|400px]]
* The new user's full name should be "Service Admin," and the account name should be "serviceadmin"
* The password is up to you, so long as it's not the same as your UMIACS account password or your UMD Directory ID password [[Image:CompletedUserAccount.png|400px]]
* Select "Create User"

When prompted by TerpTrader, you should give this account's credentials to the technician, '''not''' your UMIACS account credentials. Once the service is completed, the account can be deleted.

Creating service admin user on macOS

2018-11-15T14:52:02Z

Jowenscs: /* Creating the new account */

When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Store require an admin user name and password, and if the pre-existing password is the same as your UMIACS domain login password, revealing it to the Terp Store technician would represent a security vulnerability. To remedy this, you must create a new temporary user account with administrator privileges that the Terp Store technicians can use to service your machine.

==Creating the new account==

* Make sure you are logged in to an administrator account on your MacBook
* Navigate to System Preferences (Click on the Apple Logo at the top lefthand side of the screen, and select "System Preferences" from the dropdown menu)
* From the System Preferences menu, select "Users and Groups"
* At the bottom left corner of the window, click the lock to allow changes to your settings (It will most likely require your password to make changes)
* On the lefthand side of the screen where it lists the users currently on the machine, click on the '+' button to add a new user
* By default, the new account will be set to a Standard account. Select the "New Account" dropdown menu and choose "Administrator" from the list [[Image:Administrator.png|400px]]
* The new user's full name should be "Service Admin," and the account name should be "serviceadmin"
* The password is up to you, so long as it's not the same as your UMIACS account password or your UMD Directory ID password [[Image:CompletedUserAccount.png|400px]]
* Select "Create User"

When prompted by TerpTrader, you should give this account's credentials to the technician, '''not''' your UMIACS account credentials. Once the service is completed, the account can be deleted

Creating service admin user on macOS

2018-11-15T14:49:05Z

Jowenscs: /* Creating the new account */

When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Store require an admin user name and password, and if the pre-existing password is the same as your UMIACS domain login password, revealing it to the Terp Store technician would represent a security vulnerability. To remedy this, you must create a new temporary user account with administrator privileges that the Terp Store technicians can use to service your machine.

==Creating the new account==

* Make sure you are logged in to an administrator account on your MacBook
* Navigate to System Preferences (Click on the Apple Logo at the top lefthand side of the screen, and select "System Preferences" from the dropdown menu)
* From the System Preferences menu, select "Users and Groups"
* At the bottom left corner of the window, click the lock to allow changes to your settings (It will most likely require your password to make changes)
* On the lefthand side of the screen where it lists the users currently on the machine, click on the '+' button to add a new user
* By default, the new account will be set to a Standard account. Select the "New Account" dropdown menu and choose "Administrator" from the list [[Image:Administrator.png|400px]]
* The new user's full name should be "Service Admin," and the account name should be "serviceadmin"
* The password is up to you, so long as it's not the same as your UMIACS account password or your UMD Directory ID password [[Image:CompletedUserAccount.png|400px]]
* Select "Create User"

When prompted by TerpTrader, you should give this account's credentials to the technician, '''not''' your UMIACS account credentials

Creating service admin user on macOS

2018-11-15T14:46:57Z

Jowenscs: /* Creating the new account */

When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Store require an admin user name and password, and if the pre-existing password is the same as your UMIACS domain login password, revealing it to the Terp Store technician would represent a security vulnerability. To remedy this, you must create a new temporary user account with administrator privileges that the Terp Store technicians can use to service your machine.

==Creating the new account==

* Make sure you are logged in to an administrator account on your MacBook
* Navigate to System Preferences (Click on the Apple Logo at the top lefthand side of the screen, and select "System Preferences" from the dropdown menu)
* From the System Preferences menu, select "Users and Groups"
* At the bottom left corner of the window, click the lock to allow changes to your settings (It will most likely require your password to make changes)
* On the lefthand side of the screen where it lists the users currently on the machine, click on the '+' button to add a new user
* By default, the new account will be set to a Standard account. Select the "New Account" dropdown menu and choose "Administrator" from the list [[File:Administrator.png]]
* The new user's full name should be "Service Admin," and the account name should be "serviceadmin"
* The password is up to you, so long as it's not the same as your UMIACS account password or your UMD Directory ID password [[File:CompletedUserAccount.png]]
* Select "Create User"

When prompted by TerpTrader, you should give this account's credentials to the technician, '''not''' your UMIACS account credentials

File:CompletedUserAccount.png

2018-11-15T14:44:53Z

Jowenscs:

File:Administrator.png

2018-11-15T14:44:09Z

Jowenscs:

Creating service admin user on macOS

2018-11-15T14:39:26Z

Jowenscs:

When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Store require an admin user name and password, and if the pre-existing password is the same as your UMIACS domain login password, revealing it to the Terp Store technician would represent a security vulnerability. To remedy this, you must create a new temporary user account with administrator privileges that the Terp Store technicians can use to service your machine.

==Creating the new account==

* Make sure you are logged in to an administrator account on your MacBook
* Navigate to System Preferences (Click on the Apple Logo at the top lefthand side of the screen, and select "System Preferences" from the dropdown menu)
* From the System Preferences menu, select "Users and Groups"
* At the bottom left corner of the window, click the lock to allow changes to your settings (It will most likely require your password to make changes)
* On the lefthand side of the screen where it lists the users currently on the machine, click on the '+' button to add a new user
* By default, the new account will be set to a Standard account. Select the "New Account" dropdown menu and choose "Administrator" from the list
* The new user's full name should be "Service Admin," and the account name should be "serviceadmin"
* The password is up to you, so long as it's not the same as your UMIACS account password or your UMD Directory ID password
* Select "Create User"

When prompted by TerpTrader, you should give this account's credentials to the technician, '''not''' your UMIACS account credentials

Creating service admin user on macOS

2018-11-13T15:29:47Z

Jowenscs: Created page with "When taking an Apple product to the Terp Store, it is critical that you create a Service Admin User on your computer before having it serviced. The technicians at the Terp Sto..."

S3Clients

2018-10-12T13:51:34Z

Jowenscs: /* Graphical Clients */

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.

[[Image:Cyberduck.png|400px]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

[[Image:Transmit.png|400px]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>

S3Clients

2018-10-12T13:50:42Z

Jowenscs:

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Dragon Disk==
* http://www.dragondisk.com/

This is a free, cross platform S3 client that supports Windows, Mac and Linux. To configure Dragon Disk, select the "Other S3 compatible service" dropdown menu choice in the add account dialog. The following fields are required.

* '''Service Endpoint''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key''' - This is your access key as provided to you in the object store
* '''Secret Key''' - This is your secret key as provided to you in the object store
* '''Connect using SSL/HTTPS''' - Please toggle the checkbox.

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.

[[Image:Cyberduck.png|400px]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

[[Image:Transmit.png|400px]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>

File:Transmit.png

2018-10-12T13:49:40Z

Jowenscs:

S3Clients

2018-10-12T13:45:31Z

Jowenscs: /* Cyberduck */

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Dragon Disk==
* http://www.dragondisk.com/

This is a free, cross platform S3 client that supports Windows, Mac and Linux. To configure Dragon Disk, select the "Other S3 compatible service" dropdown menu choice in the add account dialog. The following fields are required.

* '''Service Endpoint''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key''' - This is your access key as provided to you in the object store
* '''Secret Key''' - This is your secret key as provided to you in the object store
* '''Connect using SSL/HTTPS''' - Please toggle the checkbox.

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.

[[Image:Cyberduck.png|400px]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>

S3Clients

2018-10-12T13:45:07Z

Jowenscs: /* Cyberduck */

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Dragon Disk==
* http://www.dragondisk.com/

This is a free, cross platform S3 client that supports Windows, Mac and Linux. To configure Dragon Disk, select the "Other S3 compatible service" dropdown menu choice in the add account dialog. The following fields are required.

* '''Service Endpoint''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key''' - This is your access key as provided to you in the object store
* '''Secret Key''' - This is your secret key as provided to you in the object store
* '''Connect using SSL/HTTPS''' - Please toggle the checkbox.

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.

[[Image:Cyberduck.png|280px]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>

File:Cyberduck.png

2018-10-12T13:43:48Z

Jowenscs:

S3Clients

2018-10-12T13:41:25Z

Jowenscs: /* Cyberduck */

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Dragon Disk==
* http://www.dragondisk.com/

This is a free, cross platform S3 client that supports Windows, Mac and Linux. To configure Dragon Disk, select the "Other S3 compatible service" dropdown menu choice in the add account dialog. The following fields are required.

* '''Service Endpoint''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key''' - This is your access key as provided to you in the object store
* '''Secret Key''' - This is your secret key as provided to you in the object store
* '''Connect using SSL/HTTPS''' - Please toggle the checkbox.

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.

[[Image:Cyberduck.png]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>

S3Clients

2018-10-12T13:28:36Z

Jowenscs: /* Cyberduck */

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Dragon Disk==
* http://www.dragondisk.com/

This is a free, cross platform S3 client that supports Windows, Mac and Linux. To configure Dragon Disk, select the "Other S3 compatible service" dropdown menu choice in the add account dialog. The following fields are required.

* '''Service Endpoint''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key''' - This is your access key as provided to you in the object store
* '''Secret Key''' - This is your secret key as provided to you in the object store
* '''Connect using SSL/HTTPS''' - Please toggle the checkbox.

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.

[[File:Cyberduck.png]]

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>

S3Clients

2018-10-12T13:26:06Z

Jowenscs: /* Cyberduck */

Many popular S3 desktop clients can be used to access the UMIACS Object Store. These tools complement the [[UMobj]] command line utilities and the built-in web interface by providing integration with the native file explorer on your desktop machine.

'''Note''': Many of these clients have features that are not supported by our Object Store in UMIACS. One prominent example of this is permissions. We suggest you instead manage permissions from the [https://obj.umiacs.umd.edu/obj built-in web application] for the Object Store.

=Graphical Clients=

==Dragon Disk==
* http://www.dragondisk.com/

This is a free, cross platform S3 client that supports Windows, Mac and Linux. To configure Dragon Disk, select the "Other S3 compatible service" dropdown menu choice in the add account dialog. The following fields are required.

* '''Service Endpoint''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key''' - This is your access key as provided to you in the object store
* '''Secret Key''' - This is your secret key as provided to you in the object store
* '''Connect using SSL/HTTPS''' - Please toggle the checkbox.

==Cyberduck==
* http://cyberduck.ch/

This is a free Windows and Mac S3 browser (it is however nagware that asks for a donation). It supports our S3 Object Stores using the "S3 (Amazon Simple Storage Service)" drop down menu choice in the add bookmark dialog. The following fields are required.
[[File:Cyberduck.png]]
* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Password''' - This is your secret key as provided to you in the object store

You will be prompted for your secret key when you connect and may choose to save the password.

==Transmit==
* http://panic.com/transmit/
This is a paid file transfer application for Mac. It supports our S3 Object Stores using the "S3" menu choice after clicking the plus sign to add a favorite. The following fields are required:

* '''Server''' - This should be your object store (<code>obj.umiacs.umd.edu</code>)
* '''Access Key ID''' - This is your access key as provided to you in the object store
* '''Secret''' - This is your secret key as provided to you in the object store

These settings can be saved as a favorite for easy access. Transmit also allows you to mount your Obj buckets as local disks, which will support easy drag-and-drop of files.

=Command Line Clients=
==s3cmd==
Command line client for accessing S3-like services.

* http://s3tools.org/s3cmd

You need to configure a file like <code>~/.s3cmd</code> that looks like the following with your ACCESS_KEY and SECRET_KEY substituted.

<pre>
[default]
access_key = ACCESS_KEY
host_base = obj.umiacs.umd.edu
host_bucket = %(bucket)s.obj.umiacs.umd.edu
secret_key = SECRET_KEY
use_https = True
</pre>

==mc==
The Minio Client is a comprehensive single binary (Go) command line client for cloud based storage services.

* https://github.com/minio/mc

You will need to setup a cloud provider for Obj and you should first retrieve the ACCESS_KEY and SECRET_KEY for your personal or LabAccount in the [https://obj.umiacs.umd.edu/obj Object Store ].

<pre>
mc config host add obj http://obj.umiacs.umd.edu ACCESS_KEY SECRET_KEY
</pre>

You can then use the normal <code>mc</code> commands like the following to list the contents of a bucket.

<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>