Revision as of 09:16, 22 September 2017

You can use Secure Shell(SSH) to connect to HPC. Depending on the operating system of your computer, you have different options to get connected.

For Mac/Linux

You can directly use the Terminal application comes with your system to connect.

In your terminal, type the following command to connect via ssh:

ssh YourUserName@hpc.mtech.edu

You will then receive prompt to enter your password, similar to the following line.

YourUserName@hpc.mtech.edu's password:

You can then enter your password. Note: when you enter your password, nothing will display on the screen.

If you intend to use any applications with GUI interfaces (e.g. MATLAB, COMSOL), you will need to add the '-X' option when connecting:

ssh -X YourUserName@hpc.mtech.edu

For Windows

You will need to install a terminal emulator program to connect. There are many such programs[1], below are examples of using MobaXterm and Xshell.

Using MobaXterm

MobaXterm[2] is a single application that has integrations of several tools, e.g., SSH, X11, FTP....

MobaXterm has a free Home Edition, and you download it here. Either the Portable version or the Installer version is fine.

• To connect to the HPC, you can either start a local terminal, and use the command ssh YourUserName@hpc.mtech.edu as detailed in the previous Mac/Linux section.

• Or you can click the Session button on the top left corner and choose SSH in the pop-up window. Then enter the HPC's address and your username as shown below:

Then click Ok and you'll get a prompt to enter your password.

Using Xshell

You can download Xshell at https://www.netsarang.com/products/xsh_overview.html It's free for School/Home use.

You'll also need to install an X Server program on your computer if you want to use any graphical applications (e.g. MATLAB, COMSOL). One free X Server is Xming and you can download it at https://sourceforge.net/projects/xming/

After the installation of Xshell/Xming, you can follow the steps below to set up the connection.

Once the above setup is complete, you can select Open under the File tab (or just use the Open Button) to connect to HPC. Remember to run Xming first, if you need to use graphical interfaces. And you'll see its icon in the Taskbar.

Transferring files between your computer and HPC

After you login to HPC, the files you created/saved is stored on HPC. You will need some tools to transfer files between your computer and HPC.

For Mac/Linux

You can directly use the scp command in the terminal to do a file transfer, or you can use any FTP applications.

For Windows

You can use any FTP programs to transfer files. Just use hpc.mtech.edu as the host address, and provide your username and password. One FTP program is Xftp (free for home/school). You can get it at https://www.netsarang.com/products/xfp_overview.html

If you are logged in using Xshell, you can use the New File Transfer button in the toolbar (or the keyboard shortcut Ctrl+Alt+F) to open the file transfer. By default, in the popped up Xftp window, you'll see your Desktop directory on the left side and the directory you are at in Xshell on the right. You can then Right-Click any files or folders to transfer files.

For Mobaxterm, the FTP function is integrated. If you are logged in to HPC, you can choose the Sftp tab in the left sidebar to download/upload files. Or you can also start a SFTP session similar to the Mobaxterm tutorial above.

First Login

Once you logged in, you'll see some texts, including the logo and some notice.
At the bottom line, you'll see your cursor after a Unix prompt(possibly a dollar sign):
[YourUserName@scyld ~]$ ❚ The texts before the dollar sign include your username, computer name and your current directory name. For general purposes, these texts will be omitted in the following examples, like $ ❚

Change your initial password

It's best to change your initial password the first time you log in. To do it, simply use the passwd command:

$ passwd

You will then get the following texts:

Changing password for user YourUserName.

Changing password for YourUserName.

(current) UNIX password: ❚

Enter your initial(current) password and press enter. You'll then be prompt to enter and retype new passoword:

New password:

Retype new password:

If change is successful, you'll get:

passwd: all authentication tokens updated successfully.

Your Home Directory

When you login to HPC, you are directed to your default home directory, which generally has the following format:

/home/YourAffiliationInstitution/YourUserName

NOTE: There is limited space available on the /home partition, where your default home directory is on. If you need to store a large amount of data or files (>2G), we will create a directory for you either at /data/YourUserName or /data1/YourUserName. You can send us an email to request a directory there.

For some newer users, your home directory will be at

/data/YourUserName or /data1/YourUserName