# Using Jetstream Virtual Machines

## If you need to know how to login to Jetstream through the Atmosphere Graphical User Interface, please see the preceding section: [Accessing Atmosphere on Jetstream](https://doane-ccla.gitbook.io/docs/xsede-resources/accessing-atmosphere-on-jetstream)

1. First we will need to log in to <https://use.jetstream-cloud.org> and navigate to the "Images" page.\
   ![View of the Jetstream Virtual Machine Images page](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26PsPP2s_KqolmEy%2Fjetstream-vm-images-page.png?generation=1568150420903093\&alt=media)
2. For this example, we will search for an image with Anaconda 3 installed. Type "anaconda" into the search bar as shown below. Jetstream has a "live" search bar so it will start filtering the VM images as soon as you start typing.\
   ![Searching for a VM with the word anaconda](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26PuTvJRa67oMoRH%2Fvm-search-anaconda.png?generation=1568150421787315\&alt=media)
3. If we scroll down the page we will see an image titled "Doane CST210 Ubuntu". This VM image looks like it has everything we need.\
   ![Scrolling down to find the Doane CST210 Ubuntu VM Image](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Pw4MdY8JXHfqDM%2Ffinding-doane-cst210-vm.png?generation=1568150420941996\&alt=media)
4. While we are here, I am going to favorite this VM image by clicking the star in the upper right corner of the VM's panel as shown below. The star should now be filled in with a color.\
   ![Clicking the star to favorite this VM image](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26PyBNaELsi_4tn1%2Ffavorite-the-doane-vm.png?generation=1568150421807027\&alt=media)
5. Now, we will scroll to the top of the page and click on the "FAVORITES" button in the VM Images Navigation Menu. This way we can have fewer VM images filling up our screen.\
   ![Click on the FAVORITES VM navigation menu button](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Q-1klMSiu-xcfp%2Fnavigate-to-vm-favorites.png?generation=1568150423739023\&alt=media)
6. Once there, we will now click on the "Doane CST210 Ubuntu" VM image panel. Clicking anywhere in the white area of the panel will work.\
   ![Click on the white area of the Doane VM image panel](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Q1xyGvNM5DZImP%2Fnav-to-fav-doane-vm.png?generation=1568150422771950\&alt=media)
7. This new page provides detailed information about the selected VM image. This includes previous versions of the VM image and what was changed in each version.\
   ![Details of the Doane CST210 Ubuntu VM image](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Q3A0XXcyRxGOMa%2Fdoane-vm-details.png?generation=1568150421843009\&alt=media)
8. If you are happy with the information provided and think this VM will work for your needs, we will need to create a project to actually store and run the VMs related to our project. In the top (main) navigation menu, click on the "Projects" button.\
   ![Click on the top navigation menu Projects button](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Q5hdM2K8RGdMYf%2Fnav-to-projects.png?generation=1568150420801050\&alt=media)
9. Once on the projects page, click on the "CREATE NEW PROJECT" button as shown below.\
   ![Click on the CREATE NEW PROJECT button](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Q7MHTe4I6blgBl%2Fcreate-new-project-1.png?generation=1568150420801130\&alt=media)
10. Now enter a name and description for your new project. Click the "CREATE" button when you are finished.\
    ![Fill out the information and click CREATE](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26Q98FZvgjsA1PZn%2Fcreate-new-project-2.png?generation=1568150422919480\&alt=media)
11. Now we have successfully created a new project.\
    ![View of our new project](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QBP_AQtrYuhzyH%2Fcreate-new-project-3.png?generation=1568150421797193\&alt=media)
12. Click on the Project panel to open up the detail page for the project.\
    ![View of the details page for our new project](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QDrZVC6YWOXMxU%2Fnew-instance-1.png?generation=1568150421886599\&alt=media)
13. From here we will want to click the pink "NEW" button which will open a drop down menu. In the drop down menu select "Instance" to begin the process of making a Virtual Machine.\
    ![Click the NEW button and select Instance from the drop down menu](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QFqol-J7bMfArz%2Fnew-instance-2.png?generation=1568150422639298\&alt=media)
14. Once the new popup page opens, click on the "Show Favorites" tab to bring up our favorited VM images.\
    ![Click the Show Favorites in the new Instance popup page](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QHzoCjOzDMZsj-%2Fnew-instance-3.png?generation=1568150422615944\&alt=media)
15. Select you desired VM Image you want to use for your new Virtual Machine. After doing that, you will be brought to the next step in the Instance Wizard. Here you can specify the information for the VM. These options include the Instance Name, version of the Base Image to use, the Project that the VM she be housed in, which allocation account that Jetstream should charge for the VM, and the physical Size for the VM. Jetstream also provides a graphical representation of how much of the allocation resources this instance will use given the selected configuration.\
    ![Customization options for the new VM instance](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QJPKlgUi7weq4e%2Fnew-instance-4.png?generation=1568150424568220\&alt=media)
16. We will cover the advanced options in another tutorial. For now, when you are happy with your configuration options, click the "LAUNCH INSTANCE" button. This and the next few steps to launch the VM will take around 25 minutes to complete.\
    ![Click the LAUNCH INSTANCE button to start the new VM](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QLUEFeSRtoFvTF%2Fnew-instance-5.png?generation=1568150422791563\&alt=media)
17. Once it is done loading, the VM will be added to the queue to be built and will have a Activity status of "Scheduling".\
    ![View of the deployment status for our new VM instance.](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QNdcyNF2vo6PWD%2Fnew-instance-6.png?generation=1568150424667315\&alt=media)
18. Once the VM is successfully built, it will move to the Activity status of "Initalizing".\
    ![Updated view of the deployment status for our new VM instance](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoS25U74oy2NHmdiW-h%2F-LoS26QPVITTGb8MFohg%2Fnew-instance-7.png?generation=1568150423748796\&alt=media)
19. When the VM is done being built, scheduled, and deployed, the status will turn from a yellow dot, to a green dot. A note of warning, now that the VM is active, it WILL be charging the allocation account. Please make sure to shelve or suspend your instance once you are done with it to quit being charged for the resources.\
    ![Fully deployed VM image ready for use.](https://github.com/Doane-CCLA/docs/tree/5b09b392520b69087236e5ea7fb074da9cd62220/using-xsede-resources/screenshots/new-instance8.png)
20. You may have noticed that the name of your new VM instance shows up as a link. Go ahead and click on that link as highlighted in the below image.\
    ![Clicking the VM name link](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoX3LZZ_Oxo5Bydkxit%2F-LoX3MYZJQXBNPpGl5_n%2Fusing-vm-1.png?generation=1568234635519699\&alt=media)
21. On this new page, we can see all of the useful information about our VM on the left side. The menu on the right side of the page shows us some useful options for interacting with the VM. The most important options in the right side menu are "Suspend" and "Open Web Desktop".\
    ![View of VM details page](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoX3LZZ_Oxo5Bydkxit%2F-LoX3MYamqIPxNeBHgl0%2Fusing-vm-2.png?generation=1568234635327410\&alt=media)
22. Now that we have gone through all of the trouble to build and initalize our VM instance, let's go ahead and connect to the VM and use it. Click on the "Open Web Desktop" button in the right side menu as shown below.\
    ![Clicking the Open Web Desktop button](https://2886590239-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFxD7uKIleUe-0ofZgF%2F-LoX3LZZ_Oxo5Bydkxit%2F-LoX3MYca5l2YRWbsSNY%2Fusing-vm-3.png?generation=1568234635454539\&alt=media)
