Connecting
The Login process is dependent on what network you are starting from and whether you have been issued an ORNL computer and UCAMS ID.
CADES login nodes are not directly accessible from all networks so some starting points, such as ORNL-Visitor wireless, will require a few additional steps.
| Cades Condo | Login Node |
|---|---|
| Open research | or-slurm-login.ornl.gov |
| ARM users only | or-condo-login.ornl.gov |
| Moderate | mod-slurm-login.ornl.gov |
| External collaborators must jump through this external access node |
collab.cades.ornl.gov |
Prerequisites
To properly utilize SHPC Condos, you will need a couple of utilities loaded on your local machine. These utilities are free and widely used for this type of application.
- Required: SSH client
- Recommended: Bash terminal
📝 Note: CADES does not provide support for getting these utilities up and running on your personal computer.
MacOS and Linux
Both macOS and Linux distributions include a Bash terminal and an SSH client by default. No additional software should be required to access SHPC Condos.
Windows Users
Windows 10 has a native SSH client available through Command Prompt and PowerShell. If you are using an older version of Windows, or would prefer a graphical program, several solutions are linked below.
- Option 1: PuTTY - Graphical SSH client for Windows.
- Option 2: Git Bash – Part of the Git for Windows environment includes Git Bash, which provides a light weight ssh client.
- Option 3: Cygwin – If you wish to have Bash-style functions on your Windows machine, then you should consider installing Cygwin, which ports the Portable Operating System Interface (POSIX) system calls and environment to Windows.
Login Process from the ORNL Campus
| Network | Who can access | Method of access |
|---|---|---|
| ORNLWPA wireless ORNL internal wired |
Generally ORNL staff, however, visiting researchers or contractors who are issued a UCAMS id and an ORNL computer may be able to access these networks and use this process. Your user ID will be a UCAMS ID. |
Log in directly from the CADES Condo login nodes: Open condos: ssh user-id@or-slurm-login.ornl.gov ARM users only: ssh user-id@or-condo-login.ornl.gov Moderate condos: ssh user-id@mod-slurm-login.ornl.gov |
| ornl-visitor wireless | Collaborating Researchers who are not ORNL staff | You must go through the CADES external access node before accessing the login nodes. Step 1: Login to the access node ssh user-id@collab.cades.ornl.gov Step 2: Log in to the condos Open condos: ssh user-id@or-slurm-login.ornl.gov ARM users Only: ssh user-id@ssh or-condo-login.ornl.gov Moderate condos: ssh user-id@mod-slurm-login.ornl.gov |
Login Process from a Remote Location
How you login to CADES from a remote location will also depend on whether you are ORNL staff or not. ORNL staff will have a UCAMS ID and non-staff collaborators will only have an XCAMS ID.
Remote Access for ORNL Staff
For ORNL staff members, external access to CADES will require an ORNL issued RSA soft or hard token from the Solution Center (865-241-6765) and access to the ORNL VPN or external ORNL login nodes. CADES can not request these on your behalf.
📝 Note: You will need to contact the ORNL solutions center to get setup with RSA tokens and VPN.
VPN Method
Use this method if you are initiating your remote access from an ORNL-owned computer. Request an RSA token and VPN access from the ORNL Solution Center (865-241-6765) if you do not already have them. Cades cannot make this request for you, and you will need to install the VPN while you are on campus. Use your RSA Token to active the ORNL VPN then login as if you were on campus: * Open condos: ssh user-id@or-slurm-login.ornl.gov * ARM users only: ssh user-id@or-condo-login.onrnl.gov * Moderate condos: ssh user-id@mod-slurm-login.ornl.gov * Contact the ORNL Solution Center for VPN or RSA token help
External ORNL login node method
Alternately, you can request an RSA token and access to ORNL's external login nodes, login1.ornl.gov or login2.ornl.gov
- You would use this method if you are using your own computer for remote access or if you cannot set up the ORNL VPN for any reason.
- You can self-request the "External Login Server' role from https://ucams.ornl.gov while you are on campus:
- Go to "Main menu -> Access Management -> Resource by Resource -> Request (radio button) -> OK" and choose "ORNL Login Server"
- If you are off campus, contact the ORNL Solution Center (865-241-6765) and they can make the request on your behalf.
- You will still need to pick up an RSA Token when you are on campus.
Once you have access to the external login nodes and your RSA Token:
Step 1: Login to an ORNL external login node:
- ssh ucams-id@login1.ornl.gov
- Enter your PIN + RSA Passcode
Step 2: Login to a condo login node:
- Open condos: ssh user-id@or-slurm-login.ornl.gov
- ARM users only: ssh user-id@or-condo-login.onrnl.gov
- Moderate condos: ssh user-id@mod-slurm-login.ornl.gov
Remote Access for Non-ORNL Staff
You must go through the CADES external visitor login node before accessing the condo login nodes.
📝 Note: You may need a Service-to-ORNL PAS to gain access to the external login node. For instructions about how to gain access to the external login node please see Requesting access to CADES Open SHPC condos.
Step 1: Login to the visitor login node:
- ssh user-id@collab.cades.ornl.gov
Step 2: Login to a condo login node:
- Open condos: ssh user-id@or-slurm-login.ornl.gov
- ARM users only: ssh user-id@or-condo-login.onrnl.gov
- Moderate condos: ssh user-id@mod-slurm-login.ornl.gov
Login Nodes Usage Policy
Cluster login nodes are shared resources. A user must avoid overloading these shared resources. Doing so will inadverdently affect other users sharing the same login system. On login nodes, resource heavy jobs will be prompted swiftly by system monitoring facility. Please migrate heavy workflow onto compute node[s] by following the message instruction or references below:
- How to Execute a Slurm Job
- GUI job examples: