=====System Access=====

==== System Access Has Three Modes: ====

  * Physical Lab Access 
  * Web Access (This Wiki Page and the Zeppelin workbook)
  * SSH access (terminal access)

==== FIRST STEPS: Accounts and Passwords ====

Accounts must be assigned before you can access the system. Fill out the form below to request an account on the cluster. Within 24 hours of reviving the request, you will be given a password for the system. The password will work or all the workstations in the DSL and will work for remote access using the Zeppelin notebook and SSH (see below).

<form>
Action mail deadline@eadline.org,sjagannathan@saintpeters.edu
Thanks "Thanks for your submission. We will be contacting you with your account information."

Fieldset "Request Password"
Textbox  "Name (first/ last)" "=Your Name"
Textbox "Requested Login Name"  "=Login"
email "Your E-Mail Address" "=Email Address"

submit "Submit Query"
</form>

** PASSWORDS ARE VALID FOR 90 DAYS.** You will be required to provide a new password to log into the system.

** Account names can be the same as campus-wide accounts, however, authentication (passwords) for the DSL cluster (//dsl.saintpeters.edu//) are unique and will only work for ssh and the Zeppelin notebook .**

==== Lab Access ====

Once you have a valid account and password, you can login into any workstation in the Data Science Lab. The files under your account will be available on all the workstations in the lab. For instance, you can work on Limulus3 one day and return to the lab later and use Limulus6 (or login over the internet) and the same files (in the same state) will be available for you.  

==== Web Access ====
The system can be accessed using https (web browser) to read this documentation. Connect to:
<code>
https://dsl.saintpeters.edu
</code>

Web access to the **Zeppelin Notebook** is available from the following URL:

[[https://dsl.saintpeters.edu:8443]]

A valid DSL cluster account is required to use the Zeppelin notebook. Zeppelin is web based notebook for doing Spark, Hive, Python, and R programming. There are several tutorials available. You must **clone the tutorial
notebooks** to use them. Once cloned, click the small lock icon in the upper corner or a notebook to set permissions. See [[how_do_i#using_the_zeppelin_web_notebook| Use the Zeppelin Notebook]] for further information.

==== SSH Access ====

SSH is an encrypted command line tool for terminal access to a remote computer systems. You will need an SSH Client to access the cluster via SSH. If you are using Windows, you will need to install either (both are free) [[https://www.putty.org/ PuTTY]] or [[https://mobaxterm.mobatek.net/ MobaXterm]]. Mac and Linux come with an SSH client already installed as part of their Terminal applications. 

To access the cluster using SSH by entering following in a terminal window (you must request a username and password from the cluster administrator):

<code>
  ssh USERNAME@dsl.saintpeters.edu -p8528
</code>

USERNAME is your account user name on the cluster. This connection will place you on 
the main server. Once you are logged into the main server (now called "dsl") you can continue ot use SSH to use a specific server (i.e. these are the oethr servers in the DSL lab). 

For example, once logged-in to the main system (named limulusg) you can move to any other system in the cluster. These include limulus2, limulus3, limulus4, limulus5, limulus6, limulus7-TF, limulus8-TF and limulus9-TF. For example:
<code>
  ssh USERNAME@limulus3
</code>