Skip to content

Commit

Permalink
Updated troubleshooting
Browse files Browse the repository at this point in the history
  • Loading branch information
royfrancis committed Nov 9, 2023
1 parent 6c89cee commit 6168585
Showing 1 changed file with 32 additions and 27 deletions.
59 changes: 32 additions & 27 deletions admin.qmd → troubleshooting.qmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: "Admin resources"
title: "Troubleshooting"
description: "Utility commands/scripts, troubleshooting, tips and suggestions."
date: ""
toc: false
number-sections: false
Expand All @@ -21,15 +22,11 @@ upres5 <- y$uppmax_res_5
rm(y)
```

::: {.alert .alert-primary}
Useful utility commands/scripts and troubleshooting for course managers.
:::

# Status
## Status

Useful commands for monitoring status and user activity on UPPMAX.

## List jobs
### List jobs

List all jobs running an a project

Expand All @@ -53,7 +50,7 @@ Sample output
23185119 core (null) wingf R 2:53:40 1 r479
```

## Jobs per user
### Jobs per user

Sorted list of jobs per user

Expand All @@ -79,7 +76,7 @@ Sample output
```

## Core usage
### Core usage

Total number of cores used on a project

Expand All @@ -89,7 +86,7 @@ Total number of cores used on a project
cat(paste0("squeue -A ",upid," -o %C | awk '{total += $0} END{print total}'"))
```

## Space usage
### Space usage

Amount of storage space used per project

Expand All @@ -107,7 +104,7 @@ Your project Your File Area Unit Usage Quota Limit Over Quot
snic2022-22-123 /proj/snic2022-22-123 GBytes 4.6 128
```

## Reservation use
### Reservation use

List users by reservation ID

Expand All @@ -134,7 +131,7 @@ Sample output
```

## User activity
### User activity

List last activity in a directory for all users

Expand All @@ -156,7 +153,7 @@ analopez 2021-11-22 14:56:16 (/proj/snic2021-22-644/nobackup/analopez
private Not available ()
```

## List reservations for a project
### List reservations for a project

```{r}
#| echo: false
Expand All @@ -175,7 +172,7 @@ ReservationName=snic2021-22-644_fri StartTime=2021-11-26T08:30:00 EndTime=2021-1
Users=(null) Accounts=snic2021-22-644 Licenses=(null) State=INACTIVE BurstBuffer=(null) Watts=n/a
```

## List project members
### List project members

```{r}
#| echo: false
Expand All @@ -193,19 +190,19 @@ snic2022-22-123 berka Berkay Paylar
snic2022-22-123 btleren Betül Eren Keskin
```

## User identity
### User identity

Fetch user information from username

```
finger username
```

# Troubleshooting
## Troubleshooting

## X-forwarding
### X-forwarding

### Setup
#### Setup

**Mac users**

Expand All @@ -223,41 +220,49 @@ Also use this when logging in to the compute node!

In MobaXTerm, go to settings and make sure that X-forwarding is checked.

### Testing X-forwarding
#### Testing X-forwarding

Type `xeyes` in the terminal.

### Open .html documents on Rackham

First ensure X-forwarding works, then run `firefox --no-remote filename.html`

## Data transfer
### Data transfer

### SCP fails with *
#### SCP fails with *

Sometimes students have problems to download files with SCP when there is a `*` in the end of the line. For example; `scp [email protected]:/proj/bla/HG00097.bam* .`. It needs to be changed to `scp [email protected]:/proj/bla/HG00097.bam\* .`.

## Thinlinc
### Thinlinc

### Login
#### Login

When logging in through an installed client, **username/password** seems to work. When logging in through the browser, **username/password+2FA** may be required.

### Minimize the ThinLinc window
#### Minimize the ThinLinc window

On a Mac, press <kbd>Fn+F8</kbd>, then select: Minimize window.

### Gedit opening issues
#### Gedit opening issues

When opening it from the terminal (`gedit &`), it was not able to connect to a display to show the graphics. The `DISPLAY` variable was empty. This was when using ThinLinc, so it should have worked. The issue was solved by opening gedit from the menu. Gedit could be labelled Text Editor.

## Set persistent home directory in MobaXTerm
### Set persistent home directory in MobaXTerm

This is to specify where the **home directory** in MobaXTerm is located in the computer’s file system. In **Settings > Configuration**, set the persistent home directory to a suitable folder. Restart MobaXTerm.


## Typing `$` on a Swedish keyboard
### Typing `$` on a Swedish keyboard

Press <kbd>AltGr+4</kbd>.

### Transparent or black background for XQuartz windows on M1 Mac

As documented [here](https://github.com/XQuartz/XQuartz/issues/31), run:

```
defaults write org.xquartz.X11 enable_render_extension 0
```

***

0 comments on commit 6168585

Please sign in to comment.