Michigan Ross iMpact

Leading in Thought & Action

Access Information (How to Connect)

Please select an option below to see the steps unique to your OS:

Access From a Windows Environment

There are a couple of software bits you will need to install and configure on your Windows PC to use the Ross Research Computing Grid. You will need Administrator privileges to accomplish these. If you do not have administrator privileges on your machine, please contact the Helpdesk.

1.) Install & Configure PuTTY

To connect to the Grid you will need to some sort of ssh-capable terminal emulator software. We typically use the PuTTY shareware. If you have a Ross-owned Windows office desktop, PuTTY should already be installed. If so, skip to the configuration steps below.

Installing PuTTY

  1. Go to http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
  2. Scroll down to the "Binaries" section
  3. Under "A Windows installer for everything except PuTTYtel" select putty-0.62-installer.exe
  4. In the File Download dialog box select Save
  5. Save the file to your Downloads folder (the default)
  6. Open Windows Explorer (one should be pinned to your Task bar) and under Favorites select Downloads
  7. Double left-click on putty-0.62-installer
  8. Select Yes on the various "...allow to make changes..." dialog boxes.
  9. Accept the defaults (though you may want to select the option to create a PuTTY desktop icon)
  10. At the last screen select Install then Finish (though you may want to opt out of viewing the README)

Configuring PuTTY for the Research Computing Grid

  • Launch PuTTY (Start\All Programs\PuTTY\PuTTY, after launch you may want to pin PuTTY to your Task bar), the "PuTTY Configuration" window should appear
  • Under Session, Host Name should be rc.bus.umich.edu and Connection type should be set to SSH
  • Under Connection / SSH / X11 select "Enable X11 forwarding"
  • Under Session, put "RC Grid" under Saved Sessions, and then click Save. (This step creates a saved template named "RC Grid" with the specification identified in steps 2 and 3.)

Here are a few helpful hints on where to set some theme settings in PuTTY:

  • Under Window / Appearance
    • Cursor Appearance
  • Under Window / Selection
    • Action of mouse buttons
  • Under Window / Colors
    • You will see a list of possible colors to change (such as foreground, background, etc)
    • For each color you want to change: Highlight the color type, select Modify, click on the desired color from the color palette, and click OK.

Note: to make these options permanent you must then re-save the "RC-Grid" session you created in Step 4.

2.) Installing XMING

Displaying Linux-based application graphics on your Windows PC requires an "X-Windows Display Server" installed on your machine. We typically use the Xming shareware for this purpose.

  1. Go to http://sourceforge.net/projects/xming/files/latest/download
  2. At the very top you will see a box in which is displayed "Your Xming X Server for Windows download will start X seconds". When "X" counts down to zero, a dialog box should appear (you may have to "allow pop-ups" for the site before this happens).
  3. Select the Save option.
  4. Save the file in your Downloads folder (the default).
  5. Open Windows Explorer and under favorites select Downloads.
  6. Double left-click on Xming-6-9-0-31-setup.
  7. Select Yes on the various "...allow to make changes..." dialog boxes.
  8. Accept the defaults (although you may want to select the option to create a desktop Xming icon).
  9. At the last screen, select Install and then Finish (you may or may not want to launch Xming automatically at this time).

3.) Install & Configure SFTP Software

To transfer files to/from the Research Computing Grid and your PC you will need SFTP software. We typically use the WinSCP shareware. If you have a Ross-owned Windows desktop, WinSCP should already be installed. If so, skip directly to the configuration steps below.

Installing WinSCP

  1. Go to http://winscp.net/eng/download.php
  2. Under "Downloading WinSCP" select "Installation package" (do *not* select "Installation package (sponsored)")
  3. Select the Save option.
  4. Save the file in your Downloads folder (the default).
  5. Open Windows Explorer and under favorites select Downloads.
  6. Double left-click on winscp437setup
  7. Select Yes on the various "...allow to make changes..." dialog boxes.
  8. Accept the defaults (though you may want to select the option to create a desktop WinSCP icon).
  9. At the last screen select Install then Finish (you may want to opt out of launching WinSCP at this time).

Configuring an RC Grid WinSCP Session

  1. Launch the WinSCP application (after launch you may want to pin WinSCP to your task bar so that you can easily return).
  2. You may see a "WinSCP.exe - Entry Point Not Found" dialog box. You can safely ignore this. Select OK. The "WinSCP Login" window should appear.
  3. Select Session and enter the following:
    • Host-Name: rc.bus.umich.edu
    • Username: your-uniquename
  4. Select Save
  5. Enter desired name under "Save Session As" (we usually take the default), do not save the password
  6. Select Ok

4.) Open & Use an RC Grid Session

How to open an RC Grid session & launch the Stata GUI:

  1. Make sure that Xming is executing. Note that the first time you launch Xming you will probably get a Windows Firewall dialog box. If so, then select "Allow access". This should only happen once.
  2. Launch PuTTy (you will get the "PuTTY Configuration" window).
  3. In Putty under Session select "RC Grid" and then Load.
  4. Select Open. The first time you do this you will get a Security Alert dialog box. Select Yes.
  5. At the "login as:" prompt type your UniqueName and enter, then your password then enter
  6. At the prompt enter xstata11 (for IC v11) or xstata-se11 (for SE v11)

A few lines about connecting will pass by, then (after some propagation delay) the Stata GUI will appear

The equivalent commands for SAS v9.2 is "sas" and for matlab is "matlab" (version 2009b).

Transferring files between the RC Grid & your PC:

  1. Launch WinSCP.
  2. Select the saved session name (default junwli@rc.bus.umich.edu).
  3. Select Login (the first time you do this you will get a Security Alert dialog box. Select Yes.)
  4. Enter your RC Grid password

The interface consists of 2 screens. The one on the left is your local PC and the one on the right is your RC Grid account. Just find what you want on the left then drag and drop it on the right. It will then be transferred.

Launching Stata batch jobs

  • stata11 -b do stataJob: For Stata IC v11
  • stata11 -b do stataJob: For Stata IC v11
  • Input job name stataJob is assumed to be stataJob.do
  • Output file name is stataJob.log.

Launching SAS batch jobs

  • sas sascmds.sas
  • Where sascmds.sas is a file containing the SAS commands you want executed
  • The file sascmds.log contains any SAS generated log information.
  • The file sascmds.out contains any output generated by SAS procs, etc.

Tracking Batch jobs

  • bjobs -aw
  • Displays all of your RC Grid batch jobs which are either running or have completed within the last hour

Access from a Mac (OS X 10.5, 10.6, 10.7) Environment

  1. Request an RC Grid account (for what follows assume the user name of newUser)
  2. Once it has been made, launch the Terminal application (under Go\Utilities\Terminal)
  3. At the command prompt type: ssh -X rc.bus.umich.edu -l newUser and press ENTER
  4. Enter your U-M uniqname and password when requested. You should now be connected.

To launch, for example, the Stata-11 GUI, enter (without quotation marks): "xstata11"

Transferring files from your Mac to the Grid & vice-versa

"Fugu" is a drag and drop app with which you can move files to and from the RC Grid.

  1. Install Fugu, which you can find at http://www.macupdate.com/app/mac/8761/fugu.
  2. Select "Download Now"
  3. Go to the Mac's Download tab
  4. Double-click on Fugu-1.2.0-Universal-English.dmg
  5. Agree to the license terms
  6. Select Execute.
  7. Launch Fugu
  8. Enter in "Connect to": rc.bus.umich.edu
  9. Enter in Username: newUser (the user name granted to you upon requesting an RC account)
  10. Select Connect

Access from a Mac (OS X 10.8+) Environment

  1. Request an RC Grid account (for what follows assume the user name of newUser)
  2. Once it has been made, install and configure XQuartz

Installing XQuartz

  1. Go to https://www.xquartz.org/
  2. Select XQuartz-2.7.11.dmg link
  3. The xQuartz package will be downloaded
  4. Click on the Download icon in the dock
  5. Click on XQuartz
  6. Double-click on XQuartz.pkg to install
  7. Once the install has completed, two-finger click on the XQuartz-2.7.11 disk image icon
  8. Click on Eject "XQuartz-2.7.11"

Launching XQuartz

  1. Launch Finder
  2. Click File / New Finder Window
  3. Click Applications
  4. Scroll down to and click on the Utilities folder.
  5. Double-click on XQuartz to launch the application
  6. An xQuartz icon will appear in the dock (with a white bar beneath indicating that the app is running)

Launching XQuartz at login & keeping it in the Dock

  1. Two-finger click on the XQuartz icon
  2. Highlight options
  3. Click on "Open at Login"
  4. Click on "Keep in Dock"

Launching an xterm

  1. Two-finger click on the XQuartz icon
  2. Click Applications/Terminal

Connecting to the RC Grid from the xterm

This session will allow X11 Forwarding. If you want to launch an app with a GUI, enter the appropriate command and the GUI will launch. For example, to launch the Stata v11 GUI enter the command "xstata11" (without quotation marks).

  1. At the prompt type "ssh -X -Y newUser@rc.bus.umich.edu " (where "newUser" is your RC Grid user ID).
  2. Authenticate to the RC Grid.

Transferring files from your Mac to the Grid & vice-versa

"Fugu" is a drag and drop app with which you can move files to and from the RC Grid.

  1. Install Fugu, which you can find at http://www.macupdate.com/app/mac/8761/fugu.
  2. Select "Download Now"
  3. Go to the Mac's Download tab
  4. Double-click on Fugu-1.2.0-Universal-English.dmg
  5. Agree to the license terms
  6. Select Execute.
  7. Launch Fugu
  8. Enter in "Connect to": rc.bus.umich.edu
  9. Enter in Username: newUser (the user name granted to you upon requesting an RC account)
  10. Select Connect