zhangyiss/the-littlest-jupyterhub
1
0
Fork 0
mirror of https://github.com/jupyterhub/the-littlest-jupyterhub.git synced 2025-12-18 21:54:05 +08:00
Code Issues Packages Projects Releases Wiki Activity

split server resizing instructions

Browse Source
This commit is contained in:
April Wright
2018-09-22 21:47:40 -05:00
parent 1d0404eb5d
commit db0ddb94fb
4 changed files with 62 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
docs/howto/admin/resize.rst Normal file
View File

@@ -0,0 +1,55 @@
.. _howto/admin/resize:
=================
Resizing a server
=================
As you are using your JupyterHub, you may find that you have a need to increase or decrease
the amount of resources allocated to your TLJH install. How resources can be reallocated
will depend on the server interface; consult the installation page for your provider for
more information.
However, once resources have been relocated, you must tell TLJH to make use of these resources,
and verify that the resources have become available.
.. _tljhconf:
Verifying a Resize
==================
#. You will need to tell the JupyterHub to make use of these new resources.
To accomplish this, you will follow the instructions in :ref:`topic/tljh-config`
to set memory limits and reload the hub. This can be completed using the terminal
in the JupyterHub. It can also be completed through the Digital Ocean console or terminal.
#. TLJH configuration options can be verified by viewing the tljh-config output.
.. code-block:: bash
sudo tljh-config show
#. If you have changed your memory availability successfully, this will be reflected
in the `nbresuse <https://github.com/yuvipanda/nbresuse>`_ extension in the upper-right
when you open a Jupyter notebook on the Hub.
.. image:: ../../images/nbresuse.png
:alt: nbresuse demonstration
#. If you have changed the number of cores, this can be verified at the command line.
``nproc`` displays the number of available cores, and should be equal to the
number of cores you selected in the "Resize Droplet" panel.
.. code-block:: bash
nproc --all
#. Disk space changes can be verified, as well. The ``df`` command shows how much disk
space is available. The ``-hT`` argument allows us to have this printed in a human readable
format, and condenses the output to show one storage volume.
.. code-block:: bash
df -hT /home

1
docs/index.rst
View File

@@ -81,6 +81,7 @@ Administration and security
howto/admin/admin-users
howto/admin/resource-estimation
howto/admin/resize
howto/admin/nbresuse
howto/admin/https

38
docs/install/digitalocean.rst
View File

@@ -128,40 +128,6 @@ Step 4: Resizing and editing the droplet
.. image:: ../images/providers/digitalocean/resize-droplet.png
:alt: Resize panel of digital ocean
#. You will need to tell the JupyterHub to make use of these new resources.
To accomplish this, you will follow the instructions in :ref:`topic/tljh-config`
to set memory limits and reload the hub. This can be completed using the terminal
in the JupyterHub, as in Step 3. It can also be completed through the Digital Ocean
console.
#. TLJH configuration options can be verified by viewing the tljh-config output.
.. code-block:: bash
sudo tljh-config show
#. If you have changed your memory availability successfully, this will be reflected
in the `nbresuse <https://github.com/yuvipanda/nbresuse>`_ extension in the upper-right
when you open a Jupyter notebook on the Hub.
.. image:: ../images/nbresuse.png
:alt: nbresuse demonstration
#. If you have changed the number of cores, this can be verified at the command line.
``nproc`` displays the number of available cores, and should be equal to the
number of cores you selected in the "Resize Droplet" panel.
.. code-block:: bash
nproc --all
#. Disk space changes can be verified, as well. The ``df`` command shows how much disk
space is available. The ``-hT`` argument allows us to have this printed in a human readable
format, and condenses the output to show one storage volume.
.. code-block:: bash
df -hT /home
Further information on making more resources available to TLJH and verifying resource
availability can be found in the How-To :ref:`howto/admin/resize`.

5
docs/topic/tljh-config.rst
View File

@@ -8,7 +8,7 @@ Configuring TLJH with ``tljh-config``
changes to TLJH.
Running ``tljh-config``
======================`
=======================
You can run ``tljh-config`` in two ways:
@@ -19,6 +19,9 @@ You can run ``tljh-config`` in two ways:
logged in to the server via other means (such as SSH). This is an
advanced use case, and not covered much in this guide.
.. _topic/tljh-set:
Set a configuration property
============================