README.md

-# Batch Connect - Example Jupyter Notebook Server
+# Batch Connect - JupyterLab
 
 ![GitHub Release](https://img.shields.io/github/release/osc/bc_example_jupyter.svg)
 ![GitHub License](https://img.shields.io/github/license/osc/bc_example_jupyter.svg)
 
-An example Batch Connect app that launches a Jupyter Notebook server within a
+An example Batch Connect app that launches a JupyterLab within a
 batch job.
 
 ## Prerequisites
@@ -12,9 +12,9 @@ This Batch Connect app requires the following software be installed on the
 **compute nodes** that the batch job is intended to run on (**NOT** the
 OnDemand node):
 
-- [Jupyter Notebook](http://jupyter.readthedocs.io/en/latest/) 4.2.3+ (earlier
+- [JupyterLab](http://jupyterlab.readthedocs.io/en/latest/) 3.2.1 (earlier
   versions are untested but may work for you)
-- [OpenSSL](https://www.openssl.org/) 1.0.1+ (used to hash the Jupyter Notebook
+- [OpenSSL](https://www.openssl.org/) 1.0.1+ (used to hash the JupyterLab
   server password)
 
 **Optional** software:
@@ -22,7 +22,7 @@ OnDemand node):
 - [Lmod](https://www.tacc.utexas.edu/research-development/tacc-projects/lmod)
   6.0.1+ or any other `module purge` and `module load <modules>` based CLI
   used to load appropriate environments within the batch job before launching
-  the Jupyter Notebook server.
+  the JupyterLab.
 
 ## Install
 
@@ -34,16 +34,16 @@ this.
 
 ```sh
 # Download the zip from the GitHub page
-wget https://github.com/OSC/bc_example_jupyter/archive/master.tar.gz
+wget https://github.com/uabrc/ood_jupyterlab/archive/master.tar.gz
 
 # Create a catchy directory
-mkdir my_jupyter_app
+mkdir my_jupyterlab_app
 
 # Unzip the downloaded file into this directory
-tar xzvf master.tar.gz -C my_jupyter_app --strip-components=1
+tar xzvf master.tar.gz -C my_jupyterlab_app --strip-components=1
 
 # Change the working directory to this new directory
-cd my_jupyter_app
+cd my_jupyterlab_app
 ```
 
 From here you will make any modifications to the code that you would like and

form.js

+const table = {
+  "interactive": { "max_cpu": 48, "max_hour": 2, "max_gpu": 0 },
+  "express": { "max_cpu": 48, "max_hour": 2, "max_gpu": 0 },
+  "short": { "max_cpu": 48, "max_hour": 12, "max_gpu": 0 },
+  "pascalnodes": { "max_cpu": 28, "max_hour": 12, "max_gpu": 4 },
+  "pascalnodes-medium": { "max_cpu": 28, "max_hour": 48, "max_gpu": 4 },
+  "medium": { "max_cpu": 48, "max_hour": 50, "max_gpu": 0 },
+  "long": { "max_cpu": 48, "max_hour": 150, "max_gpu": 0 },
+  "intel-dcb": { "max_cpu": 24, "max_hour": 150, "max_gpu": 0 },
+  "amd-hdr100": { "max_cpu": 128, "max_hour": 150, "max_gpu": 0 },
+  "largemem": { "max_cpu": 24, "max_hour": 50, "max_gpu": 0 },
+  "largemem-long": { "max_cpu": 24, "max_hour": 150, "max_gpu": 0 },
+  "amperenodes": { "max_cpu": 128, "max_hour": 12, "max_gpu": 2 },
+  "amperenodes-medium": { "max_cpu": 128, "max_hour": 48, "max_gpu": 2 },
+}
+
+const gpu_part_regex = /pascal|ampere/;
+
+function set_max_value(form_id, value) {
+  const form_element = $(form_id);
+  form_element.attr({'max': value});
+  if (form_element.val() > value)
+    form_element.val(value)
+}
+
+function set_partition_change_handler() {
+  let partition_select = $("#batch_connect_session_context_bc_partition");
+  partition_select.change( function(e) {
+    toggle_gpu_visibility(e);
+  });
+}
+
+function toggle_gpu_visibility(event) {
+  const partition = event.target.value;
+  const cpu_selector = '#batch_connect_session_context_bc_num_slots';
+  const gpu_selector = '#batch_connect_session_context_bc_num_gpus';
+  const hour_selector = '#batch_connect_session_context_bc_num_hours';
+
+  toggle_visibilty_of_form_group(gpu_selector, gpu_part_regex.test(partition));
+  set_max_value(cpu_selector, table[partition]["max_cpu"]);
+  set_max_value(gpu_selector, table[partition]["max_gpu"]);
+  set_max_value(hour_selector, table[partition]["max_hour"]);
+}
+
+function toggle_visibilty_of_form_group(form_id, show) {
+  let form_element = $(form_id);
+  let parent = form_element;
+
+  while (
+    (! parent[0].classList.contains('form-group')) &&
+    (! parent.is('html')) // ensure that we don't loop infinitely
+  ) {
+    parent = parent.parent();
+  }
+
+  // If parent is HTML then something has gone wrong and visibility should not be changed
+  if ( parent.is('html') ) {
+    return;
+  }
+
+  if(show) {
+    parent.show();
+  } else {
+    parent.hide();
+  }
+}
+
+toggle_gpu_visibility(
+  // Fake the event
+  { target: document.querySelector('#batch_connect_session_context_bc_partition') }
+);
+set_partition_change_handler();

form.yml → form.yml.erb

+<%-
+  partitions = OodAppkit.clusters[:SLURM_CLUSTER].custom_config[:partitions]
+-%>
 # Batch Connect app configuration file
 #
 # @note Used to define the submitted cluster, title, description, and
@@ -8,15 +11,15 @@
 # under /etc/ood/config/clusters.d/*.yml
 # @example Use the Owens cluster at Ohio Supercomputer Center
 #     cluster: "owens"
-cluster: "SLURM_CLUSTER" 
+cluster: "SLURM_CLUSTER"
 
 # Title of the app displayed in the Dashboard
-title: "Jupyter Notebook"
+title: "JupyterLab"
 
 # Description of the app displayed in the Dashboard (can use multi-line string
 # and Markdown syntax)
 description: |
-  This app will launch a Jupyter Notebook server on one or more cores.
+  This app will launch a JupyterLab server on one or more cores.
 
 # Define attribute values that aren't meant to be modified by the user within
 # the Dashboard form
@@ -44,7 +47,7 @@ attributes:
       # format:
       # module load example_module/VERSION example_module2
 
-  # Whether Conda extensions will be available within the Jupyter notebook
+  # Whether Conda extensions will be available within the JupyterLab
   # server
   #
   # @note Allows the user to use conda environment-based kernels from their
@@ -56,16 +59,17 @@ attributes:
   # @see https://docs.continuum.io/anaconda/user-guide/tasks/use-jupyter-notebook-extensions
   conda_extensions: "1"
 
-  # Any extra command line arguments to feed to the `jupyter notebook ...`
-  # command that launches the Jupyter notebook within the batch job
+  # Any extra command line arguments to feed to the `jupyter-lab ...`
+  # command that launches the JupyterLab within the batch job
   extra_jupyter_args:
     widget: text_field
-    label: Extra jupyter arguments
+    label: Extra JupyterLab arguments
 
   bc_num_hours:
     value: 1
 
   bc_num_slots:
+    widget: "number_field"
     label: Number of CPU
     value: 1
     min: 1
@@ -80,20 +84,21 @@ attributes:
     max: 128
     step: 1
 
+  bc_num_gpus:
+    widget: "number_field"
+    label: Number of GPUs
+    value: 1
+    min: 0
+    max: 4
+    step: 1
+
   bc_partition:
     widget: select
     label: Partition
     options:
-      - [ "express", "express" ]
-      - [ "short", "short" ]
-      - [ "medium", "medium" ]
-      - [ "long", "long" ]
-      - [ "interactive", "interactive" ]
-      - [ "pascalnodes", "pascalnodes" ]
-      - [ "pascalnodes-medium", "pascalnodes-medium" ]
-      - [ "largemem", "largemem" ]
-      - [ "largemem-long", "largemem-long" ]
-      - [ "amd-hdr100", "amd-hdr100" ]
+    <%- partitions.each do |p| -%>
+      - [ "<%= p %>", "<%= p %>" ]
+    <%- end -%>
 
 # All of the attributes that make up the Dashboard form (in respective order),
 # and made available to the submit configuration file and the template ERB
@@ -110,6 +115,7 @@ form:
   - extra_jupyter_args
   - bc_num_hours
   - bc_partition
+  - bc_num_gpus
   - bc_num_slots
   - bc_num_mems
   - bc_email_on_started

manifest.yml

 ---
-name: Jupyter Notebook
+name: JupyterLab
 category: Interactive Apps
 subcategory: Servers
 role: batch_connect
 description: |
-  This app will launch a Jupyter Notebook server on one or more nodes.
+  This app will launch a JupyterLab server on one or more nodes.

script.sh.erb

-#!/bin/bash -l
-
-# Set working directory to home directory
-cd "${HOME}"
-module reset
-#
-# Start Jupyter Notebook Server
-#
-module load Anaconda3
-<%= context.custom_environment %>
-unset XDG_RUNTIME_DIR
-# Launch the Jupyter Notebook Server
-jupyter notebook --config="${CONFIG_FILE}" <%= context.extra_jupyter_args %>

submit.yml.erb

 # Job submission configuration file
 #
+<%-
+  email = ENV['USER']
+  if !email.include? '@'
+    email = email + '@uab.edu'
+  end
+-%>
 ---
 # This config comes from below URL
 # https://github.com/OSC/bc_example_jupyter/blob/custom_environment/submit.yml.erb
-# The -C option in the config provided for slurm has been removed because it does 
-# not apply to implementation at UAB. We do not use constraint list to be used with -C. 
+# The -C option in the config provided for slurm has been removed because it does
+# not apply to implementation at UAB. We do not use constraint list to be used with -C.
 
 batch_connect:
   template: "basic"
 
 script:
+  job_environment:
+    USER: "<%= ENV['USER'] %>"
   native:
     - "-N 1"
     - "-n <%= bc_num_slots.blank? ? 1 : bc_num_slots.to_i %>"
     - "--mem-per-cpu=<%= bc_num_mems.blank? ? 4 : bc_num_mems.to_i %>G"
     - "--partition=<%= bc_partition %>"
     - "--time=<%= bc_num_hours.blank? ? 1 : bc_num_hours.to_i %>:00:00"
-    - "--job-name=ood-jupyter"
-<%- if bc_partition.include? "pascalnodes" -%>
-    - "--gres=gpu:1"
+    - "--job-name=ood-jupyterlab"
+<%- if bc_partition.include? "pascalnodes" or bc_partition.include? "amperenodes" -%>
+    - "--gres=gpu:<%= bc_num_gpus.blank? ? 1 : bc_num_gpus.to_i %>"
+<%- end -%>
+<%- if bc_email_on_started == "1" -%>
+    - "--mail-type=BEGIN"
+    - "--mail-user=<%= email %>"
 <%- end -%>

template/after.sh

-# Wait for the Jupyter Notebook server to start
-echo "Waiting for Jupyter Notebook server to open port ${port}..."
+# Wait for the Jupyterlab server to start
+echo "Waiting for Jupyterlab server to open port ${port}..."
 echo "TIMING - Starting wait at: $(date)"
-if wait_until_port_used "${host}:${port}" 60; then
-  echo "Discovered Jupyter Notebook server listening on port ${port}!"
+if wait_until_port_used "${host}:${port}" 600; then
+  echo "Discovered Jupyterlab server listening on port ${port}!"
   echo "TIMING - Wait ended at: $(date)"
 else
-  echo "Timed out waiting for Jupyter Notebook server to open port ${port}!"
+  echo "Timed out waiting for Jupyterlab server to open port ${port}!"
   echo "TIMING - Wait ended at: $(date)"
   pkill -P ${SCRIPT_PID}
   clean_up 1

template/script.sh.erb

-#!/usr/bin/env bash
-
-# Benchmark info
-echo "TIMING - Starting main script at: $(date)"
+#!/bin/bash -l
 
 # Set working directory to home directory
 cd "${HOME}"
-
+module reset
 #
-# Start Jupyter Notebook Server
+# Start JupyterLab Server
 #
-
-<%- unless context.modules.blank? -%>
-# Purge the module environment to avoid conflicts
-module purge
-
-# Load the require modules
-module load <%= context.modules %>
-
-# List loaded modules
-module list
-<%- end -%>
-
-# Benchmark info
-echo "TIMING - Starting jupyter at: $(date)"
-
-# Launch the Jupyter Notebook Server
-set -x
-jupyter notebook --config="${CONFIG_FILE}" <%= context.extra_jupyter_args %>
+module load Anaconda3
+<%= context.custom_environment.gsub(/\r\n?/, "\n") %>
+unset XDG_RUNTIME_DIR
+# Launch the JupyterLab Server
+jupyter-lab --config="${CONFIG_FILE}" <%= context.extra_jupyter_args %>

view.html.erb

 <form action="/node/<%= host %>/<%= port %>/login" method="post" target="_blank">
   <input type="hidden" name="password" value="<%= password %>">
   <button class="btn btn-primary" type="submit">
-    <i class="fas fa-eye"></i> Connect to Jupyter
+    <i class="fas fa-eye"></i> Connect to JupyterLab
   </button>
 </form>