> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# ggRock Expand your root logical volume

---

# 🔧 Expanding the Root Logical Volume on ggRock

Some users configure their ggRock Server with a small root LVM (e.g., 16GB or less). This can lead to issues if logs grow rapidly—often triggered by the ggRock array approaching capacity. Expanding your root LVM gives you extra headroom to troubleshoot before system performance is affected.

---

## 🧭 Step 1 – Check Current Filesystem Usage

Run the following command to verify the size and usage of your root LVM:

```
df -h /
```

Example output:

```
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/ggrock--vg-root 15G 3.7G 11G 27% /
```

In this case:

* Path: `/dev/mapper/ggrock--vg-root`
* Current size: `15G`
* Utilization: `27%`

---

## 📊 Step 2 – Check Available Space in Volume Group

Run the following to check how much space is available in the volume group:

```
vgdisplay ggrock-vg
```

Look for the line:

```
Free PE / Size 52434 / 204.82 GiB
```

This indicates ~200GB of free space is available for expansion.

---

## ➕ Step 3 – Expand the Root LVM

Use the `lvextend` command to grow your root volume. In this example, we’re adding 2GB:

```
lvextend -L +2G /dev/mapper/ggrock--vg-root -r
```

Explanation:

* `+2G`: Increase by 2GB (you can use `M` for megabytes)
* `-r`: Automatically resizes the filesystem

Sample output:

```
Size of logical volume ggrock-vg/root changed from <14.90 GiB to <16.90 GiB.
Filesystem at /dev/mapper/ggrock--vg-root is now 4429824 (4k) blocks long.
```

---

## ✅ Step 4 – Confirm the New Size

Re-run the original usage check:

```
df -h /
```

Expected output:

```
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/ggrock--vg-root 17G 3.7G 12G 24% /
```

The `Size` column now reflects the successful increase.

---

Let me know if you want this formatted for Confluence markdown or need it turned into a PDF/handout!