cacao logoCACAO Overview ≫ Getting started for new users

Getting started for new users

CACAO is a space for you to organize and manage your Jetstream cloud resources. Once you obtain your Jetstream allocation, this guide will help you get started.

1. Login to CACAO

CACAO uses Globus XSEDE credentials for identity

  1. In your browser, connect to https://cacao.jetstream-cloud.org
  2. Click Sign-In button.
  3. If you are not currently logged into ACCESS, you should select the “ACCESS-CI (XSEDE)” identity provider
  4. Enter your ACCESS login credentials
  5. You may need to authenticate with your two-factor
  6. Upon successful login, you will land into the CACAO dashboard

xsede login

2. Add your Jetstream 2 credentials

Access to any Jetstream 2 cloud will begin with adding the OpenStack Application Credentials for your ACCESS project/allocation.

  1. Click on the Credentials menu
  2. Click on Add Credential button
  3. Select Cloud Credential
  4. Select Jetstream 2
  5. Click Next
  6. Select the ACCESS allocation that you wish to import into CACAO (if you belong to multiple allocations, you can select multiple allocations)
  7. Click on the Add button

add jetstream openstack password

3. Add a Public SSH Key

SSH Keys are used to login to virtual machines (sometimes called ‘servers’ or ‘instances’) after they are launched.

  1. Click on the Credentials menu
  2. Click on the Add Credential button
  3. Select Public SSH Key
  4. Enter a name for your public ssh key
  5. Paste in your public ssh key
  6. Click on the Add button

add ssh key

4. Create your first deployment

  1. Click on the Deployments menu
  2. Click on the Add Deployment button
  3. Select Workspace, then Next button
  4. Select the “simple launch of one or more vms” Template, then Go Button
  5. Select the region; if unsure, “IU” is the default
  6. Click Next button
  7. Enter your deployment values A. Deployment Name B. Select your Image C. Number of instances D. Size (also called ‘flavor’)
  8. Click Next button
  9. Review the deployment settings, then click Submit button

add deployment

5. Congratulations on your first CACAO deployment!