From 324dc20600f4762613855c37f1d0a2a42ffeb1d5 Mon Sep 17 00:00:00 2001 From: DataCascadia Date: Sun, 21 Feb 2021 18:31:32 -0800 Subject: [PATCH 1/2] Added instructions for restarting JupyterHub to the Troubleshooting section of the docs in response to issue #455 --- docs/troubleshooting/index.rst | 3 ++- docs/troubleshooting/restart.rst | 31 +++++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+), 1 deletion(-) create mode 100644 docs/troubleshooting/restart.rst diff --git a/docs/troubleshooting/index.rst b/docs/troubleshooting/index.rst index 184404c..12361a0 100644 --- a/docs/troubleshooting/index.rst +++ b/docs/troubleshooting/index.rst @@ -10,6 +10,7 @@ guides help you find what is broken & hopefully fix it. :caption: Troubleshooting logs + restart Often, your issues are not related to TLJH itself but to the cloud provider your server is running on. We have some documentation on common issues you @@ -21,4 +22,4 @@ here to better support your favorite provider! providers/google providers/amazon - providers/custom \ No newline at end of file + providers/custom diff --git a/docs/troubleshooting/restart.rst b/docs/troubleshooting/restart.rst new file mode 100644 index 0000000..4f9ea90 --- /dev/null +++ b/docs/troubleshooting/restart.rst @@ -0,0 +1,31 @@ + +============================================= +Stopping and Restarting the JupyterHub Server +============================================= + +The user can **stop** the JupyterHub server using: + +.. code-block:: console + + $ systemctl stop jupyterhub.service + +.. warning:: + + Keep in mind that other services that may also require stopping: + + * The user's Jupyter server: jupyter-username.service + * Traefik.service + +The user may **restart** JupyterHub and Traefik services by running: + +.. code-block:: console + + $ tljh-config reload proxy + +This calls systemctl and restarts Traefik. The user may call systemctl and restart only the JupyterHub using the command: + +.. code-block:: console + + $ tljh-config reload hub + + From d6cf2f4a5ac0284956333b0c2a6143b53e5e7e0f Mon Sep 17 00:00:00 2001 From: Erik Sundell Date: Sat, 16 Oct 2021 20:21:38 +0200 Subject: [PATCH 2/2] Apply suggestions from code review --- docs/troubleshooting/restart.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/troubleshooting/restart.rst b/docs/troubleshooting/restart.rst index 4f9ea90..18a2498 100644 --- a/docs/troubleshooting/restart.rst +++ b/docs/troubleshooting/restart.rst @@ -20,12 +20,12 @@ The user may **restart** JupyterHub and Traefik services by running: .. code-block:: console - $ tljh-config reload proxy + $ sudo tljh-config reload proxy This calls systemctl and restarts Traefik. The user may call systemctl and restart only the JupyterHub using the command: .. code-block:: console - $ tljh-config reload hub + $ sudo tljh-config reload hub