From f424bda9c54f2572c3c6e3bcdf9d544c4068801e Mon Sep 17 00:00:00 2001 From: Bryan Roessler Date: Wed, 23 Jul 2025 21:34:29 -0400 Subject: [PATCH] Tighten up docs --- README.md | 28 +++++++++++++++++----------- docs/README.md | 16 ++++++++++++---- 2 files changed, 29 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index b707020c..c416e777 100644 --- a/README.md +++ b/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) -3. You will be prompted to create a new password and automatically logged out -4. Login again using new password: `ssh username@hartmanlab.genetics.uab.edu` -5. Change `samba` password (default password is also your *username*): `smbpasswd` -6. To change your password again in the future: `passwd` -7. *Optional*: Generate a public-private keypair on your client and copy it to the server for faster and more secure logins. +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 then logged out +4. Login again using your new password: `ssh username@hartmanlab.genetics.uab.edu` +5. Change the default `samba` password (default password is also your *username*): `smbpasswd` +6. *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 @@ -111,11 +110,18 @@ 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` + ## Resources * [RHEL documentation](https://access.redhat.com/documentation/en/red-hat-enterprise-linux/) @@ -126,12 +132,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 -* 96GB RAM -* 4TB PCIE3 NVMe SSD: `/`, `/home` +* Intel Xeon X99 E5-2650v4 12-core CPU +* 96GB DDR4 RAM +* 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). diff --git a/docs/README.md b/docs/README.md index fad7b382..c416cc82 100644 --- a/docs/README.md +++ b/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 ` - * If not provided, defaults to `*-*-* 01:30:00` (1:30 AM). + * If `` 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 ` * 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`