Skip to content

Commit 66e7c04

Browse files
author
purduercac-docs-bot
committed
Merge remote-tracking branch 'origin/main' into dev
2 parents 59e1231 + ab8ebbb commit 66e7c04

2 files changed

Lines changed: 57 additions & 47 deletions

File tree

docs/userguides/negishi/faqs.md

Lines changed: 46 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Negishi differs from the previous Community Clusters in several significant aspe
2929
* GCC compiler with OpenMPI or MVAPICH2 MPI libraries are recommended for software development on Negishi. You can enable this software with `module load gcc openmpi` (default) or `module load gcc mvapich2`.
3030
* If you use Jupyter notebooks, JupyterHub on Negishi will be available only via the [OnDemand Gateway](https://gateway.negishi.rcac.purdue.edu) rather than the freestanding version as on some previous systems. Other RCAC systems will transition to OnDemand as well, following Negishi.
3131

32-
#### Upcoming 2023
32+
**Starting from 2023**
3333

3434
* A subset of Negishi compute nodes contain AMD Radeon Instinct MI210 accelerator cards which can significantly improve performance of compute-intensive workloads. These can be utilized by submitting jobs to the `gpu` queue (add `-A gpu` to your job submission command).
3535
* A selection of GPU-enabled ROCm application containers from the AMD InfinityHub collection is installed.
@@ -51,13 +51,13 @@ If you plan to use `hsi` or `htar` commands to access Fortress tape archive from
5151

5252
### /usr/bin/xauth: error in locking authority file
5353

54-
#### Problem
54+
**Problem**
5555

5656
I receive this message when logging in:
5757

5858
`/usr/bin/xauth: error in locking authority file`
5959

60-
#### Solution
60+
**Solution**
6161

6262
Your home directory disk quota is full. You may check your quota with `myquota`.
6363

@@ -76,11 +76,11 @@ There are several common locations that tend to grow large over time and are mer
7676

7777
### My SSH connection hangs
7878

79-
#### Problem
79+
**Problem**
8080

8181
Your console hangs while trying to connect to a RCAC Server.
8282

83-
#### Solution
83+
**Solution**
8484

8585
This can happen due to various reasons. Most common reasons for hanging SSH terminals are:
8686

@@ -92,101 +92,101 @@ If neither of the suggestions above work, please [contact support](https://www.r
9292

9393
### ThinLinc session frozen
9494

95-
#### Problem
95+
**Problem**
9696

9797
Your ThinLinc session is frozen and you can not launch any commands or close the session.
9898

99-
#### Solution
99+
**Solution**
100100

101101
This can happen due to various reasons. The most common reason is that you ran something memory-intensive inside that ThinLinc session on a front-end, so parts of the ThinLinc session got killed by Cgroups, and the entire session got stuck.
102102

103103
* **If you are using a web-version ThinLinc remote desktop (inside the browser):**
104104

105-
The web version does not have the capability to kill the existing session, only the standalone client does. Please install the standalone client and follow the steps below:
105+
The web version does not have the capability to kill the existing session, only the standalone client does. Please install the standalone client and follow the steps below:
106106

107-
[ThinLinc](accounts.md#thinlinc)
107+
[ThinLinc](accounts.md#thinlinc)
108108

109109
* **If you are using a ThinLinc client:**
110110

111-
Close the ThinLinc client, reopen the client login popup, and select `End existing session`.
111+
Close the ThinLinc client, reopen the client login popup, and select `End existing session`.
112112

113-
<p style="text-align: center;">
114-
<img src="/assets/images/userguides/thinlinc4.png" alt="ThinLinc Login Popup" width="80%">
115-
</p>
113+
<p style="text-align: center;">
114+
<img src="/assets/images/userguides/thinlinc4.png" alt="ThinLinc Login Popup" width="80%">
115+
</p>
116116

117117
Select "End existing session" and try "Connect" again.
118118

119119
### ThinLinc session unreachable
120120

121-
#### Problem
121+
**Problem**
122122

123123
When trying to login to ThinLinc and re-connect to your existing session, you receive an error *"Your ThinLinc session is currently unreachable"*.
124124

125-
#### Solution
125+
**Solution**
126126

127127
This can happen if the specific login node your existing remote desktop session was residing on is currently offline or down, so ThinLinc can not reconnect to your existing session. Most often the session is non-recoverable at this point, so the solution is to terminate your existing ThinLinc desktop session and start a new one.
128128

129129
* **If you are using a web-version ThinLinc remote desktop (inside the browser):**
130130

131-
The web version does not have the capability to kill the existing session, only the standalone client does. Please install the standalone client and follow the steps below:
131+
The web version does not have the capability to kill the existing session, only the standalone client does. Please install the standalone client and follow the steps below:
132132

133-
[ThinLinc](accounts.md#thinlinc)
133+
[ThinLinc](accounts.md#thinlinc)
134134

135135
* **If you are using a ThinLinc client:**
136136

137-
Close the ThinLinc client, reopen the client login popup, and select `End existing session`.
137+
Close the ThinLinc client, reopen the client login popup, and select `End existing session`.
138138

139-
<p style="text-align: center;">
140-
<img src="/assets/images/userguides/thinlinc4.png" alt="ThinLinc Login Popup" width="80%">
141-
</p>
139+
<p style="text-align: center;">
140+
<img src="/assets/images/userguides/thinlinc4.png" alt="ThinLinc Login Popup" width="80%">
141+
</p>
142142

143-
Select "End existing session" and try "Connect" again.
143+
Select "End existing session" and try "Connect" again.
144144

145145
### How to disable ThinLinc screensaver
146146

147-
#### Problem
147+
**Problem**
148148

149149
Your ThinLinc desktop is locked after being idle for a while, and it asks for a password to refresh it. It means the "screensaver" and "lock screen" functions are turned on, but you want to disable these functions.
150150

151-
#### Solution
151+
**Solution**
152152

153153
If your screen is locked, close the ThinLinc client, reopen the client login popup, and select `End existing session`.
154154

155155
<p style="text-align: center;">
156-
<img src="/assets/images/userguides/thinlinc4.png" alt="ThinLinc Login Popup" width="80%">
156+
<img src="/assets/images/userguides/thinlinc4.png" alt="ThinLinc Login Popup" width="80%">
157157
</p>
158158

159159
Select "End existing session" and try "Connect" again.
160160

161161
To permanently avoid screen lock issue, right click desktop and select `Applications`, then `settings`, and select `Screensaver`.
162162

163163
<p style="text-align: center;">
164-
<img src="/assets/images/userguides/thinlinc5.png" alt="ThinLinc Screensaver" width="80%">
164+
<img src="/assets/images/userguides/thinlinc5.png" alt="ThinLinc Screensaver" width="80%">
165165
</p>
166166

167167
Select "Applications", then "settings", and select "Screensaver".
168168

169169
Under **Screensaver**, turn off the `Enable Screensaver`, then under **Lock Screen**, turn off the `Enable Lock Screen`, and close the window.
170170

171171
<p style="text-align: center;">
172-
<img src="/assets/images/userguides/thinlinc6.png" alt="ThinLinc Disable Screensaver" width="80%">
172+
<img src="/assets/images/userguides/thinlinc6.png" alt="ThinLinc Disable Screensaver" width="80%">
173173
</p>
174174

175175
Under "Screensaver" tab, turn off the "Enable Screensaver" option.
176176

177177
<p style="text-align: center;">
178-
<img src="/assets/images/userguides/thinlinc7.png" alt="ThinLinc Disable Lock Screen" width="80%">
178+
<img src="/assets/images/userguides/thinlinc7.png" alt="ThinLinc Disable Lock Screen" width="80%">
179179
</p>
180180

181181
Under "Lock Screen" tab, turn off the "Enable Lock Screen" option.
182182

183183
### I worked on Negishi after I graduated/left Purdue, but can not access it anymore
184184

185-
#### Problem
185+
**Problem**
186186

187187
You have graduated or left Purdue but continue collaboration with your Purdue colleagues. You find that your access to Purdue resources has suddenly stopped and your password is no longer accepted.
188188

189-
#### Solution
189+
**Solution**
190190

191191
Access to all resources depends on having a valid Purdue Career Account. Expired Career Accounts are removed twice a year, during Spring and October breaks (more details at the [official page](https://www.purdue.edu/apps/account/IAMO/Purdue_CareerAccount_Expiration.jsp)). If your Career Account was purged due to expiration, you will not be be able to access the resources.
192192

@@ -201,48 +201,47 @@ After your R4P is completed and Career Account is restored, please note two addi
201201

202202
### cannot connect to X server / cannot open display
203203

204-
#### Problem
204+
**Problem**
205205

206206
You receive the following message after entering a command to bring up a graphical window
207207

208208
`cannot connect to X server` `cannot open display`
209209

210-
#### Solution
210+
**Solution**
211211

212212
This can happen due to multiple reasons:
213213

214214
1. Reason: Your SSH client software does not support graphical display by itself (e.g. SecureCRT or PuTTY).
215-
* Solution: Try using a client software like ThinLinc or MobaXterm as described in the [SSH X11 Forwarding guide](accounts.md#ssh-x11-forwarding).
216-
2. Reason: You did not enable X11 forwarding in your SSH connection.
217-
218-
* Solution: If you are in a Windows environment, make sure that X11 forwarding is enabled in your connection settings (e.g. in MobaXterm or PuTTY). If you are in a Linux environment, try
215+
* Solution: Try using a client software like ThinLinc or MobaXterm as described in the [SSH X11 Forwarding guide](accounts.md#ssh-x11-forwarding).
219216

220-
`ssh -Y -l username hostname`
217+
2. Reason: You did not enable X11 forwarding in your SSH connection.
218+
* Solution: If you are in a Windows environment, make sure that X11 forwarding is enabled in your connection settings (e.g. in MobaXterm or PuTTY). If you are in a Linux environment, try `ssh -Y -l username hostname`
221219

222220
3. Reason: If you are trying to open a graphical window within an interactive PBS job, make sure you are using the `-X` option with `qsub` after following the previous step(s) for connecting to the front-end. Please see the example in the [Interactive Jobs guide](../run_jobs/interactive_jobs).
221+
223222
4. Reason: If none of the above apply, make sure that you are [within quota of your home directory](#usrbinxauth-error-in-locking-authority-file).
224223

225224
### bash: command not found
226225

227-
#### Problem
226+
**Problem**
228227

229228
You receive the following message after typing a command
230229

231230
`bash: command not found`
232231

233-
#### Solution
232+
**Solution**
234233

235234
This means the system doesn't know how to find your command. Typically, you need to load a module to do it.
236235

237236
### bash: module command not found
238237

239-
#### Problem
238+
**Problem**
240239

241240
You receive the following message after typing a command, e.g. module load intel
242241

243242
`bash: module command not found`
244243

245-
#### Solution
244+
**Solution**
246245

247246
The system cannot find the module command. You need to source the modules.sh file as below
248247

@@ -264,15 +263,15 @@ or
264263

265264
* You can learn about processor layout on Negishi nodes using the following command:
266265

267-
```
268-
a003.negishi:~$ lstopo-no-graphics
269-
```
266+
```
267+
a003.negishi:~$ lstopo-no-graphics
268+
```
270269
271270
* For detailed IO connectivity:
272271
273-
```
274-
a003.negishi:~$ lstopo-no-graphics --physical --whole-io
275-
```
272+
```
273+
a003.negishi:~$ lstopo-no-graphics --physical --whole-io
274+
```
276275
277276
* Please note that NUMA information is useful for advanced MPI/OpenMP/GPU optimizations. For most users, using default NUMA settings in MPI or OpenMP would give you the best performance.
278277

docs/userguides/negishi/index.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,17 @@ search:
1010

1111
# Negishi User Guide
1212

13+
<div class="quick-launcher">
14+
<div class="quick-launcher-card">
15+
<span class="launcher-title">Gateway (Open OnDemand)</span>
16+
<a href="https://gateway.negishi.rcac.purdue.edu/" class="launcher-btn" target="_blank" rel="noopener">Launch</a>
17+
</div>
18+
<div class="quick-launcher-card">
19+
<span class="launcher-title">Remote Desktop (ThinLinc)</span>
20+
<a href="https://desktop.negishi.rcac.purdue.edu/" class="launcher-btn" target="_blank" rel="noopener">Launch</a>
21+
</div>
22+
</div>
23+
1324
Negishi is a Community Cluster optimized for communities running traditional, tightly-coupled science and engineering applications.
1425

1526
- [**Negishi Overview**](overview.md)

0 commit comments

Comments
 (0)