Skip to content

Latest commit

 

History

History
50 lines (37 loc) · 3.69 KB

vm_deploy.md

File metadata and controls

50 lines (37 loc) · 3.69 KB

Launch (Deploy) an Instance

  1. Jetstream virtual machines (VMs) are organized by projects.
  • To access projects, click on from any screen.
  • To create a new project, click .
  • Fill out the name and description.
    .
    Best practice is to name a project something concise and informative so that, along with the description, one can quickly identify instance roles.
  1. Jetstream VMs may be started clicking New> Instance.
    .
  • This shows a catalog of Images: Instances whose configurations have been saved as template from which to launch identical Instances.
  • On the page listing of images, scroll through the list or enter an image name, tag or description in the search box.
    For instance, to locate images named or tagged with “Docker”, enter that text in the search bar.
    The search is not case sensitive.

    .
  • Featured (system maintained) and Public images are shown. Featured images are recommended as these have been tested by Jetstream staff.
  1. Selecting an image will show the Launch an Instance / Basic Options screen:

* Enter a **name** for the instance
* Select the image **version** if there are multiple versions available
* Select or change the **project** to hold this instance.
* Indicate the **allocation** source. <br>Allocations govern how much compute resources are available. These can be change on the fly.
* Choose the **provider** to run on, Indiana or TACC.<br>Currently Jetstream has two partially independent clouds.<br>Some resources, like storage **Volumes**, are accessible only **within** the same provider.
* Choose the **instance size**. <br>This indicates the vCPUs, memory, and disk size for the VM. See the [Virtual Machine Sizes table](https://wiki.jetstream-cloud.org/Virtual+Machine+Sizes+and+Configurations) to show the available options and the SUs consumed per hour.<br><img src="../../resources/atmo-VM-size.png" width="60%">
* Check projected resource usage: **Allocation Used** and **Resources Instance will Use**.
* Click `Launch Instance` to start the initialization and build of the instance.

  1. When the instance is finished building and deploying, you'll see the label changes to Status "● Active" and shows the IP Address:

  2. Click on the Instance name to see the characteristics of the Instance as well a various management actions that can be taken.

  • Image: create a new Image from this Instance)
  • Suspend: put the Instance to "sleep"
  • Shelve: shutdown and store the Instance
  • Stop: shutdown the Instance but do not store
  • Reboot: restart the instance
  • Redeploy: renew the cloud and IP status of the instance
  • DELETE: remove the Instance
  • Open Web Shell: Open a terminal window (command line) to the Instance
  • Open Web Desktop: Open a VNC Desktop to the Instances

Note: avoid Old WebShell or Old WebDesktop as these are deprecated and going away soon.



Previous: Initial Cloud Setup | Next: Webshell to VM | Top: Course Overview