CADES SHPC Condos

The CADES Scalable HPC (SHPC) Condos consist of two HPC clusters: one in the ORNL Moderate protection zone (CADES Mod) and one in the ORNL Open protection zone (CADES Open). The protection zones contain and control both the software base and the data produced on those systems.

This section outlines the most basic procedures for procuring and using a CADES SHPC Condo allocation.

Requesting access to CADES Open SHPC condos

First setup your UserID:

The first time you join condo or cloud, you will need to set up your CADES user ID in XCAMS. Once you have done this step you will not need to repeat it to join other condo access groups.

• ORNL STAFF: ORNL staff obtain access to CADES through their UCAMS ID by activating it in the XCAMS system.

  • To active your UCAMS ID as your XCAMS CADES user ID, visit https://xcams.ornl.gov and click on "I need an account"
  • Then, after accepting the user agreement, look in the tan box on the right of the screen under UCAMS, and click on "activate your XCAMS account" and complete the required steps

• NON-ORNL STAFF: If you are collaborating with ORNL's staff, you my get access to CADES if you have an ORNL staff host.

  • If you are not a U.S. citizen, please have your ORNL host request a Service-to-ORNL PAS through their division’s PAS inputter.
    • The PAS should request cyber access for CADES usage.
    • When you get the PAS approved you should use the three letter ID that comes with it for your CADES ID in the instructions below.
  • If you are a U.S.citizen or you are a foreign national with an active Service-to-ORNL PAS, use the following steps to gain access to CADES:
    • Visit https://xcams.ornl.gov and click on "I need an account" and complete the required steps
    • You will also need access to the external visitor login nodes, so go to https://xcams.ornl.gov/xcams/groups/cades-misc/ and follow the instructions to request an account
    • This request is reviewed and may take up to five business days for approval

Next setup your Condo Access:

You can request CADES Open SHPC Condo access by clicking on the appropriate XCAMS registration link for your group. If you do not see your group listed, please contact the CADES team.

The XCAMS registration process will ask you to acknowledge the XCAMS User Agreement and register your UCAMS with an LDAP group or create a new XCAMS user ID and the register it with an LDAP group. Use the steps below to enter your request.

1. Navigate to the appropriate XCAMS registration link for your group.
2. Enter your email address (your ORNL address if available) and click Continue.
3. Review the XCAMS user agreement, and select Agree.
4. Enter your UCAMS ID (or a new XCAMS user name).
5. Enter your UCAMS password (or a new XCAMS password).
6. Click Submit to complete the XCAMS request.

When your resources are ready for use, an activation notice will be dispatched to the email address entered above. This process can take up to 24 hours for birthright access and up to a week for the other condo accesses to complete.

Access Your SHPC Condo Allocation

Once your request for resources has been approved, you can access the SHPC Condo login nodes using SSH. Open and Moderate protection zones each have their own login node. Choose the login node for your protection zone. The instructions below assume that you are on the ORNL network on campus or the ORNL VPN at home. Please see the XCAMS Connection Guide, if you are not ORNL staff, or UCAMS Connection Guide, if you are ORNL staff, for more connection options.

Open Protection Zone

1. Open a Bash terminal (or PuTTY for Windows users).
2. Execute ssh username@or-slurm-login.ornl.gov replacing "username" with the username you registered above.
3. When prompted, enter your XCAMS password.
4. CADES-ARM group only will still use ssh username@or-condo-login.ornl.gov.

Moderate Protection Zone

1. Open a Bash terminal (or PuTTY for Windows users).
2. Execute ssh username@mod-slurm-login.ornl.gov replacing "username" with your ORNL UCAMS ID.
3. When prompted, enter your UCAMS password.

Execute a Job on Your SHPC Allocation

Now that you have access to your allocation through the login node, it is time to do some work. The tutorial linked below, intended for users who are new to the CADES SHPC Condo environment, outlines the basic steps to setting up and executing a job on the SHPC Condo compute nodes.

📖   How to: Execute a Job on Your SHPC Condo Allocation

Getting Help

If at any point you feel stuck and need some help figuring out your next move, please contact the CADES support team at cades-help@ornl.gov or join our Slack channel at https://cades.slack.com/signup.