The Graphical User Interface¶
The Graphical User Interface (GUI) provides a point-and-click experience for working with Chameleon resources. From the GUI, you may perform tasks such as manage and launch instances, and configure custom networking. Additionally, you may download an OpenStack RC file from the GUI if you wish to work with the Command Line Interface, instead. The Chameleon GUI is built on top of OpenStack Horizon. There are two Chameleon resource sites, each with its own URL (though it is possible to easily switch from one to other, see Project and Site Menu).
The Texas Advanced Computing Center resources (CHI@TACC) are available at:
The University of Chicago resources (CHI@UC) are available at:
Chameleon also hosts an OpenStack KVM implementation where you may work with virtual machines. This site does not have access to bare metal resources. It is available at:
This section provides an overview of features available on the GUI for the bare metal sites at the Texas Advanced Computing Center (CHI@TACC) and the University of Chicago (CHI@UC). For information about OpenStack KVM, please see KVM.
You may login to either site using your Chameleon portal username and password.
These two Chameleon bare metal sites—CHI@TACC and CHI@UC—only share user accounts, but snapshots, keypairs, Swift containers, Gnocchi metrics and other objects at each site are independent. For example, a keypair created at the CHI@TACC site is not available at the CHI@UC site. In addition, the bare metal resource types vary between CHI@TACC and CHI@UC.
Upon logging in to the GUI at a Chameleon site, you will see your project’s Overview page.
In the settings menu, you can change user specific settings such as the Timezone.
Updating your Timezone is highly recommended. When you make reservations for bare metal resources, your local time will be used. UTC is the default Timezone.
The Help menu item will take you to this documentation site.
OpenStack RC File¶
Clicking on this menu items will download a customized RC file for use with the OpenStack
Command Line Interface. Source the RC file using
source command to configure
environment variables that allow you to easily log in using the Command
Line Interface. For more information about OpenStack RC script, please
see The OpenStack RC Script.
You may change the GUI theme by selecting the provided menu items.
Use the sign out menu item to sign out from your current site.
If you do not sign out manually, your session will expire in 30 minutes.
Use Compute section for reserving, configuring and managing your instances.
The Overview page provides a graphical summary of your project’s current resource usage.
At the bare metal sites, you may launch as many instances as you like, but bounded by the project Service Unit allocation. However, at the OpenStack KVM site, your project is limited to a certain number of virtual machines. By default, each project is allowed to allocate 50 Floating IP addresses and use 10 Security Groups. You may request additional resources by submitting a ticket on the help desk.
The Instances page allows you to work with your instances. You may launch, terminate, monitor, or reboot an instance. Clicking on the dropdown list in Action column to see what you are eligible to do to your instances.
The Images page allows you to view, upload and edit the images. You may also use this page to launch instance using selected images.
You can only edit the images you own.
Search for images using the filter bar.
The Key Pairs page allows you to create, import and manage SSH key pairs associated with your user account.
Chameleon only stores the public key for each SSH key pair. Do not upload your private key to the portal! Private keys look like this:
To delete a SSH key pair, click on the Delete Key Pair button in the Action column. You may delete multiple key pairs by selecting them via the checkbox and clicking the Delete Key Pairs button.
Creating a Key Pair¶
To create a key pair, click the + Create Key Pair button. In the prompted dialog, provide a name for your new key pair and then click the Create Key Pair button.
.pem file that contains the Private Key should be automatically
downloaded. In addition, the Public Key associated with the Private Key
should be saved automatically to Chameleon. Clicking on the Regenerate and
download Key Pair button will generate a new Public/Private Key Pair and
initiate a new download of the Private Key.
Save the Private Key to a location you will remember at your local file system. Your home directory is recommanded for macOS and Linux systems.
Importing a Key Pair¶
Alternatively, you may import a key pair that you have generated on your computer. Clicking the Import Key Pair button to prompt the dialog. Then, provide a name for your imported key pair and paste the Public Key.
The prompted dialog contains the instructions on how to generate a key pair using the Linux/macOS command.
Typically, the key generated from your computer will be at
~/.ssh/id_rsa.pub. On Mac OS X, you can run in a terminal:
~/.ssh/id_rsa.pub | pbcopy. It copies the content of the public key to your
copy/paste buffer. Then you can simply paste in the “Public Key” box.
The Network section allows you to work with virtual network resources, such as configuring routers and virtual networks. For more information, please see Networking.
The Network Topology page displays your current virtual network topology in either the Topology or Graph formats. You may also use this section to directly launch instances, create networks or create routers.
The Networks page lists all the Virtual Networks of the selected project. You may use this section to create, delete and modify Virtual Networks. Clicking on the dropdown list (if shown) in Action column to see what you are eligible to do to your virtual networks.
Same as the Networks page, the Routers page allows you to work on the Routers of the selected project.
Use the Security Groups page to create, delete, and modify the Security Groups of the selected project.
The Floating IPs page allows you to work with the Floating IP addresses allocated for the selected project, including associating with instances and releasing back to the pool. Clicking on the dropdown list (if shown) in Action column to see what you are eligible to do to your Floating IPs.
Releasing Floating IP Addresses¶
The Chameleon Floating IP address pool is a shared and finite resource. Please be responsible and release the Floating IP addresses that are not used, so other Chameleon users and projects can use them!
To release a single Floating IP address, click on the dropdown in the Actions column and select Release Floating IP . You may also release multiple addresses by selecting them via checkboxes and clicking the Release Floating IPs button.
The Orchestration section allows you to work with the Chameleon’s Complex Appliances.
A deployed complex appliance is referred to as a “stack” – just as a deployed single appliance is typically referred to as an “instance”. The Stacks page allows you to launch, rebuild, or terminate stacks.
After launching a stack, all the instances launched with the stack can be viewed at Compute - Instances section as well.
When you terminate a stack, all instances launched with the stack will be terminated.
The Resource Types page lists the currently available Orchestration Resource Types of Chameleon. You may click on the resource types to get details. The Orchestration Resource Types are used when writing OpenStack Heat Orchestration Template. For more information about OpenStack Heat, please see the OpenStack Heat documentation.
The Template Versions are also used when writing OpenStack Heat Orchestration Template. Clicking on the version to get supported features of the specific version.
The Containers section under Object Store gives an easy access to your Chameleon object/blob store. You may create, delete, upload objects to or remove objects from containers via this page. For more information about Chameleon Object Store, please see Object Store.
The Reservations section allows you to manage your leases of the selected project, including creating and deleting leases. For more information, see Reservations.
Check Lease Calendar, so you can schedule your experiments efficiently.
The Project section under Identity allows you to check what projects you belong to. You can set your default project by clicking the Set as Active Project button in the Actions column.