From 1cb30f8ee0d3a1c341dcca8cc6140d2c1c03614e Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Tue, 30 Oct 2018 17:38:20 -0400 Subject: [PATCH 1/8] Update custom-server.rst --- docs/install/custom-server.rst | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index be737fe..2340647 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -31,6 +31,20 @@ Step 1: Installing The Littlest JupyterHub #. Using a terminal program, SSH into your server. This should give you a prompt where you can type commands. +#. If your server is behind a firewall and needs a proxy: + +.. code:: + + export http_proxy= + export https_proxy= + +#. Some requests will fail if your certs are self-signed: + +.. code:: + + export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates + sudo npm config set strict-ssl false + #. Make sure you have ``Python3``, ``curl`` and ``git`` installed. On latest Ubuntu you can get all of these with: .. code:: @@ -45,7 +59,7 @@ Step 1: Installing The Littlest JupyterHub .. code-block:: bash - curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py | sudo python3 - --admin + curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py | sudo -E python3 - --admin .. note:: From 498a1cbd40e37f31e5d21d936d9bd2fe020827ea Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Sat, 3 Nov 2018 17:29:30 -0400 Subject: [PATCH 2/8] Update custom-server.rst --- docs/install/custom-server.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index 2340647..a5cbece 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -33,23 +33,23 @@ Step 1: Installing The Littlest JupyterHub #. If your server is behind a firewall and needs a proxy: -.. code:: + .. code-block:: bash - export http_proxy= - export https_proxy= + export http_proxy= + export https_proxy= #. Some requests will fail if your certs are self-signed: -.. code:: + .. code:: - export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates - sudo npm config set strict-ssl false + export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates + sudo npm config set strict-ssl false #. Make sure you have ``Python3``, ``curl`` and ``git`` installed. On latest Ubuntu you can get all of these with: -.. code:: + .. code:: - apt-get install python3 git curl + apt-get install python3 git curl #. Copy the text below, and paste it into the terminal. Replace ```` with the name of the first **admin user** for this From eb68a80991be6a1742836966033025235461dd6f Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Tue, 27 Nov 2018 17:15:18 -0500 Subject: [PATCH 3/8] Update custom-server.rst Relax the item about public IP address? Currently the install does **not** report "Done!" --- docs/install/custom-server.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index a5cbece..96d2be3 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -36,14 +36,15 @@ Step 1: Installing The Littlest JupyterHub .. code-block:: bash export http_proxy= - export https_proxy= -#. Some requests will fail if your certs are self-signed: +#. Some requests will fail if your certs are self-signed. Copy the text below and paste it + into the terminal after replacing ```` + with the **path of the directory containing your ssl certificates** (don't include the brackets!).: .. code:: - export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates - sudo npm config set strict-ssl false + export REQUESTS_CA_BUNDLE= + sudo npm config set cafile #. Make sure you have ``Python3``, ``curl`` and ``git`` installed. On latest Ubuntu you can get all of these with: From 988f198958803689aa6b1ba6acc5a97f5a68c7e1 Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Wed, 28 Nov 2018 07:29:21 -0500 Subject: [PATCH 4/8] Update custom-server.rst --- docs/install/custom-server.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index 96d2be3..8ea1008 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -44,7 +44,7 @@ Step 1: Installing The Littlest JupyterHub .. code:: export REQUESTS_CA_BUNDLE= - sudo npm config set cafile + sudo npm config set cafile= #. Make sure you have ``Python3``, ``curl`` and ``git`` installed. On latest Ubuntu you can get all of these with: From bcc9014e96e34ca3097bd0f8225d7897020cb1a3 Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Wed, 28 Nov 2018 07:43:11 -0500 Subject: [PATCH 5/8] Create temp-log-example --- docs/troubleshooting/temp-log-example | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/troubleshooting/temp-log-example diff --git a/docs/troubleshooting/temp-log-example b/docs/troubleshooting/temp-log-example new file mode 100644 index 0000000..026cb75 --- /dev/null +++ b/docs/troubleshooting/temp-log-example @@ -0,0 +1,16 @@ +Nov 26 13:39:12 ip-1-70-56-145 systemd[1]: Started traefik.service. +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="Using TOML configuration file /opt/tljh/state/traefik.toml" +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="Traefik version v1.6.5 built on 2018-07-10_03:54:03PM" +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="\nStats collection is disabled.\nHelp us improve Traefik by turning this feature on :)\nMore details on: https://docs.traefik.io/basics/#collected-data\n" +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="Preparing server https &{Address::443 TLS:0xc42004cd00 Redirect: Auth: WhitelistSourceRange:[] WhiteList: Compress:false ProxyProtocol: Forwar +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=error msg="Unable to add a certificate to the entryPoint \"https\" : unable to generate TLS certificate : tls: private key does not match public key" +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=error msg="Error creating TLS config: No certificates found for TLS entrypoint https" +Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=fatal msg="Error preparing server: No certificates found for TLS entrypoint https" +Nov 26 13:39:12 ip-1-70-56-145 systemd[1]: traefik.service: Main process exited, code=exited, status=1/FAILURE +Nov 26 13:39:12 ip-1-70-56-145 systemd[1]: traefik.service: Failed with result 'exit-code'. +Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Service hold-off time over, scheduling restart. +Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Scheduled restart job, restart counter is at 5. +Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: Stopped traefik.service. +Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Start request repeated too quickly. +Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Failed with result 'exit-code'. +Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: Failed to start traefik.service. From 553e75a9c8fe9c5503c7ee6d34fee35d34b8e41f Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Wed, 28 Nov 2018 16:40:42 -0500 Subject: [PATCH 6/8] Update custom-server.rst --- docs/install/custom-server.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index 8ea1008..6546ad2 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -23,7 +23,7 @@ Pre-requisites #. Some familiarity with the command line. #. A server running Ubuntu 18.04 where you have root access. #. Ability to ``ssh`` into the server & run commands from the prompt. -#. A **public IP** where the server can be accessed from the internet. +#. A **IP address** where the server can be reached from the browsers of your target audience. Step 1: Installing The Littlest JupyterHub ========================================== From 24a0c860c7127d72612edf4c6fa73e6cd5256ac2 Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Wed, 28 Nov 2018 16:43:03 -0500 Subject: [PATCH 7/8] Delete temp-log-example --- docs/troubleshooting/temp-log-example | 16 ---------------- 1 file changed, 16 deletions(-) delete mode 100644 docs/troubleshooting/temp-log-example diff --git a/docs/troubleshooting/temp-log-example b/docs/troubleshooting/temp-log-example deleted file mode 100644 index 026cb75..0000000 --- a/docs/troubleshooting/temp-log-example +++ /dev/null @@ -1,16 +0,0 @@ -Nov 26 13:39:12 ip-1-70-56-145 systemd[1]: Started traefik.service. -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="Using TOML configuration file /opt/tljh/state/traefik.toml" -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="Traefik version v1.6.5 built on 2018-07-10_03:54:03PM" -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="\nStats collection is disabled.\nHelp us improve Traefik by turning this feature on :)\nMore details on: https://docs.traefik.io/basics/#collected-data\n" -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=info msg="Preparing server https &{Address::443 TLS:0xc42004cd00 Redirect: Auth: WhitelistSourceRange:[] WhiteList: Compress:false ProxyProtocol: Forwar -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=error msg="Unable to add a certificate to the entryPoint \"https\" : unable to generate TLS certificate : tls: private key does not match public key" -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=error msg="Error creating TLS config: No certificates found for TLS entrypoint https" -Nov 26 13:39:12 ip-1-70-56-145 traefik[11860]: time="2018-11-26T13:39:12Z" level=fatal msg="Error preparing server: No certificates found for TLS entrypoint https" -Nov 26 13:39:12 ip-1-70-56-145 systemd[1]: traefik.service: Main process exited, code=exited, status=1/FAILURE -Nov 26 13:39:12 ip-1-70-56-145 systemd[1]: traefik.service: Failed with result 'exit-code'. -Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Service hold-off time over, scheduling restart. -Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Scheduled restart job, restart counter is at 5. -Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: Stopped traefik.service. -Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Start request repeated too quickly. -Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: traefik.service: Failed with result 'exit-code'. -Nov 26 13:39:13 ip-1-70-56-145 systemd[1]: Failed to start traefik.service. From 339bb839e69f9ba312f00a4861b8c9ffa7058055 Mon Sep 17 00:00:00 2001 From: Fred Mitchell Date: Wed, 28 Nov 2018 17:22:53 -0500 Subject: [PATCH 8/8] Update custom-server.rst --- docs/install/custom-server.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index 6546ad2..1cfe9f5 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -31,7 +31,7 @@ Step 1: Installing The Littlest JupyterHub #. Using a terminal program, SSH into your server. This should give you a prompt where you can type commands. -#. If your server is behind a firewall and needs a proxy: +#. If your server is behind a firewall and needs a proxy to reach the internet: .. code-block:: bash