You are here

Access Information (How to Connect to Flux)

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 Flux cluster. 

1.) Install & Configure PuTTY

To connect to the Flux 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 Flux Cluster

  • 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 flux-login.arc-ts.umich.edu and Connection type should be set to SSH
  • Under Connection / SSH / X11 select "Enable X11 forwarding"
  • Under Session, put "Flux cluster" under Saved Sessions, and then click Save. (This step creates a saved template named "Flux cluster" 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 "Flux cluster" 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 Flux 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 a Flux 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: flux-xfer.arc-ts.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 a Flux Session

How to open a Flux 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 "Flux 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"

Transferring files between the Flux cluster & your PC:

  1. Launch WinSCP.
  2. Select the saved session name 
  3. Select Login (the first time you do this you will get a Security Alert dialog box. Select Yes.)
  4. Enter your Flux password

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

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

  1. Request a Flux account 
  2. Once it has been made, launch the Terminal application (under Go\Utilities\Terminal)
  3. At the command prompt type: ssh -l your-uniqname flux-login.arc-ts.umich.edu and press ENTER
  4. Enter your U-M 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 Flux cluster.

  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": flux-xfer.arc-ts.umich.edu
  9. Enter in Username: your-uniqname
  10. Select Connect

Access from a Mac (OS X 10.8+) Environment

  1. Request a Flux account 
  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 Flux cluster 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 -l your-uniqname flux-login.arc-ts.umich.edu 
  2. Authenticate to the Flux cluster.

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 Flux cluster.

  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": flux-xfer.arc-ts.umich.edu
  9. Enter in Username: your-uniqname
  10. Select Connect

Note: Mac users may also install "CyberDuck" to transfer files between local computer and remote Flux cluster. More information on how to download and install CyberDuck can be found here: http://tinyurl.com/flux-cyberduck