Update manual location in motd

README.md

@@ -3,12 +3,11 @@
 ## First-time login
 
 1. Ensure an admin has enabled your user account and provided a username.
-2. Login via [`ssh`](#clients): `ssh username@hartmanlab.genetics.uab.edu` (the default password is your username)
+2. Login via [`ssh`](#ssh): `ssh username@hartmanlab.genetics.uab.edu` (default password is your *username*)
-3. You will be prompted to create a new password and automatically logged out
+3. You will be prompted to create a new password and then logged out
-4. Login again using new password: `ssh username@hartmanlab.genetics.uab.edu`
+4. Login again using your new password: `ssh username@hartmanlab.genetics.uab.edu`
-5. Change `samba` password (default password is also your *username*): `smbpasswd`
+5. Change the default `samba` password (default password is also your *username*): `smbpasswd`
-6. To change your password again in the future: `passwd`
+6. *Optional*: Generate a public-private keypair on your client and copy it to the server for faster and more secure logins.
-7. *Optional*: Generate a public-private keypair on your client and copy it to the server for faster and more secure logins.
 
     ```bash
     ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa_4096
@@ -31,7 +30,7 @@ Connect to the server remotely using the command line.
 
 ### X forwarding
 
-Launch graphical server programs locally on a client that run on the server.
+Launch graphical server programs locally on a client that execute on the server.
 
 * Linux/OSX
   * Enable X forwarding during ssh login: `ssh -X username@hartmanlab.genetics.uab.edu`
@@ -67,7 +66,7 @@ Users can access an X2Go remote desktop session using `x2goclient` from a client
 
 X2Go sessions can be paused or suspended from the X2Go client window. Multiple sessions can be created on the client, making it possible to select alternate quality settings based on location and bandwidth.
 
-**Note:** Some programs do not continue to run at full speed when an X2Go session is paused. In these cases, the program should be run via `ssh` in a [`tmux`](https://en.wikipedia.org/wiki/Tmux) or [`screen`](https://www.gnu.org/software/screen/) session.
+![x2go_server](docs/imgs/x2go_server.png)
 
 * Session tab
   * Session name: Hartman Lab Server
@@ -75,7 +74,6 @@ X2Go sessions can be paused or suspended from the X2Go client window. Multiple s
   * Login: *`username`*
   * SSH port: `22`
   * Session type: **MATE** (MATE provides the best experience with X2Go)
-    ![x2go_server](docs/imgs/x2go_server.png)
 * Connection tab
   * Set the connection speed to LAN when connecting from within the UAB network and WAN when outside of the UAB network
   * Compression settings should be left unchanged or set to *adaptive*.
@@ -87,9 +85,10 @@ X2Go sessions can be paused or suspended from the X2Go client window. Multiple s
 * Shared folders tab
   * Select folders on the client to be shared with the server during a session. Browse to the chosen folder, add it to the share, and select *automount*.
   * These folders will then appear on the server under `/media/disk/<share_name>`.
-  * Shared folder permissions can be modified by admin for multi-user access.
     ![x2go_server](docs/imgs/x2go_automount.png)
 
+**Note:** Some programs do not continue to run at full speed when an X2Go session is paused. In these cases, the program should be run via `ssh` in a [`tmux`](https://en.wikipedia.org/wiki/Tmux) or [`screen`](https://www.gnu.org/software/screen/) session.
+
 ## Robot computer remote desktop access
 
 In an X2Go session, go to *Applications>Internet>Remote Viewer>Connection>New* and enter `vnc://192.168.16.101:5900`
@@ -111,11 +110,19 @@ In an X2Go session, go to *Applications>Internet>Remote Viewer>Connection>New* a
 
 ## Data backup
 
-[`rsync`](https://linux.die.net/man/1/rsync) is recommended for users that would just like to periodically backup their $HOME directory to a local machine.
+[`rsync`](https://linux.die.net/man/1/rsync) is recommended for periodically backing up user files to a local client.
 
 * Copy a user's `$HOME`' directory locally to `/home-backup`: `rsync -azH --delete username@hartmanlab.genetics.uab.edu:/home/username/ home-backup/`
 * Copy a shared directory locally `rsync -azh username@hartmanlab.genetics.uab.edu:/mnt/data/scans/20250723_roessler_project .`
 
+## Troubleshooting
+
+* Reset your X2Go sessions: `script-user-reset-x2go`
+* Reset your X2Go desktop: `script-user-reset-desktop`
+* Change your user login password: `passwd`
+* Change your samba password: `smbpasswd`
+* Read the `motd` for service statuses and updates: `cat /etc/motd`
+
 ## Resources
 
 * [RHEL documentation](https://access.redhat.com/documentation/en/red-hat-enterprise-linux/)
@@ -126,12 +133,12 @@ In an X2Go session, go to *Applications>Internet>Remote Viewer>Connection>New* a
 ## Platform
 
 * AlmaLinux 9.6 w/ Linux 6.1 LTS Hyperscale SIG kernel
-* Intel Xeon X99 E5-2650v4 CPU
+* Intel Xeon X99 E5-2650v4 12-core CPU
-* 96GB RAM
+* 96GB DDR4 RAM
-* 4TB PCIE3 NVMe SSD: `/`, `/home`
+* 4TB PCIe 3.0 NVMe SSD: `/`, `/home`
 * 20TB btrfs raid1 array: `/mnt/data`
 * 20TB btrfs raid1 backup array: `/mnt/backup`
 
 ## Administrators
 
-See additional documentation in [`docs/README.md`](docs/README.md)
+See additional documentation in [`docs/README.md`](docs/README.md).

docs/README.md

@@ -19,12 +19,15 @@ Type `sudo script-` and use tab completion to access the following helper progra
   * Reset permissions on `/mnt/data` if no path is provided.
   * Use as a last resort to reset original permissions for shared data.
 * `sudo script-system-scheduled-restart <OnCalendar>`
-  * If not provided, defaults to `*-*-* 01:30:00` (1:30 AM).
+  * If `<OnCalendar>` not provided, defaults to `*-*-* 01:30:00` (1:30 AM).
   * See [Calendar Events](https://www.freedesktop.org/software/systemd/man/systemd.time.html) for formatting.
   * Alerts users via `notify-send` (X2Go), `wall` (SSH), and adds a reminder to the MOTD.
 * `sudo script-user-reset-desktop <username>`
   * Reset a user’s desktop (MATE configuration) to default.
   * Can also be run in user mode (without `sudo`) for personal accounts.
+* `sudo script-system-update`
+  * Update the server using the system package manager.
+  * Best to run prior to scheduled reboot.
 
 ## Cockpit Server Administration
 
@@ -32,9 +35,9 @@ Graphical system settings tool for monitoring and performing common tasks.
 
 In an X2Go session, via a web browser at [`http://localhost:9090`](http://localhost:9090)
 
-## Deploying `stow` server configuration packages
+## Deploying `stow` server packages
 
-Server scripts and configs are organized using [GNU Stow](https://www.gnu.org/software/stow/manual/stow.html) packages and can be deployed directly from this directory.
+Server scripts and configs are organized using [GNU Stow](https://www.gnu.org/software/stow/manual/stow.html) packages and can be deployed from [the root directory](../).
 
 * Deploy system-wide MATE layout and themes: `sudo stow --adopt -R -t / theme`
 * Deploy system-wide scripts: `sudo stow --adopt -R -t / scripts`
@@ -68,7 +71,7 @@ Login via `ssh` or `cat /etc/motd` to view current service statuses.
 
 * Add the UAB DNS servers (`138.26.5.2`, `138.26.5.66`) to the Windows network config to access UAB resources.
 
-#### Allow Access to Samba Share (Windows Bug Workaround)
+#### Enable Access to Samba Share (Windows Bug Workaround)
 
 1. Open `C:\Windows\system32\drivers\etc\hosts` and copy its contents.
 2. Paste into a new text document and add the appropriate `blazerid` and server IP lines.
@@ -87,3 +90,8 @@ Login via `ssh` or `cat /etc/motd` to view current service statuses.
 * Add 20 GB to the Windows VM: `sudo qemu-img resize /var/lib/libvirt/images/win11-5900.qcow2 +20G`
 * Add GParted ISO as boot device and expand the working partition.
 
+## Fixing no local display
+
+Periodically the GPU hardware resets and crashes the local display manager.
+
+To fix, login via ssh and run: `sudo systemctl restart lightdm`