ECON Knowledge Base

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======Getting Started with the Cluster======
=====Cluster Login======
====Connecting via Browser====

The cluster has recently been refreshed to Rocky Linux 9 (Enterprise Linux 9) and you can now fully access the nodes from your web browser. To do so:

Connect to the university VPN.

Once connected, go to one of the following addresses in your browser:

^Address ^
| https://econcs014.umd.edu:9090 |
| https://econcs015.umd.edu:9090 |
| https://econcs016.umd.edu:9090 |
| https://econcs017.umd.edu:9090 |
| https://econcs018.umd.edu:9090 |
| https://econcs019.umd.edu:9090 |
| https://econcs020.umd.edu:9090 |

You will be greeted with a login screen. Please use your UMD username and password (the same you would use with CAS) to log in to the server.

{{:cluster:cluster-login.png?400|}}

If successful, you will now be at the cluster node's dashboard.

=====The Dashboard=====

The dashboard is a web-based interface that will allow you to do most anything you'll need to do with the node.

====Overview Module====

You'll typically start at the overview module, which will give you the following:

{{:cluster:cluster-dashboard-overview.png?400|}}

1: The navigation pane. This will allow you to move between different modules of the dashboard. You'll primarily use Overview, Navigator, and Terminal. The pane you select will be shown on the right side of the screen. This bar will persist between modules.

2: The server's message of the day (MOTD). This will be updated with any relevant notices or alerts.

3: The server's current utilization. You can see here if the server is being heavily utilized, so you can move to another, less-active node if needed.

4: The server's current hardware status. This shows the make and model of the current server, and how long it has been active without a restart. 

====File Browser Module====

This module will allow you to securely upload and download files from the cluster. If you are unsure of what the buttons do, you can hover over them to gain a description of their function.

{{:cluster:cluster-dashboard-navigator.png?400|}}

1: Favorites button (has home by default, but can add other folders once you navigate to them)

2: Edit path (manually enter folder location)

3: Current directory path. Can click on previous folders to go "up" a directory.

4: Upload File

5: Folder window. Shows contents of current folder. You can use right click to perform file functions such as downloading and editing

6: Properties of currently selected item


====Terminal Module====

This module provides an SSH connection to the current cluster.

{{:cluster:cluster-dashboard-terminal.png?400|}}

1: The current user, node, and working directory.

2: The main terminal window, where you issue commands and read standard output.

3: Context (Right-click) menu in the terminal window. Allows for copy/paste and shows keyboard command equivalents (NOTE: The browser may need to ask if it can access clipboard content. Allow for this function to work.)

4: Terminal options (Font size / Background Color)

=== Linux Terminal Commands / Tips ===

From the Linux prompt you can move your files around, check on your jobs,
manage your disk space, and run programs.  Below are some brief introductions to basic commands.
For more info, [[http://www.ee.surrey.ac.uk/Teaching/Unix/|this]] is a reasonably good tutorial.  Note
that most of the the Linux shell functionality is the same as a UNIX shell (the shell that you get
when you open a Mac terminal).  There are many resources online to help you learn how to use the Unix shell. 

==ls==
The ''ls'' command lists the files in a particular directory.  To use it, type ''ls'' at the prompt and press enter:
 <code>[username@econ1 ~ ]$ ls</code>

You can use wildcards with ''ls'' to list only files matching a particular expression.  That is, the command
 <code>[username@econ1 ~ ]$ ls *.do</code>
will list only your .do files in the current directory.

==mv==
The ''mv'' command allows you to move files or directories from one directory to another
 <code>mv [file] [directory]</code>

==mkdir==
The ''mkdir'' command creates a new directory.  It's usage is
 <code>mkdir [new directory name]</code>
 
==rm==
The ''rm'' command deletes the files specified after the command.  The following code would delete all .do files in your current directory.
 <code>rm *.do</code>

You can delete an entire non-empty directory with:
 <code>rm -r [directory]</code>

==rmdir==
The command ''rmdir'' deletes an empty directory:
 <code>rmdir [directory to delete]</code>

==man pages==
To get help about a command, you can view it's "man page," which describes how the command works.  It describes the syntax and usage for the command.  To view a man page, type:
 <code>man [command]</code>
You can move up and down the man page with the arrows.  Typing q quits.

==Creating an alias==
Sometimes you use a certain command so many times that you just can't type it anymore. That's where the aliases come helpful. Just as the name suggests, you can tell the cluster to use some new (shorter) command in place of the one you use often. As an example, every time I log in to the cluster, I go to ''cd ~/files/pics/cute_pics/cats'' and I want to change it to just ''cats''.

First, I start editing my bash profile with any [[cluster:text_editing|text editor]]. For example <code>nano ~/.bash_profile</code>
Then I go to the space below ''# User specific environment and startup programs'' and type <code>alias cats="cd ~/files/pics/cute_pics/cats"</code>
I save the file and refresh the changes by typing <code>source ~/.bash_profile</code>
Now typing <code>cats</code> sends me directly to the folder I need.