###################################
Accessing Amazon Web Services (AWS)
###################################
To run the interactive activities for this JEDI Academy, each padawan will be granted the use of a dedicated virtual computer in the Amazon cloud. Specifically, we will launch an EC2 (Elastic Compute Cloud) instance through Amazon Web Services (`AWS `_) for each participant in the Academy. And, this is where you will be running JEDI. Throughout the documentation, we will refer to this as your AWS instance, or equivalently, your AWS node.
This document explains how to access your AWS node throughout the duration of the Academy. Feel free to return to it each day when is time to engage in each activity.
Some users may be tempted to run the activities on their own laptop or workstation or on an HPC platform if they have access to `JEDI Environment modules `_. However, we discourage this. The use of AWS instances and Singularity containers allows us to provide a uniform computing environment for all so that we can focus on learning the JEDI code without the distraction of platform-related debugging.
So, please use your AWS node to do all the academy activities. The only exception is Friday afternoon, when instructors (JEDI masters) will be available to provide guidance on how you can run JEDI on the platform of your choice.
So, to participate in the activities, you will need two things:
1. The ip address of your AWS node
2. A password to allow you to log into it
See the table below for the first item. The password will be provided during the first activity on Monday (:doc:`Getting Started `). **Write them down**: these will not change over the course of the Academy so you will need them every day.
.. note::
**Write down your password. Bookmark your Jupyter URL**.
Though you can access your AWS node directly through ``ssh`` if you wish, we have set up a web interface to each of the nodes by means of
`JupyterLab `_. We recommend that you use the web interface because this provides a number of attractive features, including the ability to navigate the directory tree, open new terminals, transfer files, and most importantly, to conveniently display graphics.
So, to access your AWS node, open a web browser and navigate to this URL:
.. code-block:: bash
http://:8080
Enter your password at the prompt. You should bookmark this link because, again, it will not change - it will be yours for the entire Academy.
Important: The AWS EC2 instances (and their associated JupyterLab URLs) will only be active in the afternoons during the week of the Academy. We will create the instances on Monday so the links below will not work before then. Then, each night of the Academy (Monday-Thursday), we will shut the instances down overnight as a cost-saving measure. However, all data will be saved so you can pick up the next day precisely where you left off. Then, after our last activity on Friday afternoon, we will permanently terminate all instances.
.. note::
**If you ever wish to leave your node up longer (for example, one evening to complete a particular activity), just make arrangements with a JEDI Master (Mark).**
Now, to log into your cloud computing instance, merely select the appropriate URL from the Table above and enter the password at the prompt.
You should now see the default JupyterLab interface, which includes a directory tree displayed as an interactive (i.e. clickable) menu on the left and a large display area. At the top of the display area you should see several tabs. One is labeled ``Console 1``. This is a Jupyter python console, capable of interpreting python commands. Another tab is labeled ``ubuntu`` with a local ip address. This is an ``ssh`` terminal, running bash. From here you have access to the linux command line. This is where we will be doing most of our work.
For more tips on how to work with the Jupyter interface, see :doc:`the first activity on Monday `.
If you are unable to link to the web interface, you can access the node directly through ssh, as mentioned above. To follow this method, you first need to acquire the ``academy-virginia.pem`` file from a JEDI master which contains an ssh key for authentication. Then you should use the ``-Y`` option to ssh to set up X forwarding as follows (remember that your username is ``ubuntu``):
.. code::
ssh -i academy-virginia.pem -Y ubuntu@
Then you can use the linux ``feh`` application to display image files over the internet (this application is available both inside and outside the Singularity container). Or, you can ``scp`` the files to your local machine (using the same ``pem`` file for authentication) and view them locally.
AWS node assignments
--------------------
================ ===================== ================
First Last ip address
================ ===================== ================
Peyman Abbaszadeh 174.129.67.51
Phil Andrews 18.204.144.71
Jerome Barre 18.208.92.249
Carlos Bastarz 18.235.43.18
Kirana Bergstrom 23.21.130.44
David Casson 3.208.120.87
Jing Cheng 3.208.171.74
Ian Culverwell 3.212.243.250
Srinivas Desamsetti 3.216.15.104
Thomas Duncan 3.221.205.101
Ardeshir Ebtehaj 3.221.254.198
Bjoern Fock 34.200.158.120
Yanjun Gan 34.202.52.4
Jidong Gao 34.224.76.129
Keyhan Gavahi 34.226.186.206
Gibies George 34.231.72.30
Joao Gerd Zell de Mattos 35.153.77.252
Ryan Gooch 35.168.218.167
Ganesh Gopal 35.168.226.197
Scott Gregory 44.193.148.148
Farhad Hassani 44.193.160.99
Francois Herbert 44.193.170.67
Ivette Hernandez Banos 44.193.185.72
Kylie Hoffman 44.193.187.165
Pawel Hordyniec 44.193.95.60
JUNJUN HU 44.195.238.26
Yongjie Huang 50.16.149.183
Min Huang 50.17.25.59
Todd Hutchinson 52.0.132.138
Hector Alejandro Inda Diaz 52.0.214.31
Rong Kong 52.2.246.204
Yoonjin Lee 52.20.176.130
mochi liao 52.200.16.119
Swapan Mallick 52.200.23.197
Nabir Mamnun 52.207.119.185
Panagiotis Mitsopoulos 52.207.126.55
Karwan Mohammed 52.21.103.245
Michael Murphy 52.44.167.119
Stephen Oxley 52.45.119.45
Tim Payne 52.45.92.19
Jayaram Pudashine 52.54.34.174
Indira Rani 52.72.9.107
Rick Rawlins 54.145.18.156
Jagdeep Sodhi 54.147.146.250
Jeff Steward 54.156.23.225
Melissa Wagner 54.158.75.61
Aman Waheed Khan 54.159.212.159
Chenghao Wang 54.162.162.60
Jifu Yin 54.162.57.5
Yonggang Yu 54.163.137.231
Su Kyong Yun 54.163.252.122
================ ===================== ================
Contact Mark Miesch (miesch@ucar.edu) or Maryam Abdi-Oskouei (maryamao@ucar.edu)
if you have any problems or questions.