Bridges User Guide
Connecting to Bridges
Before the first time you connect to Bridges, you must create your PSC password. Depending on your preferences, you may want to change your login shell once you are logged in.
Content of this document
This document will tell you how to
Create or change your PSC password
If you do not already have an active PSC account, you must create a PSC password (also called a PSC Kerberos password) before you can connect to Bridges. Your PSC password is the same on all PSC systems, so if you have an active account on another PSC system, you do not need to reset it before connecting to Bridges.
Your PSC password is separate from your XSEDE Portal password. Resetting one password does not change the other password.
Setting your initial PSC password
To set your initial PSC password, use the web-based PSC password change utility.
Changing your PSC password
There are two ways to change or reset your PSC password:
- Use the web-based PSC password change utility
- Use the kpasswd command when logged into a PSC system. Do not use the passwd command.
When you change your PSC password, whether you do it via the online utility or via the kpasswd command on one PSC system, you change it on all PSC systems.
Connect to Bridges
When you connect to Bridges, you are connecting to one of Bridges' login nodes. The login nodes are used for managing files, submitting batch jobs and launching interactive sessions. They are not suited for production computing.
See the Running Jobs section of this User Guide for information on production computing on Bridges.
There are several methods you can use to connect to Bridges.
- ssh, using either XSEDE or PSC credentials. If you are registered with XSEDE for DUO Multi-Factor Authentication (MFA), you can use this security feature in connecting to Bridges.
- gsissh, if you have the Globus toolkit installed
- XSEDE Single Sign On, including using Multi-Factor authentication if you are an XSEDE user
You can use an ssh client from your local machine to connect to Bridges using either your PSC or XSEDE credentials.
SSH is a program that enables secure logins over an unsecure network. It encrypts the data passing both ways so that if it is intercepted it cannot be read.
SSH is client-server software, which means that both the user's local computer and the remote computer must have it installed. SSH server software is installed on all the PSC machines. You must install SSH client software on your local machine.
Read more about ssh in the Getting Started with HPC document.
Once you have an ssh client installed, you can use either your PSC credentials or XSEDE credentials (optionally with DUO MFA) to connect to Bridges. Note that you must have created your PSC password before you can use ssh to connect to Bridges.
Use ssh to connect to Bridges using XSEDE credentials and (optionally) DUO MFA:
- Using your ssh client, connect to hostname bridges.psc.xsede.org or bridges.psc.edu using port 2222.
Either hostname will connect you to Bridges, but you must specify port 2222.
- Enter your XSEDE username and password when prompted.
- (Optional) If you are registered with XSEDE DUO, you will receive a prompt on your phone. Once you have answered it, you will be logged in.
Use ssh to connect to Bridges using PSC credentials:
- Using your ssh client, connect to hostname bridges.psc.xsede.org or bridges.psc.edu using the default port (22).
Either hostname will connect you to Bridges. You do not have to specify the port.
- Enter your PSC username and password when prompted.
If you have installed the Globus toolkit you can use
gsissh to connect to Bridges. Gsissh is a version of ssh which uses certificate authentication. Use the command
myproxy-logon to get a suitable certificate. The Globus toolkit includes a man page for myproxy-logon.
See more information on the Globus Toolkit website.
You can also use the public-private key pair method to connect to Bridges. To do so you must first fill out our form for this type of access.
XSEDE single sign on
XSEDE users can use their XSEDE usernames and passwords in the XSEDE User Portal Single Sign On Login Hub (SSO Hub) to access bridges.psc.xsede.org or bridges.psc.edu.
You can use DUO MFA in the SSO Hub if you choose.
Change your default shell
change_shell command allows you to change your default shell. This command is only available on the login nodes.
To see which shells are available, type
To change your default shell, type
where newshell is one of the choices output by the
change_shell -l command. You must use the entire pathoutput by
change_shell -l, e.g. /usr/psc/shells/bash. You must log out and back in again for the new shell to take effect.