# Booting a Jetstream Computer Instance for your use! What we're going to do here is walk through starting up an running computer (an "instance") on the Jetstream service. Below, we've provided screenshots of the whole process. You can click on them to zoom in a bit. The important areas to fill in are circled in red. You should all have your own XSEDE accounts, so you'll want to log in with that. For this workshop, we will use the "Ubuntu 16.04" operating system "image," but this may change in the future if you continue to use jetstream. ----- First, go to the Jetstream application at [https://use.jetstream-cloud.org/application](https://use.jetstream-cloud.org/application). Now: ## Request to log in to the Jetstream Portal Click the login link in the upper right. [![login](images/login-1.thumb.png)](../_images/login-1.png) ## Use "XSEDE" Choose "XSEDE" as your account provider (it should be the default) and click on "Continue". [![foo](images/login-2.thumb.png)](../_images/login-2.png) ## Fill in your username and password and click "Sign in" Fill in your username and password. [![foo](images/login-3.thumb.png)](../_images/login-3.png) ## Select Projects and "Create New Project" We'll organize your workspace by creating a Project. Click on "Projects" up along the top. [![foo](images/login-5.thumb.png)](../_images/login-5.png) ## Name the project and click "create" [![foo](images/login-6.thumb.png)](../_images/login-6.png) ## Select the newly created project Click on your new project! [![foo](images/login-7.thumb.png)](../_images/login-7.png) ## Within the project, select "new" Now, select 'New' and then "Instance" from the dropdown menu to start up a new machine. [![foo](images/login-8.thumb.png)](../_images/login-8.png) ## Find the "Ubuntu 16.04" image, click on it Enter "Ubuntu 16.04" into the search bar - make sure it's from June 21st, 2017. [![foo](images/login-9.thumb.png)](../_images/login-9.png) ## Name it something simple and select 'm1.medium' Name your instance after what we're doing (e.g. "RNAseq tutorial") or anything that will be informative for you -- it doesn't matter -- and select 'm1.medium'. [![foo](images/login-10.thumb.png)](../_images/login-10.png) ## Wait for it to become active It will now be booting up! This will take 2-10 minutes, depending. Just wait! Don't reload or anything. [![foo](images/login-11.thumb.png)](../_images/login-11.png) ## Click on your new instance to get more information! Now, you can either click "Open Web Shell" If you know how to use ssh, you can ssh in as your username on the IP address of the machine, but only if you add ssh keys or set a password on this machine. [![foo](images/login-12.thumb.png)](../_images/login-12.png) ## Miscellany There's a possibility that you'll be confronted with this when you log in to jetstream: [![foo](images/possible_instance_problem.thumb.png)](../_images/possible_instance_problem.png) A refresh of the page should get you past it. Please try not to actually move any instances to a new project; it's probably someone else's and it could confuse them :) ## Suspend your instance You can save your workspace so you can return to your instance at a later time without losing any of your files or information stored in memory, similiar to putting your physical computer to sleep. At the Instance Details screen, select the "Suspend" button. [![foo](images/suspend-1.png)](../_images/suspend-1.png) This will open up a dialogue window. Select the "Yes, suspend this instance" button. [![foo](images/suspend-2.png)](../_images/suspend-2.png) It may take Jetstream a few minutes to process, so wait until the progress bar says "Suspended." ### Resuming your instance To *wake-up* your instance, select the "Resume" button. [![foo](images/resume-1.png)](../_images/resume-1.png) This will open up a dialogue window. Select the "Yes, resume this instance" button. [![foo](images/resume-2.png)](../_images/resume-2.png) It may take Jetstream a few minutes to process, so wait until the progress bar says "Active." [![foo](images/resume-3.png)](../_images/resume-3.png) ## Shutting down your instance You can shut down your workspace so you can return to your instance another day without losing any of your files, similiar to shutting down your physical computer. You will retain your files, but you will lose any information stored in memory, such as your history on the command line. At the Instance Details screen, select the "Stop" button. [![foo](images/stop-1.png)](../_images/stop-1.png) This will open up a dialogue window. Select the "Yes, stop this instance" button. [![foo](images/stop-2.png)](../_images/stop-2.png) It may take Jetstream a few minutes to process, so wait until the progress bar says "Shutoff." [![foo](images/stop-3.png)](../_images/stop-3.png) [![foo](images/stop-4.png)](../_images/stop-4.png) ### Restarting your instance To start your instance again, select the "Start" button. [![foo](images/start-1.png)](../_images/start-1.png) This will open up a dialogue window. Select the "Yes, start this instance" button. [![foo](images/start-2.png)](../_images/start-2.png) It may take Jetstream a few minutes to process, so wait until the progress bar says "Active." [![foo](images/start-3.png)](../_images/start-3.png) ## Deleting your instance To completely remove your instance, you can select the "delete" buttom from the instance details page. [![foo](images/delete-1.png)](../_images/delete-1.png) This will open up a dialogue window. Select the "Yes, delete this instance" button. [![foo](images/delete-2.png)](../_images/delete-2.png) It may take Jetstream a few minutes to process your request. The instance should disappear from the project when it has been successfully deleted. [![foo](images/delete-3.png)](../_images/delete-3.png) [![foo](images/delete-4.png)](../_images/delete-4.png)