diff --git a/docs/images/providers/jetstream/launch-instance-dialog.png b/docs/images/providers/jetstream/launch-instance-dialog.png index 45cd7958f..f983682db 100644 Binary files a/docs/images/providers/jetstream/launch-instance-dialog.png and b/docs/images/providers/jetstream/launch-instance-dialog.png differ diff --git a/docs/images/providers/jetstream/launch-instance-first-button.png b/docs/images/providers/jetstream/launch-instance-first-button.png index a46910691..85cc964e3 100644 Binary files a/docs/images/providers/jetstream/launch-instance-first-button.png and b/docs/images/providers/jetstream/launch-instance-first-button.png differ diff --git a/docs/images/providers/jetstream/select-image.png b/docs/images/providers/jetstream/select-image.png index f7e223c15..c87ff665e 100644 Binary files a/docs/images/providers/jetstream/select-image.png and b/docs/images/providers/jetstream/select-image.png differ diff --git a/docs/install/jetstream.md b/docs/install/jetstream.md index b068ca12b..8e8533f65 100644 --- a/docs/install/jetstream.md +++ b/docs/install/jetstream.md @@ -10,8 +10,8 @@ users and a user environment with packages you want installed running on ## Prerequisites -1. A Jetstream account with an XSEDE allocation; for more information, - see the [Jetstream Allocations help page](http://wiki.jetstream-cloud.org/Jetstream+Allocations). +1. A Jetstream account with an ACCESS allocation; for more information, + see the [Jetstream Allocations help page](https://docs.jetstream-cloud.org/alloc/overview/). ## Step 1: Installing The Littlest JupyterHub @@ -20,48 +20,37 @@ Let's create the server on which we can run JupyterHub. 1. Log in to [the Jetstream portal](https://use.jetstream-cloud.org/). You need an allocation to launch instances. -2. Select the **Launch New Instance** option to get going. +2. Select the **Create** option, and then **Instance** to get going. ```{image} ../images/providers/jetstream/launch-instance-first-button.png - :alt: Launch new instance button with description. + :alt: Create new instance button. ``` This takes you to a page with a list of base images you can choose for your server. -3. Under **Image Search**, search for **Ubuntu 22.04**, and select the - **Ubuntu 22.04 Devel and Docker** image. +3. Under **Choose an Instance Source**, select **Ubuntu 24.04 (latest)** image. ```{image} ../images/providers/jetstream/select-image.png - :alt: Select Ubuntu 22.04 x64 image from image list + :alt: Select Ubuntu 24.04 (latest) from image list ``` -4. Once selected, you will see more information about this image. Click the - **Launch** button on the top right. - - ```{image} ../images/providers/jetstream/launch-instance-second-button.png - :alt: Launch selected image with Launch button on top right - ``` - -5. A dialog titled **Launch an Instance / Basic Options** pops up, with various +4. A page titled **Create Instance** loads, with various options for configuring your instance. ```{image} ../images/providers/jetstream/launch-instance-dialog.png :alt: Launch an Instance / Basic Options dialog box ``` - 1. Give your server a descriptive **Instance Name**. + 1. Give your server a descriptive **Name**. - 2. Select an appropriate **Instance Size**. We suggest m1.medium or larger. - Make sure your instance has at least **1GB** of RAM. + 2. Select an appropriate **Flavor**. We suggest m3.medium or larger. + You can resize your instance later if you need. Check out our guide on How To [](/howto/admin/resource-estimation) to help pick how much Memory, CPU & disk space your server needs. - 3. If you have multiple allocations, make sure you are 'charging' this server - to the correct allocation. - -6. Click the **Advanced Options** link in the bottom left of the popup. This +5. Click the **Advanced Options** link in the bottom left of the popup. This lets us configure what the server should do when it starts up. We will use this to install The Littlest JupyterHub. @@ -71,14 +60,14 @@ Let's create the server on which we can run JupyterHub. :alt: Dialog box allowing you to add a new script. ``` -7. Click the **Create New Script** button. This will open up another dialog +6. Click the **Create New Script** button. This will open up another dialog box! ```{image} ../images/providers/jetstream/create-script-dialog.png :alt: Launch an Instance / Advanced Options dialog box ``` -8. Under **Input Type**, select **Raw Text**. This should make a text box titled +7. Under **Input Type**, select **Raw Text**. This should make a text box titled **Raw Text** visible on the right side of the dialog box. Copy the text below, and paste it into the **Raw Text** text box. Replace `` with the name of the first **admin user** for this @@ -97,24 +86,24 @@ Let's create the server on which we can run JupyterHub. [](/topic/customizing-installer) documents other options that can be passed to the installer. ::: -9. Under **Execution Strategy Type**, select **Run script on first boot**. +8. Under **Execution Strategy Type**, select **Run script on first boot**. -10. Under **Deployment Type**, select **Wait for script to complete**. +9. Under **Deployment Type**, select **Wait for script to complete**. -11. Click the **Save and Add Script** button on the bottom right. This should hide +10. Click the **Save and Add Script** button on the bottom right. This should hide the dialog box. -12. Click the **Continue to Launch** button on the bottom right. This should put you +11. Click the **Continue to Launch** button on the bottom right. This should put you back in the **Launch an Instance / Basic Options** dialog box again. -13. Click the **Launch Instance** button on the bottom right. This should turn it +12. Click the **Launch Instance** button on the bottom right. This should turn it into a spinner, and your server is getting created! ```{image} ../images/providers/jetstream/launching-spinner.png :alt: Launch button turns into a spinner ``` -14. You'll now be shown a dashboard with all your servers and their states. The +13. You'll now be shown a dashboard with all your servers and their states. The server you just launched will progress through various stages of set up, and you can see the progress here. @@ -122,22 +111,22 @@ Let's create the server on which we can run JupyterHub. :alt: Instances dashboard showing deployment in progress. ``` -15. It will take about ten minutes for your server to come up. The status will +14. It will take about ten minutes for your server to come up. The status will say **Active** and the progress bar will be a solid green. At this point, your JupyterHub is ready for use! -16. Copy the **IP Address** of your server, and try accessing it from a web +15. Copy the **IP Address** of your server, and try accessing it from a web browser. It should give you a JupyterHub login page. ```{image} ../images/first-login.png :alt: JupyterHub log-in page ``` -17. Login using the **admin user name** you used in step 8, and a password. Use a +16. Login using the **admin user name** you used in step 8, and a password. Use a strong password & note it down somewhere, since this will be the password for the admin user account from now on. -18. Congratulations, you have a running working JupyterHub! +17. Congratulations, you have a running working JupyterHub! ## Step 2: Adding more users