CCIT

UA Home CCIT Home UA Search

MacSSH

Revised Aug 31 2004

This webpage is part of the Macintosh SSH documentation. Other pages document other methods for secure connection and file transport for Macs, however, MacSSH appears to be the best choice when working with authoring software like Dreamweaver. This page details MacSSH's use in connecting to u.arizona.edu, file transport (via Fetch) and tunneling files for applications like Dreamweaver. W3 users should substitute the W3 host and their W3 logins where the U-System and NetID are used. This MacSSH webpage is organized by:

  1. system requirements
  2. software installation and setup steps (download links are included where appropriate)
  3. usage instructions (steps for connection and file transfer)

MacSSH Requirements

  • MacSSH requires 1.9MB
  • No browser required (other than for reading this and for downloads)
  • Fetch 4.0 requires 2.8MB

Fetch Software Installation & Setup

In this scenario Fetch is used to move files to and from u.arizona.edu, but any Mac FTP software should work through a file-transport tunnel that you'll be setting up later under MacSSH. Even if you already have Fetch running, please look at Fetch Installation & Setup for required configuration settings.

MacSSH Software Installation & Setup

  • Download MacSSH. (Open the .sit file directly with Stuffit Expander or save it to disk then expand it by double-clicking. This creates a folder containing documentation and application.)
  • Open the MacSSH PPC folder.
    • Since you may be using MacSSH often, make a shortcut for it.
    • Click once on the MacSSH PPC application.
    • Under File select Make Alias and drag the MacSSH alias to your dekstop (or to Launcher).
  • Start MacSSH by double-clicking its icon MacSSH icon
  • Under Favorites choose Edit Favorites .
  • In the Favorites window highlight Default to define settings for your default computing connection.
  • Click Edit.

         MacSSH new favorite

  • Under the General tab of the Edit Favorite window
    • set Host Name to u.arizona.edu
    • for the Port: use the pulldown to set it for SSH (that sets it to 22)

         MacSSH genl favorite
  • Under the Security tab
    • set Protocol to ssh2 using the pulldown
    • set the Username to your U-System user ID (your NetID)
    • leave Password blank (you'll be prompted for it later when you actually try to login)

         MacSSH security favorite

  • Under the SSH2 tab set Method to Request pty (default)

         MacSSH ssh2 favorite

  • Click OK.
  • (To create additional connection shortcuts, you can Duplicate your <Default> and then choose Edit to make alterations to it.)
  • MacSSH is now ready for connecting for a compute session, but not for file transport yet.

Tunneling MacSSH

  • To configure your file-transport sessions, you are going to enable tunneling through your SSH sessions. You should have already configured your file-transport software. We use Fetch in this example, but this setup works to tunnel Dreamweaver files, GoLive files, etc. You should use this Fetch link to check that your Fetch configuration is correct for tunneling.
  • Back at the MacSSH Favorites window again, highlight <Default> and click Duplicate. This will become your tunnel-to-the-U-System shortcut definition.
  • With <Default> copy highlighted, click the Edit button.
         MacSSH duplicate favorite
  • In the Edit Favorites window
    • under the SSH2 tab
    • set the Alias name to something meaningful like ftp tunnel
    • set the Method for this shortcut to Local TCP port forward
    • set the Remote host to u.arizona.edu
    • set Local port (on the left) to 21
    • set Remote port (on the right) to 21
    • click the General tab
    • verify that, when you duplicated Default, this Port remained 22 and Host Name remained u.arizona.edu
    • Click OK
    • quit MacSSH (for your changes to take effect it needs to be restarted)

           MacSSH ftp tunnel

You now have 2 MacSSH configurations: a U-System connection configuration (Default) and a file-transport configuration (ftp tunnel)

MacSSH Usage To Top

These directions assume you already have done the above to set up a configuration for and connection to u.arizona.edu.

In order to do any file transmissions your MacSSH client must be running using the ftp tunnel configuration for the tunnel to be open so that Fetch will work.

  • Start MacSSH
  • Under File choose Open Connection
  • In the Open Connection window you would get your default configuration automatically but to copy files use the Host Name pulldown to select ftp tunnel
  • be sure Secure Shell V2 is set in it

         MacSSH ftp tunnel

  • Click Connect
  • The first time you connect using MacSSH you'll get a Host Key Unknown message. Click the Accept and Save button.
         MacSSH host unknown
  • You'll be prompted for your password here.
  • You'll see a U-System session open.

         MacSSH u-cluster tunnel session

  • Start Fetch or the file-transport application you prefer. Your Fetch window may differ from the window below, depending on your version of Fetch. (Here's how to configure Fetch. The configuration for DreamweaverMX is very similar to Dreamweaver4.)
  • Use the Shortcuts pulldown to select your ftp tunnel configuration.
  • You must enter your password in this window also.
  • You can modify these values before you click OK.

         MacSSH fetch connection

  • A directory listing of your U-System account is displayed.
  • If you are uploading webpages, they must go in a directory called public_html in order to be viewed by the public.

         MacSSH u-cluster files

  • "Put" copies a file from your Mac to the U-System.
  • When you click Put
    • Fetch opens a directory listing of your Mac.
    • Find your file and highlight it.
    • Click Open.
    • Fetch displays a Put File window for it.
    • Verify that the file name and the file format are correct (this Format has more options than the 3 that display in the directory listing.
    • Click OK.
         MacSSH put window
  • "Get" works similarly.

    To Top


  • Fetch normally preserves access privileges but, if you stored a webpage, verify that the public can view it by trying to view it yourself with a browser. If you get a "Forbidden" error, you need to change the permissions to make your pages viewable on the web.
  • When you are finished:
    • Close Fetch windows.
    • Quit Fetch.
    • exit/quit your U-System session.
    • Quit the MacSSH tunnel session.
    • You may get a message about active sessions being open, but it's OK to quit/close.

      To Top


go-back arrow Macintosh Security
pointerUA Homepage      CCIT Homepagepointer


The Center for Computing & Information Technology (CCIT)
CCIT Knowledgebase
Telephone: 621-HELP
Email: Consult@listserv.arizona.edu

Website maintained by:
CCIT Computing Services