Files
ultix/GROW-ROOT-RUNBOOK.md
T
mrcharles cba2a64d67 ultix perf/ops workbench: complete 2026-08-31 optimization pass for VM 5111
Everything for the ultix-streaming (VM 5111, pfv-tsys5) performance pass:
full report + host audit results, staged/gated configs, guest prep + host
one-shot + post-reboot-fix + netcheck lifecycle scripts, grow-root manual
runbook, rolling tracking HUD, questions v1, and the gateway boot-race
hardening units. Applied and verified live 2026-08-31; open work is
tracked in Redmine project 55 as #601-#607. [#602]

💘 Generated with Crush

Assisted-by: Crush:glm-5.2
2026-08-31 16:46:13 -05:00

96 lines
3.4 KiB
Markdown

# Manual runbook: grow / from 279G to ~505G (VM 5111, ultix-streaming)
YOU run every command, one at a time, checking the output before the next.
Nothing here is automated, scheduled, or boot-triggered. Storage ops are the
only steps in this whole effort that no script touches.
## Layout change
```
before: sda1 root 279.2G | sda2 extended [ sda5 swap 8.8G ] | ~150G unallocated
after: sda1 root ~505G | sda2 swap ~13G (new, at the tail)
```
MBR stays MBR, ext4 grows online, VM stays up the whole time. You can safely
stop after any step; the system runs fine at any intermediate size. Takes
about 10 minutes end to end.
## Step 0 — preconditions
```
command -v growpart || sudo apt-get install -y cloud-guest-utils
df -h / /data1 /data2 # know your starting point
lsblk /dev/sda
```
## Step 1 — backups (30 seconds, do not skip)
```
sudo sfdisk --dump /dev/sda | sudo tee /root/sda.sfdisk.bak.$(date +%F)
sudo cp /etc/fstab /root/fstab.bak.$(date +%F)
```
Check: `head /root/sda.sfdisk.bak.*` lists sda1, sda2, sda5.
## Step 2 — grow the virtual disk at the host (hot, VM stays up)
```
ssh root@pfv-tsys5.knel.net 'qm config 5111 | grep scsi0' # eyeball the target
ssh root@pfv-tsys5.knel.net 'qm resize 5111 scsi0 +80G'
```
Check in guest: `lsblk /dev/sda` shows sda = 518G, sda1 still 279.2G.
## Step 3 — retire the old swap
```
free -h # swap "used" must be ~0
sudo swapoff /dev/sda5
OLDUUID=$(sudo blkid -s UUID -o value /dev/sda5); echo "OLDUUID=$OLDUUID"
cat /proc/swaps # check: empty
```
## Step 4 — remove the extended partition (the strip between root and free space)
```
sudo sfdisk --delete /dev/sda 2
sudo partprobe /dev/sda
lsblk /dev/sda
```
Check: only sda1 remains. If sda1 is missing: STOP, do not reboot, do not
write anything; restore the table:
`sudo sfdisk /dev/sda < /root/sda.sfdisk.bak.<date>`
## Step 5 — grow partition 1 into the free space
```
sudo growpart /dev/sda 1
# parted alternative: sudo parted /dev/sda resizepart 1 100%
lsblk /dev/sda # sda1 now ~505G
```
## Step 6 — grow the filesystem (online)
```
sudo resize2fs /dev/sda1
df -h / # ~500G available
```
## Step 7 — new swap at the tail
```
sudo parted -s /dev/sda mkpart primary linux-swap 505GB 100%
sudo partprobe /dev/sda
lsblk /dev/sda
NEWSWAP=$(lsblk -no NAME,TYPE /dev/sda | awk '$2=="part"{print $1}' | tail -1); echo "NEWSWAP=$NEWSWAP"
sudo mkswap /dev/$NEWSWAP
NEWUUID=$(sudo blkid -s UUID -o value /dev/$NEWSWAP); echo "NEWUUID=$NEWUUID"
```
## Step 8 — swap fstab line, activate
```
sudo sed -i "s/^UUID=$OLDUUID/#UUID=$OLDUUID retired-sda5 $(date +%F)/" /etc/fstab
echo "UUID=$NEWUUID none swap sw 0 0" | sudo tee -a /etc/fstab
sudo swapon -a
cat /proc/swaps # new swap active
sudo fstrim -v / # optional: reclaim (discard is on now)
```
## Rollback map
- Anytime before step 4: nothing changed except two backup files.
- After partition edits, before resize2fs: restore table from the sfdisk dump
(step 4 note); no data has moved, only the table.
- After resize2fs: growth is one-way by design; reverting size means restore
from backups, so this is the one step to do when calm. (It is also the
safest operation in the list: online ext4 grow is journaled.)
- fstab: backups in /root; only the swap line changes, and a bad swap line is
non-fatal at boot (root entry is untouched).