- Accessing Remotely Using SFTP
-
Accessing Remotely Using SFTP
We provide access to various network drives through use of secure file transfer protocol (SFTP) tools, which provides a mechanism through which you can access network drives securely from any Internet-connected machine.
SFTP access is available from a wide variety of computer platforms. Read About File Access for a good introduction and links to step-by-step instructions.
For additional assistance, please contact us.
- About File Access
-
About File Access
You can access files on your network volumes by using a variety of different methods, as described in this guide; however, all of the following methods are built upon SFTP, a standard protocol for secure file transfer. This means that all these methods have similar requirements; if you can connect via one method, you can use any of the others, but if you cannot connect via one, you are likely to encounter difficulty with the others.
Requirements
You need to know the following information before you can proceed. if you do not know all of the following items of information, you cannot connect successfully to your network volume:
- Account username
- Account password
- Server name to which you are granted access
You can use SFTP tools to access either of your network accounts: CGIS or RCE.
When you log in to your network home or group volumes, you use your CGIS account information to log in to the network. Previous to Fall semester 2009, you used NetStorage tools to access your network home and group volumes. Use that account username and password to access your file remotely by using SFTP. Note that the server name for CGIS accounts is
sftp://desktop.hmdc.harvard.edu.When your RCE account was created, we sent you email containing your account username. That email also contained a URL which you were required to use to set your account password. If you succeeded in setting your password, you received another email naming at least one server to which you are granted access.
Note: HMDC Support will contact you when they migrate your CGIS account to Linux-based services, and work with you to ensure you can use the SFTP tools to access that account remotely. This transition will take place over a period of weeks during Fall semester 2009, and HMDC Support will inform you at the time they migrate your account. Until your account is migrated to the Linux platform, you can continue to use NetStorage to access your network volumes. Please see Accessing Remotely for information about using NetStorage tools.
If you do not know all three of the items of information specified previously, please contact us before proceeding.
Examples
Examples in this document use the username
shuffand the serversftp.hmdc.harvard.edu. When you try to connect, please make sure that you use your own username and server and do not copy these examples.Where to Start
For general-purpose file transfer, such as moving data or results to and from the network, modifying web sites, software development, and more, begin by reading Accessing Files Using FileZilla. This document is appropriate for Windows, Mac, or Linux users.
If you edit a web site using Dreamweaver and would like to use Dreamweaver's built-in SFTP support to apply your changes, read Accessing Files Using Dreamweaver and SFTP. This document is appropriate for Windows or Mac users.
If you use a Mac, please see Accessing Files Using SFTP on a Mac for a description of a file transfer method that is more streamlined and Mac-like than FileZilla.
If none of these approaches are a good match for your needs, please contact us.
- Accessing Files Using FileZilla
-
Accessing Files Using FileZilla
We recommend using the free utility FileZilla to transfer files between your network volume and your workstation. While this document will focus on using FileZilla on Windows, FileZilla also runs on Mac OS X and Linux, and the interface is very similar.
- Installing FileZilla
-
Installing FileZilla
To install FileZilla, you must download the installer package and then install it.
- Open a web browser and navigate to the FileZilla Client Download page.
- Locate the Windows section, then click the link for the
setup.exeversion (the text recommended is printed next to the appropriate link).

- You are redirected to another site, where your download begins automatically after a few seconds.
You might see an error message about encrypted data. The following example shows the message that Firefox displays.
This message is benign, and you can continue safely.

- You are prompted to save the package.
Save it somewhere you will be able to find again. Your Desktop is a good place.

- After the installer package downloads, double-click it to install.
You might see an error message saying that Windows cannot verify the publisher of the package. Again, this is benign, and you can click Run to continue safely.

- Accept the FileZilla license agreement by clicking I Agree.

- When prompted to select an install location, select Only for me and click Next.

- Leave the default components unchanged and click Next.

- Leave the default install location unchanged and click Next.

- Leave the default Start Menu folder unchanged and click Install.

- When you see a window similar to the following, FileZilla is installed successfully.
Click Finish to launch the program for the first time.

If you reach this point successfully, you now can connect to your network volume using FileZilla. If you encountered problems along the way, do not continue; instead, contact us for assistance.
- Connecting Remotely Using FileZilla
-
Connecting Remotely Using FileZilla
After you install FileZilla successfully, you can set up your first connection to your network volume.
Before you continue, please make sure you have all the necessary information for a successful connection, as documented in the About File Access. If you do not have this information, please contact us for assistance.
To connect to your network volume, perform the following:
- Near the top of the FileZilla window, you see a set of four input fields labeled Host, Username, Password, and Port.

Enter the following information in these fields to set up your connection:- Host - Enter the server name to which you choose to connect, and make sure that you specify protocol to use. The appropriate protocol to use is SFTP; a sample URL would be
sftp://desktop.hmdc.harvard.edu. - Username - Enter your account username. If you entered your CGIS server name in the Host field, then enter your CGIS username in this field. Likewise, if you entered your RCE server name in the Host field, then enter your RCE username in this field.
- Password - Enter the password for the account you specified in the Username field. Note that the characters will be hidden.
- Port - Leave this field blank.
The following is an example of a properly configured FileZilla connection. The URL in the Host field is too big to fit, so some of it is hidden.
- Host - Enter the server name to which you choose to connect, and make sure that you specify protocol to use. The appropriate protocol to use is SFTP; a sample URL would be
- Click the Quickconnect button to initiate the connection.
The first time you connect, you see an Unknown host key dialog. - Click the Always trust this host, add this key to the cache check box, and then click OK.
You see a similar message the first time you connect to any new server. If you add the key to the cache each time, you should not see this message upon subsequent connections to the same server.

- You see some status messages in the upper area of the FileZilla window during the connection process.
When you are connected successfully, files and folders will appear in the right-hand panel.
The following window shows an example of a successful connection.

If you reach this point without problems, you are ready to transfer files back and forth between your network volume and your workstation. Note that if you click the down-arrow next to the Quickconnect button, you see a list of all servers to which you connected previously and you do not have to type in all of the information again.

- Near the top of the FileZilla window, you see a set of four input fields labeled Host, Username, Password, and Port.
- Transferring Files Using FileZilla
-
Transferring Files Using FileZilla
When you are connect to your network volume using FileZilla, your local workstation file and folders are displayed in the left pane, which is labeled Local site. Your network volume files and folders are displayed in the right pane, labeled Remote site.
Locating Your Desktop and Shared Space
On your local workstation, general use folders are in the following location:
- Windows -
C:\Documents and Settings\<user name>\My Documents - Mac -
/Users/<local machine name>/Desktop/
On your network share, your shared space is in the following location:
- CGIS account -
/nfs/desktop_groups/<your department>/
For example,/nfs/desktop_groups/wcfia/ - RCE account -
/nfs/home/<username first letter>/<username>/shared_space/
Transfering Files
To transfer files between locations, drag the files and folders from the your local workstation in the left pane to your network volume in the right pane, or vice versa.
The following example refers to a folder called
examplein your localMy Documentsfolder; theexamplefolder contains a single file,example.txt. On the network side, the example refers to a project share,shuff, in the networkshared_spacefolder.- Navigate to the source folder on your local workstation in the left pane.

- Navigate to the destination folder on your network volume in the right pane.

- Drag the source folder on your local workstation (
example) to the target folder on your network volume (shuff).
Some log messages will appear in the upper part of the FileZilla window. When you see the messageStatus: File transfer successful, the transfer is complete.

To transfer files or folders in from your network volume to your local workstation, drag them from the right panel to the left panel.
Large files, or folders containing many files, might take a long time to transfer. During a large transfer process, files waiting to be transferred are listed in the Queued files panel at the bottom of the FileZilla window.
- Windows -
- Editing Files Remotely Using FileZilla
-
Editing Files Remotely Using FileZilla
When you are connected to your network volume using FileZilla, you can edit files without first transferring them manually to your local workstation.
Perform the following to edit documents on your network volume:
- Open FileZilla and connect to your network volume.
See Connecting Remotely Using FileZilla for detailed information. - In the Remote site panel on the right side of the FileZilla window, right-click the file that you choose to edit and then select View/Edit from the context menu.
Your file opens in the appropriate program based on the file type.
- Make your changes to the file. When you finish editing, save and then close the file.
FileZilla prompts you to re-upload the file to the server and overwrite your original file.
- Click Yes to upload your edited file.
After the file uploads, your edited file is available on the network volume.
If you encounter any problems using FileZilla, please contact us.
Image(s): - Open FileZilla and connect to your network volume.
- Accessing Files Using Dreamweaver and SFTP
-
Accessing Files Using Dreamweaver and SFTP
To access your web site files by using Dreamweaver's built-in SFTP function, use the following procedure.
Note: Dreamweaver refers to the both FTP and SFTP protocols as FTP, which can be confusing.
As with the other remote access methods described in this document, please make sure that you know the required information as described in the About File Access.
- Open Dreamweaver, and from the Create New section, select Dreamweaver Site.

- Enter a name for the site.
Then, select the Advanced tab at the top of the window; do not click Next.

- Enter the local file destination (this is the folder on your local workstation where Dreamweaver stores a copy of your web site), and then select Remote Info from the menu on the left.

- Select FTP from the pull-down menu, and fill out the connection information as follows:
- FTP host - Enter the name of the network server to which you are granted access.
- Host directory - Enter the full path to your web site. We sent this to you in an email when your web site was first set up. If you do not have this information, please contact us before trying to proceed.
- Login - Enter the username for the account assocated with the server you entered in the FTP host field.
- Password - Enter the password for the same account.
- Use Secure FTP (SFTP) - Check this box. Without this option, you cannot connect to the remote server.
- After you fill in the connection information, click the Test button to verify that you have done so correctly.
The Windows firewall might display a warning message indicating that Dreamweaver is attempting to connect to our servers. It is safe for you to click Unblock.
- Dreamweaver will display a message similar to the following after you configure your connection properly. If you do not see this message, do not proceed; double-check the previous steps in this procedure to make sure you followed them correctly, and contact us if you are unable to successfully connect using the Test button.

- Check the Automatically upload files to server on save box.
- Check the Enable file check in and check out box.
In the Check out name and Email address fields, enter your full name and your email address. - Click OK when finished.
A correct configuration looks similar to the following figure.
After you complete the configuration, your new site appears in the Files sidebar. You now can edit the site using Dreamweaver. If you need assistance using Dreamweaver to edit the site, please contact us.

- Open Dreamweaver, and from the Create New section, select Dreamweaver Site.
- Accessing Files Using SFTP on a Mac
-
Accessing Files Using SFTP on a Mac
Mac OS X users can use the free MacFUSE software package to access HMDC-hosted SFTP shares, such as web sites and project space. The addition of the Macfusion frontend makes configuration and access simple and straightforward.
Note: This software requires Mac OS X 10.5 or later. Also, before using this method of file access, you'll need to make sure you have all the required information as enumerated in the About File Access.
Read the following topics to install and configure these tools:
- [[link:kb-540].
- Installing Macfusion.
- [[link:kb-547].
After you complete this set up, connecting to your shares is a quick and easy process.
- Installing MacFUSE
-
Installing MacFUSE
Note: You must restart your Mac after installing MacFUSE. Please be prepared to do so before proceeding to Macfusion installation and configuration.
- Visit the MacFUSE web site.
The latest version of MacFUSE is linked from the Featured Downloads section. At this time, the current version is MacFUSE-2.0.3,2.dmg. - If you use Firefox to download the disk image, you are asked what to do with it.
Open the image using DiskImageMounter.
Alternately, you can download the disk image, then double-click it after the download is complete.
After you download and mount the disk image, you see the installer package, MacFUSE.pkg. - Double-click the installer package to launch the installer.

- Click OK and Continue as you proceed through the installation.
The installer prompts you to enter your password before it can complete. - Complete the installation and restart your Mac.
You see a new item in your System Preferences, in the Other section, entitled MacFUSE.
If you see this item, proceed to Installing Macfusion; if not, please contact us for assistance.
Image(s): - Visit the MacFUSE web site.
- Installing Macfusion
-
Installing Macfusion
Do not install and configure Macfusion until you successfully install MacFUSE.
To install Macfusion:
- Visit the Macfusion web site.
The latest version is available by using the Download link near the top of the page. - Download the ZIP archive, then double-click the archive to expand the Macfusion application.

- Drag this application into your Applications folder, then double-click it to launch it.
Image(s): - Visit the Macfusion web site.
- Configuring Macfusion
-
Configuring Macfusion
As with the other file access methods, please be sure that you have all the required information enumerated in the About File Access before proceeding.
NOTE: You must know the name of the server to which you have been granted access before proceeding; in addition, if you are connecting to a project share or a web site, you must know the name of the project share or the web root directory before proceeding. The examples listed below are only examples; they will not work for all users.
To determine which servers you may access, log into the HMDC account management page (https://help.hmdc.harvard.edu/account_manager/) using your RCE username and password.
To configure Macfusion:
- Open Macfusion.
A blank window is displayed.

- Click the plus menu, then select SSHFS to add a new SFTP target.
- To create a target pointing to your home directory, fill in the fields as follows:
- Title - We suggest that you use HMDC Home.
- Host - Enter the name of the server to which you are granted access (check the HMDC account management page if you are not sure of the hostname).
- User Name - Enter the username associated with the host you entered above.
- Password - Leave this blank.
- Path - Leave this blank.
- To create a target pointing to a project share, fill in the fields as follows:
- Title - We suggest that you use HMDC <project> Project.
- Host - Enter the name of the server to which you are granted access (check the HMDC account management page if you are not sure of the hostname).
- User Name - Enter the username associated with the host you entered above.
- Password - Leave this blank.
- Path - Enter shared_space/<project>
(contact us if you are unsure of the name of the project share).
- To create a target pointing to a web site, fill in the fields as follows:
- Title - We suggest HMDC <web site> Site.
- Host - Enter the name of the server to which you are granted access (check the HMDC account management page if you are not sure of the hostname).
- User Name - Enter the username associated with the host you entered above.
- Password - Leave this blank.
- Path - Enter /nfs/www/<web site> (contact us if you are unsure of the name of the web site directory).
- Open Macfusion.
- Using Macfusion to Access Your Sites
-
Using Macfusion to Access Your Sites
After you configure your targets:
- Mount your targets to access the files that they contain. You can do so in one of two ways:
- In the Macfusion window, click the Mount button next to a target.

- On the Macfusion menu bar in the upper-right corner of the window, select Favorites, and then select the desired target.

- In the Macfusion window, click the Mount button next to a target.
- You are prompted to enter your account password.
Note: Do not save your password in the Keychain.
- On the Finder menu, select the Go menu Computer option, or press Command-Shift-C.
You see the mounted target or targets appear as standard volumes.
To unmount an SFTP target, right-click the volume and select Eject "<target>". Or, click the Unmount button next to the target in the Macfusion window.
Custom Target Names
If you regularly access multiple targets, you can give them custom names to better differentiate them in the Finder. To do so:
- Edit the target in Macfusion.
- Select the Macfusion pane, then enter a custom name in the Volume Name field.

- Mount your targets to access the files that they contain. You can do so in one of two ways:
- Improving Access Performance
-
Improving Access Performance
MacFUSE and Macfusion show good performance for many typical use cases. However, if you experience unacceptably slow performance, try the following adjustments:
-
If you are off-campus or using a slow connection, consider enabling compression for file transfers.
This should not be necessary when inside the Harvard network.- In Macfusion, select the desired target and click Edit.
- Select the SSH Advanced tab.
- Check the Enable Compression box and click OK.
- If the target is mounted currently, unmount it.
- Mount the target and check to see if you experience better performance.
-
If you are browsing targets with very large numbers of files, consider disabling some of the metadata features in OS X.
Be aware, however, that doing so may induce instability or unpredictable behavior.- In Macfusion, select the desired target and click Edit.
- Select the Macfusion tab.
- Check the Ignore Apple Double Files box and click OK.
- If the target is mounted currently, unmount it.
- Mount the target and check to see if you experience better performance.
-