You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/in-situ-python-analysis/jupyter-notebook/frontend.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ Use `TAB` key to do auto-completion.
34
34
35
35
### User Interface
36
36
37
-
This is the same as traditional Jupyter Notebook UI. Be careful when sending kernel related instructions (ex: shutdown/interrupt/restart a kernel).
37
+
This is the same as traditional Jupyter Notebook UI. Be careful when sending kernel related instructions (ex: shutdown/interrupt/restart a kernel). Interrupting and restarting the kernel is not supported in libyt kernel yet.
38
38
39
39
```{attention}
40
40
If the notebook is connected to libyt kernel, restarting only exits the kernel, and libyt API [`yt_run_JupyterKernel`](../../libyt-api/yt_run_jupyterkernel.md#yt_run_jupyterkernel) returns. It won't restart another kernel by itself.
@@ -50,4 +50,4 @@ Go to `Running Terminals and Kernels` -> `Shutdown Kernel`.
50
50
51
51
After exiting the kernel, the simulation process may continue its job.
52
52
While waiting for a new libyt kernel being launched, we don't need to close the entire notebook to reconnect to it.
53
-
We can choose the libyt kernel from the kernel list once libyt kernel is activated again.
53
+
We can choose the libyt kernel from the kernel list once it is activated again.
Copy file name to clipboardExpand all lines: doc/in-situ-python-analysis/jupyter-notebook/remote-cluster.md
+33-15Lines changed: 33 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,13 +24,20 @@
24
24
"key": "64e13a6faaf1470eb1f86df565543923"
25
25
}
26
26
```
27
-
-`ip` should be the internal ip of the computing node, where MPI root process is. Normally, we can find it in `/etc/hosts`:
28
-
```bash
29
-
cat /etc/hosts
30
-
```
31
-
- Ports should be unused. If the ports are in use, then`libyt` will block and waitfor you to provide a new one.
27
+
28
+
```{eval-rst}
29
+
.. tip::
30
+
- ``ip`` should be the internal ip of the computing node, where MPI root process is. Normally, we can find it in ``/etc/hosts``:
31
+
32
+
.. code-block:: bash
33
+
34
+
cat /etc/hosts
35
+
36
+
- Ports should be unused. If the ports are in use, then ``libyt`` will block and wait for you to provide a new one.
37
+
```
38
+
32
39
4. Wait for incoming connection from Jupyter Notebook / JupyterLab (See below [Connecting to Kernel](#connecting-to-kernel))
33
-
5. Shutdown the kernel. ([How to Exit](./jupyter-notebook-access.md#how-to-exit))
40
+
5. Shutdown the kernel. ([How to Exit](./frontend.md#how-to-exit))
34
41
35
42
## Connecting to Kernel
36
43
@@ -39,7 +46,9 @@ Finally, we can open the web browser on our local laptop and connect to libyt ke
39
46
40
47
Please go through [Login Node](#login-node) before going through [Local Laptop](#local-laptop) Section.
41
48
42
-
> {octicon}`info;1em;sd-text-info;` We don't need a running simulation before going through these steps. These steps can also check if SSH tunneling is working and can launch other kernels (like ipykernel) on login node, not just connecting to libyt kernel.
49
+
```{note}
50
+
We don't need a running simulation before going through these steps. These steps can also check if SSH tunneling is working and can launch other kernels (like ipykernel) on login node, not just connecting to libyt kernel.
51
+
```
43
52
44
53
### Login Node
45
54
@@ -63,15 +72,24 @@ Please go through [Login Node](#login-node) before going through [Local Laptop](
63
72
```
64
73
Here, we assume login node's internal ip is `192.168.0.150`.
65
74
2. After [Login Node](#login-node) has started a no-browser jupyter notebook, use SSH port forwarding and connect to the Jupyter Notebook / JupyterLab server on the login node.
``YYYY`` is the port you want to bind to on local laptop,
90
+
and ``XXXX`` is the port where JupyterLab binds to on login node.
91
+
If there is no ``<host_port>``, simply remove ``-p <host_port>``.
68
92
```
69
-
- Replace `<host_port>`, `<user>`, and `<host>` to SSH connection settings. For example, an SSH connection would be like:
70
-
```bash
71
-
ssh -p <host_port> <user>@<host>
72
-
```
73
-
If there is no `<host_port>`, simply remove `-p <host_port>`.
74
-
- `YYYY` is the port you want to bind to on local laptop.
75
93
3. Leave the terminal open. (It's normal if it doesn't print anything after connection.)
76
94
4. Copy and paste the link from [Login Node -- Step 3](#login-node) and change `XXXX` to `YYYY` in browser.
77
95
5. Click "Libyt" kernel and connect to libyt kernel launched by libyt API [`yt_run_JupyterKernel`](../../libyt-api/yt_run_jupyterkernel.md#yt_run_jupyterkernel).
0 commit comments