Skip to content

Commit 5e4f4f6

Browse files
committed
website: small edits in nersc overview
1 parent 01c439d commit 5e4f4f6

File tree

1 file changed

+27
-29
lines changed

1 file changed

+27
-29
lines changed

docs/nersc/index.md

Lines changed: 27 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -3,20 +3,16 @@
33
Our tools have been installed at NERSC,
44
the [National Energy Research Scientific Computing Center](https://www.nersc.gov/),
55
and are continually updated there.
6-
The following sections on this page contain instructions for users who would like to use our installations.
6+
The following sections on this page contain instructions for users who would like to
7+
**use** our installations **for analysis**.
78

89
[[toc]]
910

10-
::: warning
11-
Users who would like to understand how our installation was done
12-
are referred to [this page](./public_installation).
13-
14-
Users who would like to their own installations at NERSC are referred to
15-
[this example](./users_installation.md).
16-
17-
Users who would like to install the tools on their laptop or desktop
18-
can find relevant information [here](/guides/install_and_launch).
19-
:::
11+
Users who are interested in the installation itself can find related information
12+
on separate pages:
13+
- How our public installation was done: see [this page](./public_installation).
14+
- How to get your own installations at NERSC: see [this example](./users_installation.md).
15+
- How to install the tools on a laptop or desktop computer: see [this page](/guides/install_and_launch).
2016

2117
## Quickstart for users familiar with JupyterHub
2218

@@ -36,12 +32,12 @@ can find relevant information [here](/guides/install_and_launch).
3632
/global/common/software/m4359/quickcompare
3733
```
3834

39-
- After a few seconds, the Terminal window will say "Use URL below to connect to the application:"
40-
and shows a URL starting with `https://`.
35+
- After a few seconds, the terminal window will say "Use URL below to connect to the application:"
36+
and show a URL starting.
4137
A click on the URL will bring up the graphical UI in a brower window.
4238

4339
::: tip Tip 1: Choosing a server for your analysis session.
44-
JupyterHub's control panel allows users to choose from serveral different types of resources
40+
JupyterHub's control panel offers to NERSC users serveral different types of resources (nodes)
4541
for their computing and analyais needs, including, e.g., login node, shared GPU node,
4642
exclusive nodes, as explained in [NERSC's documentation](https://docs.nersc.gov/services/jupyter/reference/).
4743

@@ -53,28 +49,30 @@ Keep in mind, though, that time spent on shared GPU nodes or exclusive nodes
5349
will be charged to your project's allocation.
5450
:::
5551

56-
::: tip Tip 2: Same executable for all types of nodes.
52+
::: tip Tip 2: The same executables work for all types of nodes.
5753
Regardless of which type of node is chosen, the same commands (as listed above)
5854
are used to launch our tools in the QuickView family.
5955
:::
6056

61-
::: tip Tip 3: No need to manually load `conda`.
57+
::: tip Tip 3: No need for manual `module load conda`.
6258
When one of the commands provided above is used to launch tools in the QuickView family,
63-
there is no need to manually load `conda` or the conda environment that our tools are installed in.
64-
This is because the above-mentioned commands are in fact scripts that have included those steps.
59+
there is no need to manually apply `module load conda` or activate the environment
60+
that our tools are installed in. This is because the above-mentioned commands are
61+
in fact scripts that have included those steps.
6562
:::
6663

67-
::: warning IMPORTANT: Shut down the server when you are done.
68-
After finishing your analysis, please remember to shut down the connection to your selected
69-
server (node) to stop the charging of hours to your project's allocation.
70-
This is explained at the end of
64+
::: warning ATTENTION: Shut down the server when you are done!
65+
After finishing your analysis, please remember to shut down the connection to your
66+
assigned node to avoid keeping the resource idle and unnecessarily charging
67+
to your project's allocation. This is explained at the end of
7168
[this video](https://docs.nersc.gov/beginner-guide/#keypad-entry-log-in-using-jupyter),
7269
and below is a recap of the steps (clicks):
73-
- go to the JupytherHub window/tab in your browser,
74-
- click `File` in the top-left corner,
75-
- scroll down and choose `Hub Control Panel`,
76-
- in the Control Panel brought up in a new browser tab/window, click on the red "stop" button
77-
for the server to be shut down. An example is shown in the screenshot below.
70+
- Go to the JupytherHub window/tab in your browser,
71+
- Click on `File` in the top-left corner,
72+
- Scroll down and choose `Hub Control Panel`,
73+
- In the Control Panel brought up in a new browser tab or window,
74+
click on the red "stop" button for the server to be shut down.
75+
An example is shown in the screenshot below.
7876

7977
![JupyterHub_control_panel_with_stop_button.png](/nersc/JupyterHub_control_panel_with_stop_button.png)
8078
:::
@@ -84,11 +82,11 @@ and below is a recap of the steps (clicks):
8482
Please see
8583
[this section of NERSC's documentation](https://docs.nersc.gov/beginner-guide/#keypad-entry-log-in-using-jupyter),
8684
especially the video "How to log in to Perlmutter with Jupyter",
87-
to learn how to use the service.
85+
to learn about the service.
8886

8987
Alternatively, follow our step-by-step description [here](./jupyter_at_nersc.md)
9088

9189
## If you do not yet have any user account at NERSC
9290

9391
Information on [this page](https://docs.nersc.gov/accounts/#obtaining-an-account)
94-
can help get you started.
92+
can help you get started.

0 commit comments

Comments
 (0)