From 0add075ab2e2d915f40908f73fde9c926d27ed65 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=90=D0=B1?=
 =?UTF-8?q?=D0=B4=D1=80=D0=B0=D1=85=D0=BC=D0=B0=D0=BD=D0=BE=D0=B2?=
 <565963@gmail.com>
Date: Fri, 13 Dec 2024 17:55:58 +0300
Subject: [PATCH] add: Jupyterhub instruction

---
 README.md                   |  4 +++-
 clusterBasics/jupyterhub.md | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 clusterBasics/jupyterhub.md

diff --git a/README.md b/README.md
index bc3fe09..329aaa3 100644
--- a/README.md
+++ b/README.md
@@ -12,4 +12,6 @@
 
 Базовые консольные команды доступные пользователям вычислительного кластера.
 
-## [MPI приложения. Инструкция по сборке и работе](./clusterBasics/mpi.md)
\ No newline at end of file
+## [MPI приложения. Инструкция по сборке и работе](./clusterBasics/mpi.md)
+
+## [Инструкция по Jupyterhub](./clusterBasics/jupyterhub.md)
\ No newline at end of file
diff --git a/clusterBasics/jupyterhub.md b/clusterBasics/jupyterhub.md
new file mode 100644
index 0000000..e076afa
--- /dev/null
+++ b/clusterBasics/jupyterhub.md
@@ -0,0 +1,33 @@
+# Для студентов
+
+## Введение
+
+Jupyterhub -- многопользовательский сервер c возможностью запускать Jupyter Notebook одной кнопкой. Он установлен на 31 узле кластера и настроен для работы с системой очередей SLURM, что позволяет работать с Jupyter Notebook сразу нескольким людям, не мешая друг другу.
+
+## Подключение
+
+Для подключения к Jupyterhub необходимо:
+
+ 1. Ввести в командную строку (если вы на windows 10+) либо в терминал (если вы на любом дистрибутиве GNU/Linux или даже BSD)
+    ssh -p 57322 -L 50000:192.168.1.32:50000 portforward@cluster.vstu.ru
+ 2. Если вы подключаетесь впервые вписать yes
+ 3. Ввести пароль AT&T
+ 4. Jupyterhub будет доступен по адресу localhost:50000
+ 5. В форме авторизации нужно будет ввести любого пользователя кластера, данные вам выдаст преподаватель.
+ 6. Вам будет доступно 2 venv - для обучения нейронных сетей и для математики. Посмотреть список установленных библиотек можно командой pip list. Установить новые пакеты так же можно командой pip install, эти venv не требуют root-прав.
+
+Сессия выдаётся на 6 часов, по истечении времени необходимо будет создать Jupyter notebook сервер заново.
+
+
+
+# Для админов
+
+Jupyterhub настраивается файлом /etc/jupyterhub/jupyterhub_config.py
+
+Работает через systemd, название демона -- jupyterhub
+
+Вся документация по Jupyterhub -- https://jupyterhub.readthedocs.io/en/stable/
+
+Вся документация по Batchspawner -- https://pypi.org/project/batchspawner/
+
+Под авторством: Фёдор Ч. 2024 год.
\ No newline at end of file