Before you begin, you will need two things:

1. SSH client
2. An Amadeus account . When following the link, please select a BioDesk account

Once you have the above items, it is safe to continue.

Connecting

NOTE: If you are connecting from any computer OUTISDE the University of Arizona, you need to connect using the campus VPN.
For instructions on setting up the VPN client, see the Documentation here: https://sitelicense.arizona.edu/vpn/  

Start the SSH client by either opening it through the start

menu or through one of the shortcuts found either on the desktop or on the quick lauch menu.
    

If you are opening it through the start menu, you can find the SSH client by cliking on:
     Start->Programs->SSH Secure Client->Secure Shell Client
 If you are opening SSH through one of the short cuts,  double clik on the SSH icon .

Once the program starts, open the “Connect to Remove Host” dialog by either:

• Going to File->Quick Connect
• Cliking on the “Quick Connect ” icon
  
• Simply pressing the space bar on your keyboard

In the “Connect to Remote Host” dialog enter “Amadeus.biosci.arizona.edu” as the host name and your user

name as the user name.

If this is the first time connecting to Amadeus from the machine you are currently working on, a confirmation dialog will appear asking you whether or not to save the

Amadeus.biosci.arizona.edu public key to the database. If there

will be future connetions to Amadeus from the machine you are working on, it will be best to click “Yes“

Enter your password when promted and click “OK ”

Congratulations, a successful connetion to Amadeus has been

made. If things go wrong, please see what can go wrong

If you will be connecting to Amadeus frequently, you might

want to add the connection to your profiles. By adding the

profile, SSH will save the host name and username.

To add the connection to your profiles:

• Connect to Amadeus as described above.
• Once you are connected, the “Add Profile” dialog will   appear on the upper right hand corner.
• Write “Amadeus” or any other significant profile name on    the text field.
• Click on “Add Current Connection to Profiles” to add the profile.

Connect using a profile

If you are connecting to Amadeus using a previously created profile:

• Open the SSH Client
• In the SSH tool bar, select the “Amadeus ” profile from the “Profiles ” drop down menu.
  
• Alternatively, the profile can be selected by going to File->Profiles->Amadeus
• Enter your password when prompted

If problems arise please see what can go wrong

File Transfering

Transfering files using SSH is as simple as dragging and droping.
To tranfer files to and from your Amadeus account:

• Connect to Amadeus as described  above
• Open the file transfer utility by clicking on the icon shaped like a folder on the toolbar.
  
  • A new window will open. This window will allow you to transfer files as you would normally with explorer.  Note that the window opens up in your home directory on Amadeus.
    
• Navigate to the location where you want to upload or download files on Amadeus.
• Transfering files:
  • If you are downloading. Drag the file from the SSH File Transfer window and drop it in the location on your computer
    where you want the file to be.
    
    Alternitavely you can click on the download icon and   save the file as you normally would with a "Save As" dialog .
  • If you are uploading, drag the file you want to upload and drop it in the appropriate folder in the SSH File Transfer window. Alternivately you can click on the upload icon   and select the file as you normally would with an "Open File" dialog.
• If a file with the same name already exists you will be prompted to confirm an overwrite. Confirm if you wish to overwrite. Otherwise either choose another location to upload/download the file or change the file name.

What can go wrong?

1. User Authentication Failure
   This is usually due to either a bad username or bad password submission.
   • Try reconnecting, making sure both username and the password are correct.
   • If that does not solve the problem, try one of the other troubleshooting tips.
2. Connection Failure
   
   This is error can have various causes. To fix the problem:
   • Make sure you typed the host name correctly.
   • If a firewall is in place double check the firewall settings, and make sure the SSH program is being allowed to make outgoing connections on port 22.
   • Intead of typing “ Amadeus.biosci.arizona.edu ” as the host name, type “128.196.124.145”
     
3. Disconnection
   
   This error is caused when the connection between Amadeus and your computer was lost. Since a lost connections are normally brief, reconnect and try uploading/downloading the file again.