Existing Users: Access CADES Cloud Now

What is CADES Cloud?

Oak Ridge National Laboratory’s (ORNL’s) Compute and Data Environment for Science (CADES) now provides eligible customers with an OpenStack cloud computing solution with customizable virtual machines (VM). This new resource, called “CADES Cloud,” enables customers in science and technology directorates to leverage self-service portals to rapidly request these VMs for production, testing, and development.

These CADES services are available at no cost to ORNL researchers.

How Do I Get Started?

The guide below serves as a quick start for new users of the CADES Cloud service.
The CADES team has also developed a comprehensive user guide for the Cloud, which is available here.

Launch a Virtual Machine

Creating and launching a VM Instance is one of the first steps to utilizing your cloud allocation. When launching a VM, you will choose a name for your Instance, which network it will utilize (internal or external), which operating system you would like to run (CentOS or Ubuntu), and which VM flavor (size and specifications) you need for your application.

The following is meant to be used as a minimum-detail quick guide to launching a VM. You may find, at the end of the process, that the VM you have created isn’t quite right for your needs. The great thing about using these OpenStack VMs is that you can delete it and start over so that you may change the specifications.

Before you begin, have you requested your CADES Cloud allocation? An activation notice will be dispatched to your ORNL email address when your resources are ready for use.

  • Navigate to the web interface at https://cloud.cades.ornl.gov/.
  • Log in with your UCAMS credentials.
    • Domain: ornl
    • Username: Your three-letter UCAMS ID
    • Password: Your UCAMS password
  • Navigate to Project → Compute → Instances.
    • Click the Launch Instance button, and fill out each section of the resulting dialog (shown in the next section).

What follows is a series of tabs (along the left of the Horizon “Launch Instance” dialog screen). Fill out the information as it pertains to each tab. You may move freely between tabs without losing progress.

  • Details Tab
    • Instance Name – This name can contain up to 15 alphanumeric characters and a hyphen. No special characters are permitted, and the hostnames are case sensitive.
    • Availability Zone – nova is the default zone.
    • Count – The number of instances to start up at once.
  • Source Tab
    • Select Boot Source – Set this to Image
    • Create New Volume – Two options:
      • Yes: This creates a virtual disk on CADES’s central storage (recommended).
      • No: A virtual disk is created on a hypervisor; this disk is not persistent when the VM is deleted. This type of storage is referred to as an “ephemeral volume.” The size of the volume can be increased, by migrating the instance to a larger flavor size, which can be done yourself without CADES assistance.
    • Delete Volume on Instance Delete – Set to No if data should persist between Instance restarts.
    • Volume Size – Must be greater than or equal to the flavor size and fit within your allocation quota.
    • ????Note: It is recommended to size the root volume appropriate to your needs, keeping in mind that small root volumes are typically used. Additional volumes (for data, logs, etc.) can be attached to an instance, detached and attached to a new VM, etc. A best practice recommendation is for root volumes to contain only the OS.
    • Device Name – This should almost always be the default, vda.
    • Choose from the available options by clicking the + next to the desired image.
  • Flavor Tab
    • Choose the flavor which provides the desired CPU and memory and click + to add it to your allocation.
  • Networks Tab
    • Choose one of two routable network configurations, and click + to add it to your allocation.
      • general_extnetwork1, 128.219.184.0/21 – Available from outside ORNL. However, outward-facing services (e.g., SSH, web server) will require ORNL firewall exceptions).
      • general_intnetwork1, 172.22.0.0/20 – Internal to ORNL.
  • Network Ports Tab
    • No user input required. Skip this tab.
  • Security Groups Tab
    • No user input required for standard SSH access. Skip this tab.
  • Key Pair Tab
  • ????Note: Before deciding between Option 1 or Option 2, you should check your local machine for an existing key pair (instructions).
    • Option 1: Create a new key pair for this instance.
      • Click the + Create Key Pair button.
      • Enter a name for your new key pair in the resulting dialog.
      • Click Create Key Pair to associate this new key pair to your Instance.
      • The private key will be downloaded to your local machine as a .pem file.
      • On your local machine, place the .pem file in the ~/.ssh/ directory (instructions).
    • Option 2: Use the available key pair for this Instance.
      • Choose the desired key pair, and click + to associate it with your VM Instance.
  • Configuration Tab
    • No user input required. Skip this tab.
  • Metadata Tab
    • No user input required. Skip this tab.

Click Launch Instance when you have completed all required sections.

Congratulations! A new instance will be launched. Once fully provisioned, the status will change to “Running,” and you can access your VM Instance using SSH (instructions).

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.

Additional CADES Resources

Additional CADES resources are available on a limited basis by request and pending review by the CADES Resource Utilization Council.

For additional CADES resource allocations, please send a detailed request to the CADES Resource Utilization Council at cades-ruc@ornl.gov.