-
Notifications
You must be signed in to change notification settings - Fork 3
1. Set up AWS and install TLJH
-
First you'll need an AWS account. Record your username and the 12-digit account id. You'll use the 12 digit number in other places. All the set-up is easy, just follow all the instructions on this link.
The free tier for an E2C instance gets you 750 hours per month of t2.micro. Seems like it runs unless you shut down your instance. From the AWS console, you can go to billing (upper right under your username) and scroll down to see how many hours you have used.
I followed these instructions to install The Littlest Jupyter Hub on AWS. There were a few steps but it was all easy to follow. http://tljh.jupyter.org/en/latest/install/amazon.html You can set up with the free tier and use a t2.micro instance but make sure to max out the storage (30G free tier). The packages from the NASA workshop take up 8Gig.
Now you'll have your EC2 instance. Note t2.micro is too small and I keep crashing the instance (and have to reboot) because it is so small. But I have not gotten the non-free instances to successfully install TLJH. TLJH is installed but the servers won't spawn on the t2.small or bigger (or anything else not free). Instead I was able to install TLJH on t2.micro and after it installed I upgraded to t2.small.
How to reboot the instance when it hangs. Go to the AWS dashboard and go to your EC2 instances. The click on your instances check box and look for the dropdown menu for instance state. You'll find a reboot button there. It'll take about 10 min before you can get back into your JupyterHub.
Once you have things set-up, you can login to AWS and see the instances that you have running. The instances are set up on EC2 (virtual servers). I set my instances up on us-west-2. You will see the EC2 service listed on your AWS dashboard, but if you don't, you can get to it from here: https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2
Key thing that I have had to use is rebooting my instance. I KEEP crashing it and having to reboot, constantly. Then it takes 10-15 min for the JupyterHub to come back online.
I haven't used this yet
After set-up, you can sign into your AWS account here. You'll want to go to the EC2 services to get your instances. https://signin.aws.amazon.com/signin
AWS says you shouldn't use your root account for normal admin. You should set up an IAM user. https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console Follow instructions above. It is fairly self-explanatory. I set my IAM account for Admin Access. Sign in to the AWS Management Console and open the IAM console at https://console.aws.amazon.com/iam/ I haven't actually tried using my IAM account yet. It keeps complaining so I have to go back and log in as root.
You can access the AWS console with https://<12-digit-account-id>.signin.aws.amazon.com/console
After installing TLJH, you'll have to wait a bit (like 10-15 min) for everything to get installed. Look at your instance (dashboard above) and copy the public IP address. Your JupyterHub address will be
<public ip>/hub/login
When you login the first time, you'll log in with the admin account that you set up when you installed TLJH.
The default UI is classic Jupyter Notebook. You'll see that in the URL when you are logged in:
<public ip>/<username>/tree
If you change it to
<public ip>/<username>/lab
You'll get the JupyterLab UI.