Skip to end of metadata
Go to start of metadata

1. To get started using a Jetstream virtual machine, click Launch New Instance from the Dashboard screen. On the list of images page, scroll through the the list of images or enter an image name, tag or description in the search box. For instance, to locate images named or tagged with “CentOS”, enter that text in the search bar. The search is not case sensitive.  



2. After selecting an image, details about that image will be displayed.  From here, add the selected image to a project, star it as a favorite, or edit image information.  Click Edit details to:

  • Update the name of the image
  • Set a date to hide the image from public view
  • Modify the description
  • Add or delete tags
  • Click Save
  • Click Launch



3.  On 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 create a project to hold this instance. If you have any existing projects, they will be shown here and you can select one. If you don't have any existing projects, click Create New Project and fill in Project Name and Description. A detailed description is optional, but it is recommended to include any grant names or other easily identifying details so others working with you may easily find it. Click Create to create the new project.
  • Indicate the allocation source
  • Choose the provider to run on, Indiana or TACC
  • Choose the instance size. This indicates the vCPUs, memory, and disk size for the VM. See the Virtual Machine Sizes table to show the available options and the SUs consumed per hour.  Check projected resource usage: Allocation Used and Resources Instance will Use.
  • Click Launch Instance to start the initialization and build of the instance.




Below are several screens that typically displayed during the provisioning process.




The instance will be ready for use when a green dot (◉) and  Active are in the Status column .



Please note that it may take some time for instances to become active, 5-10 minutes on average. The start up time also depends on how busy the system is and on the size of the VM requested.


Once the instance is Active additional management actions, may be performed on the image.


Find the public IP assigned to your instance from the VM

If your VM has a public IP address and you need to find that IP (and don’t have ready access to the Jetstream interface), use wget or curl from the command line to get your public IP:

wget http://169.254.169.254/latest/meta-data/public-ipv4 -qO -
wget http://ipinfo.io/ip -qO -
curl http://169.254.169.254/latest/meta-data/public-ipv4
curl http://ipinfo.io/ip

*Note: http://169.254.169.254/latest/meta-data/public-ipv4 works even in conditions in which external DNS servers are not accessible.

**Note: The only way to acquire a static IP address is to use the Jetstream API interface. See Using the Jetstream API for details.