Built site for gh-pages

berkeley-dsep-infra · Aug 9, 2024 · d93cca6 · d93cca6
1 parent d413ac9
commit d93cca6
Show file tree

Hide file tree

Showing 63 changed files with 167 additions and 150 deletions.
diff --git a/.nojekyll b/.nojekyll
@@ -1 +1 @@
-f48116bd
+de01b04c
diff --git a/CNAME b/CNAME
diff --git a/admins/cluster-config.html b/admins/cluster-config.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/credentials.html b/admins/credentials.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/deployments/datahub.html b/admins/deployments/datahub.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/deployments/index.html b/admins/deployments/index.html
@@ -285,7 +285,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/deployments/stat159.html b/admins/deployments/stat159.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/calendar-scaler.html b/admins/howto/calendar-scaler.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/clusterswitch.html b/admins/howto/clusterswitch.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/core-pool.html b/admins/howto/core-pool.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/course-config.html b/admins/howto/course-config.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/delete-hub.html b/admins/howto/delete-hub.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">
@@ -909,8 +909,8 @@ <h2 class="anchored" data-anchor-id="steps-to-spin-down-a-hub">Steps to spin dow
 </script>
 <nav class="page-navigation">
   <div class="nav-page nav-page-previous">
-      <a href="../../admins/howto/remove-users-orm.html" class="pagination-link" aria-label="Remove inactive users from hub ORM">
-        <i class="bi bi-arrow-left-short"></i> <span class="nav-page-text">Remove inactive users from hub ORM</span>
+      <a href="../../admins/howto/remove-users-orm.html" class="pagination-link" aria-label="JupyterHub ORM Maintenance">
+        <i class="bi bi-arrow-left-short"></i> <span class="nav-page-text">JupyterHub ORM Maintenance</span>
       </a>          
   </div>
   <div class="nav-page nav-page-next">

diff --git a/admins/howto/dns.html b/admins/howto/dns.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/github-token.html b/admins/howto/github-token.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/google-sheets.html b/admins/howto/google-sheets.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/index.html b/admins/howto/index.html
@@ -285,7 +285,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/new-hub.html b/admins/howto/new-hub.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/new-image.html b/admins/howto/new-image.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/new-packages.html b/admins/howto/new-packages.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/preview-local.html b/admins/howto/preview-local.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/prometheus-grafana.html b/admins/howto/prometheus-grafana.html
@@ -321,7 +321,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">
@@ -895,8 +895,8 @@ <h1>Grafana</h1>
       </a>          
   </div>
   <div class="nav-page nav-page-next">
-      <a href="../../admins/howto/remove-users-orm.html" class="pagination-link" aria-label="Remove inactive users from hub ORM">
-        <span class="nav-page-text">Remove inactive users from hub ORM</span> <i class="bi bi-arrow-right-short"></i>
+      <a href="../../admins/howto/remove-users-orm.html" class="pagination-link" aria-label="JupyterHub ORM Maintenance">
+        <span class="nav-page-text">JupyterHub ORM Maintenance</span> <i class="bi bi-arrow-right-short"></i>
       </a>
   </div>
 </nav>

diff --git a/admins/howto/rebuild-hub-image.html b/admins/howto/rebuild-hub-image.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/rebuild-postgres-image.html b/admins/howto/rebuild-postgres-image.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/howto/remove-users-orm.html b/admins/howto/remove-users-orm.html
@@ -7,7 +7,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
 
 
-<title>Remove inactive users from hub ORM</title>
+<title>JupyterHub ORM Maintenance</title>
 <style>
 code{white-space: pre-wrap;}
 span.smallcaps{font-variant: small-caps;}
@@ -120,7 +120,7 @@
       <button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
         <i class="bi bi-layout-text-sidebar-reverse"></i>
       </button>
-        <nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../admins/pre-reqs.html">Contributing to DataHub</a></li><li class="breadcrumb-item"><a href="../../admins/howto/preview-local.html">Common Administrator Tasks</a></li><li class="breadcrumb-item"><a href="../../admins/howto/remove-users-orm.html">Remove inactive users from hub ORM</a></li></ol></nav>
+        <nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../admins/pre-reqs.html">Contributing to DataHub</a></li><li class="breadcrumb-item"><a href="../../admins/howto/preview-local.html">Common Administrator Tasks</a></li><li class="breadcrumb-item"><a href="../../admins/howto/remove-users-orm.html">JupyterHub ORM Maintenance</a></li></ol></nav>
         <a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">      
         </a>
     </div>
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link active">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">
@@ -391,9 +391,9 @@
 <!-- main -->
 <main class="content" id="quarto-document-content">
 
-<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../admins/pre-reqs.html">Contributing to DataHub</a></li><li class="breadcrumb-item"><a href="../../admins/howto/preview-local.html">Common Administrator Tasks</a></li><li class="breadcrumb-item"><a href="../../admins/howto/remove-users-orm.html">Remove inactive users from hub ORM</a></li></ol></nav>
+<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../admins/pre-reqs.html">Contributing to DataHub</a></li><li class="breadcrumb-item"><a href="../../admins/howto/preview-local.html">Common Administrator Tasks</a></li><li class="breadcrumb-item"><a href="../../admins/howto/remove-users-orm.html">JupyterHub ORM Maintenance</a></li></ol></nav>
 <div class="quarto-title">
-<h1 class="title">Remove inactive users from hub ORM</h1>
+<h1 class="title">JupyterHub ORM Maintenance</h1>
 </div>
 
 
@@ -410,7 +410,12 @@ <h1 class="title">Remove inactive users from hub ORM</h1>
 </header>
 
 
-<p>JupyterHub performance sometimes scales with the <em>total</em> number of users in its ORM database, rather than the number of running users. Reducing the user count enables the hub to restart much faster. While this issue should be addressed, we can work around it by deleting inactive users from the hub database once in a while. Note that this does not delete the user’s storage. The script <code>scripts/delete-unused-users.py</code> will delete anyone who hasn’t registered any activity in a given period of time, double checking to make sure they aren’t active right now. This will require users to log in again the next time they use the hub, but that is probably fine. This should be done before the start of each semester, particularly on hubs with a lot of users.</p>
+<section id="performance" class="level2">
+<h2 class="anchored" data-anchor-id="performance">Performance</h2>
+<p>JupyterHub performance sometimes scales with the <em>total</em> number of users in its ORM database, rather than the number of running users. Reducing the user count enables the hub to restart much faster. While this issue should be addressed, we can work around it by deleting inactive users from the hub database once in a while. Note that this does not delete the user’s storage.</p>
+<p>The script <code>scripts/delete-unused-users.py</code> will delete anyone who hasn’t registered any activity in a given period of time, double checking to make sure they aren’t active right now. This will require users to log in again the next time they use the hub, but that is probably fine.</p>
+<p>This should be done before the start of each semester, particularly on hubs with a lot of users.</p>
+</section>
 <section id="run-the-script" class="level2">
 <h2 class="anchored" data-anchor-id="run-the-script">Run the script</h2>
 <p>You can run the script on your own device. The script depends on the <code>jhub_client</code> python library. This can be installed with <code>pip install jhub_client</code>.</p>

diff --git a/admins/index.html b/admins/index.html
@@ -285,7 +285,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/pre-reqs.html b/admins/pre-reqs.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/storage.html b/admins/storage.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/admins/structure.html b/admins/structure.html
@@ -287,7 +287,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-02-09-datahub-db-outage-pvc-recreate-script.html b/incidents/2017-02-09-datahub-db-outage-pvc-recreate-script.html
@@ -322,7 +322,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-02-09-datahub-db-outage.html b/incidents/2017-02-09-datahub-db-outage.html
@@ -320,7 +320,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-02-24-autoscaler-incident.html b/incidents/2017-02-24-autoscaler-incident.html
@@ -286,7 +286,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-02-24-proxy-death-incident.html b/incidents/2017-02-24-proxy-death-incident.html
@@ -286,7 +286,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-03-06-helm-config-image-mismatch.html b/incidents/2017-03-06-helm-config-image-mismatch.html
@@ -286,7 +286,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-03-20-too-many-volumes.html b/incidents/2017-03-20-too-many-volumes.html
@@ -286,7 +286,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-03-23-kernel-deaths-incident.html b/incidents/2017-03-23-kernel-deaths-incident.html
@@ -320,7 +320,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-04-03-cluster-full-incident.html b/incidents/2017-04-03-cluster-full-incident.html
@@ -320,7 +320,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">

diff --git a/incidents/2017-05-09-gce-billing.html b/incidents/2017-05-09-gce-billing.html
@@ -286,7 +286,7 @@
           <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../admins/howto/remove-users-orm.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Remove inactive users from hub ORM</span></a>
+ <span class="menu-text">JupyterHub ORM Maintenance</span></a>
   </div>
 </li>
           <li class="sidebar-item">