jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-19 18:10:59 -05:00
Code Issues Projects Releases Wiki Activity

Enhance instructions for increasing storage capacity (#57819)

Browse Source 
Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com>
This commit is contained in:
Brice
2025-11-06 07:56:38 -08:00
committed by GitHub
parent 47c3692b92
commit 7f56ca85d6
1 changed files with 44 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity.md
View File

@@ -54,6 +54,50 @@ Root storage refers to the total size of your instance's root disk. The availabl
1. Ensure system services are functioning correctly, then release maintenance mode. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode).
> [!WARNING]
> If the `ghe-storage-extend` command (or a prior automatic check) reports: `ghe_user_data contains a file system with errors`, you must repair the filesystem before retrying the resize. Do not rerun `ghe-storage-extend` until the check completes cleanly. For recovery instructions, see [Repairing filesystem errors](#repairing-filesystem-errors).
### Repairing filesystem errors
If the filesystem check fails during `ghe-storage-extend`, follow these steps to repair it.
Ensure the appliance is in maintenance mode and no background jobs are running:
```shell copy
ghe-maintenance -s
ghe-resque-info
```
1. Stop and activate the user volume, then run a forced filesystem check (auto‑answer yes):
```shell copy
sudo systemctl stop ghe-user-disk
VGNAME=$(sudo lvs --noheadings -o vg_name | grep ghe_storage_ | awk '{ print $1 }')
sudo vgchange -ay "$VGNAME"
sudo vgscan --mknodes
sudo fsck -fy /dev/mapper/${VGNAME}-ghe_user_data
```
1. Retry the resize:
```shell copy
ghe-storage-extend
```
1. Remount and verify new size:
```shell copy
sudo systemctl start ghe-user-disk
df -h /data/user
```
1. Reboot and verify:
```shell copy
sudo reboot
df -h /data/user
```
## Increasing the root partition size using a new appliance
1. Set up a new {% data variables.product.prodname_ghe_server %} instance with a larger root disk using the same version as your current appliance. For more information, see [AUTOTITLE](/admin/installation/setting-up-a-github-enterprise-server-instance).