Skip to content

access.rst

Latest commit

 

History

History
123 lines (92 loc) · 4.52 KB

access.rst

File metadata and controls

123 lines (92 loc) · 4.52 KB
tocdepth:3

Access

Terminal Access via SSH

SSH is the only way to access ManeFrame II. There are many SSH clients available for different operating systems. The details for Linux, macOS, and Windows are given below. In all cases, ManeFrame II is accesses via m2.smu.edu using your SMU credentials.

Linux

Specific access instructions vary by different Linux distributions, but generally the steps are as follows.

  1. Open a terminal
  2. Type ssh -CX <your_username>@m2.smu.edu where <your_username> is your username, which is the first part of your SMU email address.
Setting Up Key-Based Authentication

macOS

macOS requires the one-time installation of XQuartz to provide X11 for graphical applications.

  1. Install XQuartz
  2. Log out and back into the Mac or reboot
  3. Open the Terminal app at /Applications/Utilities/Terminal.app
  4. Run the command defaults write org.macosforge.xquartz.X11 enable_iglx -bool true to enable indirect GLX, which is disabled by default

The SSH steps are generally as follows:

  1. Open the Terminal app at "/Applications/Utilities/Terminal.app"
  2. Type ssh -CX <your_username>@m2.smu.edu where <your_username> is your username, which is the first part of your SMU email address.
Setting Up Key-Based Authentication

Windows

Windows requires the one-time installation of an SSH client and X11.

  1. Putty is the most popular (and free) SSH client available. Download and install the newest version.
  2. In order to view graphics from ManeFrame, you will also need to install an X-server. The most popular, again free, X11 implementation on Windows is Xming. To install Xming, download and install the newest versions of both the Xming X server and the Xming Fonts.

Once these two programs are installed, you can then log into ManeFrame II:

  1. Start the Xming program in the Start Menu. The Xming program runs from the System Tray.
  2. Start the Putty program in the Start Menu.
  3. In the Putty window:
    1. In the “Category” box:
      1. Scroll to the bottom and select “+” next to “SSH”.
      2. Select “X11”.
    2. In the “X11 forwarding” section, select “Enable X11 forwarding”.
    3. In the “Category” box, scroll to the top and select “Session”.
    4. In the “Host Name” field, type “m2.smu.edu”.
    5. In the “Saved Sessions” field, type “ManeFrame II (M2)”.
    6. Press “Save”.
    7. Press “Open”. Select “Yes” if you presented with a “Putty Security Alert” window.
    8. At the command prompt, type your username, which is the first part of your SMU email address, followed by enter.
    9. At the command prompt, type your SMU password followed by enter.
Setting Up Key-Based Authentication

Accessing Files via SFTP

ManeFrame II has two separate file systems. The first, the "home" file system, contains user's home directories ("~/", "/users/$USER", "$HOME") and is what is seen when first logging into the system. The second, the "scratch" file system, is ManeFrame II's high performance parallel file system ("/scratch/users/$USER" or "$SCRATCH"). The scratch file system is significantly larger and faster than the "home" file system and should be the file system used when running calculations. Files needed for running calculations or building software must be copied from your local computer to ManeFrame II. This is generally done using an SFTP client or the "scp" command where available.

SFTP Clients

There are several popular SFTP clients available and any file transfer client that supports SFTP will work with ManeFrame II. Several popular SFTP clients include WinSCP (Windows) and CyberDuck (Windows, macOS). These clients generally display two panes with the left side being your local files and the right side being your ManeFrame II files. When setting up access in these clients, SFTP must be chosen and your credentials will be your ManeFrame II credentials.