Demo CryoCloud

Demo CryoCloud#

Tutorial Lead: Tasha Snow (ESSIC, NASA GSFC)

Summary#

CryoCloud (soon to be StratusGeo) is a cloud-computing community and JupyterHub meant to help streamline and accelerate your geoscience workflows as data volumes are ever expanding. This tutorial will show you how to use CryoCloud for the hackweek and your research afterwards.

Learning Objectives

  • Learn how to access and use CryoCloud

  • Open CryoCloud and clone the one of the Hackweek websites

Access the CryoCloud powerpoint whenever you need to reference it#

Open the powerpoint by directly clicking on the hyperlink above or to open it in the CryoCloud Linux Desktop web browser as follows:

  • Copy this hyperlink: https://bit.ly/4fO1QiG

  • Click on the plus (+) sign in the File Browser to the left to open a Launcher window

  • Under Notebooks, click on Desktop to access the Linux Desktop. This will open a new tab.

  • Click on the Web Browser tool (globe) at the bottom of the screen

  • Paste the url into the search bar

Alt text

Open CryoCloud#

  1. Scroll through the server sizes. Stick with the 2 Gb server (the default).

Tip

The amount of memory (RAM) you select, you are guaranteed, but if you use more you risk crashing your server. If you crash the server, it just requires re-running your code from the start (or perhaps restarting your kernel).

Most users require only 2 Gb of memory, like while we develop code, so consider using 2 Gb for most of your work and then switching over to a larger computer when you want to start running things.

Check your memory usage at the bottom in the middle of the screen.

  1. Scroll through the languages. Choose the Python programming language.

  2. Sit back and learn about each of the tools!

    • JupyterHub options and viewing setup

    • Github

    • Virtual Linux desktop

    • SyncThing

    • Viewing and editing of different files

Now after the demo…

Task: Clone the Hackweek JupyterBook of your choosing#

To do this:

  1. Select the plus (+) sign above the File Browser to the left, which will bring up a Launcher window.

  2. Click the terminal button under Other to open it. This is your command line like you would have on any computer.

Before cloning the repo, you have the option to switch to another file folder using the change directory terminal command: cd folder if you do not want the Hackweek repo in your current directory (you can check which directory you are currently in using print working directory command: pwd).

cd yourfoldername

  1. Now clone the hackweek code into your current directory:

git clone https://github.com/snowex-hackweek/website-2024.git
git clone https://github.com/ICESAT-2HackWeek/website-2024.git
git clone https://github.com/geo-smart/website-2024.git

  1. You will see the folder pop into your File Browser on the left if you have the current directory open. Click on the folder to navigate through the files.

  2. To open this tutorial, click on the book subdirectory > tutorials and double click on CryoCloud_demo. This should open up this tutorial in case you want to review it in the future.

Shutting down your JupyterHub#

TIP

Best Practice: Shut down the CryoCloud server when you are done to save us money.

If you only close your tab or click log out, your server will continue running for 90 minutes.

Whenever you are done, it is best to shut down your server when you sign out to save on money for CryoCloud. Time on the JupyterHub costs money and there are systems in place to make sure your server doesn’t run indefinitely if you forget about it. After 90 minutes of no use, it will shut down. We prefer you shut down the server when so we save that 90 minutes of computing cost. To do so:

  • In upper left, click on File > Hub Control Panel, which will open another tab

  • Click the Stop Server button. Once this button disappears after you clicked it, your server is off.

  • Click Log Out in the top right of your screen and you will be logged out, or you can start a new server

  • You can now close this tab and the other tab where you were just working

Alt text

Finishing up#

🎉 Congratulations! You’ve completed this tutorial and have seen how we can access and use CryoCloud.

References#

To learn more about CryoCloud, find code for NASA data access, and find other research tutorials check out this other documentation:

Contents