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.
Some of the details may vary – for example, if you have your own XSEDE account, you may want to log in with that – and the name of the operating system or “image” may also vary from “Ubuntu 16.04” depending on the workshop.
First, go to the Jetstream application at https://use.jetstream-cloud.org/application.
Now:
Choose “XSEDE” as your account provider (it should be the default) and click on “Continue”.
Fill in the username, which is ‘tx160085’ for the ANGUS workshop, and then enter the password (which we will tell you in class).
Now, this is something you only need to once if you have your own account - but if you’re using a shared account like tx160085, you will need a way to keep your computers separate from everyone else’s.
We’ll do this with Projects, which give you a bit of a workspace in which to keep things that belong to “you”.
Click on “Projects” up along the top.
Enter your name into the Project Name, and something simple like “ANGUS” into the description. Then click ‘create’.
Now, select ‘New’ and then “Instance” from the dropdown menu to start up a new machine.
Enter “Ubuntu 16.04” into the search bar - make sure it’s from June 21st, 2017.
Change the name after what we’re doing - “workshop tutorial”, for example, but it doesn’t matter – and select ‘m1.medium’.
It will now be booting up! This will take 2-10 minutes, depending. Just wait! Don’t reload or anything.
Now, you can either click “Open Web Shell”, or, if you know how to use secure shell (ssh), you can ssh in as user ‘tx160085’ on the IP address of the machine - see circled information below. Click Here to access the tutorial for setting up a ssh connection from your local computer to your Jetstream instance.
There’s a possibility that you’ll be confronted with this when you log in to jetstream:
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 :)
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.
This will open up a dialogue window. Select the “Yes, suspend this instance” button.
It may take Jetstream a few minutes to process, so wait until the progress bar says “Suspended.”
To wake-up your instance, select the “Resume” button.
This will open up a dialogue window. Select the “Yes, resume this instance” button.
It may take Jetstream a few minutes to process, so wait until the progress bar says “Active.”
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.
This will open up a dialogue window. Select the “Yes, stop this instance” button.
It may take Jetstream a few minutes to process, so wait until the progress bar says “Shutoff.”
To start your instance again, select the “Start” button.
This will open up a dialogue window. Select the “Yes, start this instance” button.
It may take Jetstream a few minutes to process, so wait until the progress bar says “Active.”
To completely remove your instance, you can select the “delete” buttom from the instance details page.
This will open up a dialogue window. Select the “Yes, delete this instance” button.
It may take Jetstream a few minutes to process your request. The instance should disappear from the project when it has been successfully deleted.