From e8b1a6d28675406ca99471ddd39fd01dea035473 Mon Sep 17 00:00:00 2001
From: Eesaan Atluri <atlurie@uab.edu>
Date: Fri, 31 Aug 2018 15:13:35 -0500
Subject: [PATCH] Update jupyter_install.md
---
jupyter_install.md | 28 ++++++++++++++++++++++------
1 file changed, 22 insertions(+), 6 deletions(-)
diff --git a/jupyter_install.md b/jupyter_install.md
index 55d38bf..2e30bd2 100644
--- a/jupyter_install.md
+++ b/jupyter_install.md
@@ -23,6 +23,8 @@ The Jupyter app requires the following software to be installed on the compute n
`$ mkdir -p "${HOME}/ondemand/dev"`
+Then reload OnDemand dashboard to see the Develop dropdown appear.
+
>Open OnDemand looks for apps in *special* directories on the file system.
Two types of apps in particular are _system_ apps and _sandbox_ apps.
@@ -68,7 +70,7 @@ The Jupyter app requires the following software to be installed on the compute n
Notice that we are using the **system** :ref:`dashboard` to launch the
**sandbox** Interactive App (Dashboard plugin).
-- After creating the sandbox directory navigate in your browser to: https://ondemand.my_center.edu/
+- After creating the sandbox directory navigate in your browser to: localhost:your_port/
You should now see a *Develop* dropdown menu option in the top right of the
@@ -109,20 +111,34 @@ The form.yml file (User Form) located in the root of the app is for defining the
- We will begin by adding a cluster for the Jupyter app to use. You do this by editing the form.yml file.
- `vim /var/www/ood/apps/sys/jupyter/form.yml`
+ `vim $HOME/ondemand/dev/jupyter/form.yml`
replace `my_cluster` with a valid cluster that corresponds to a cluster configuration file located under `/etc/ood/config/clusters.d/my_cluster.yml`.
- We will also edit the module(s) that is(are) required to be loaded within our batch job to get a Jupyter Notebook Server running:
- `vim /var/www/ood/apps/sys/jupyter/form.yml`
+ `vim ${HOME}/ondemand/dev/jupyter/form.yml`
Add `jupyterhub` to the modules section in addition to `python`.
-- Click on `Interactive Apps` dropdown in the dashboard.
- - click on `Jupyter Notebook` listed under servers tab
+- Click on `Develop` dropdown in the dashboard.
+ - click on `Mysandbox apps`.
+- Click on `Launch` once the detailed view appears.
+
+### 4. Deploying the app
+
+After you have decide to deploy move your app production system.
+
+- Go to your OnDemand sandbox directory:
+
+ `$ cd ~/ondemand/dev`
+
+- Copy the app to the system deployment location as root:
+
+ `$ sudo cp -r jupyter /var/www/ood/apps/sys/`
+
+- In your browser navigate to the OnDemand URL and confirm you see the new app in the Interactive Apps dropdown on the Dashboard App:
-- You should see a web form for the Jupyter app. Fill in the form now and try to Launch a Jupyter batch job.
--
GitLab