View Source

Please Note:

This is a Suggestion on how to increase Disk Space in your eDMS OVA with the Help of LVM (Logical Volume Manager)

This is NOT an official recommendation and not an official part of eDMS.

use this at your own Risk!

Seriously: if you are unfamiliar with Linux System Administration and / or LVM, do NOT attempt this!

You could destroy your data easily!

This being said, there are a number of huge advantages to extend your Diskspace via LVM over other means (e.G. you do not have to split up your storage voer several logical mountpoints) and this has proven to be reliable, scalable and fast.

Should you have the need for increasing your Diskspace and are not feeling comfortable with this procedure, please feel free to contact Patrix, Serviva or Pace-Ip for assistance.

Add Harddisk Space in your Hypervisor Environment

Regardless of your Usage of VMWare, Xen, Hyper V or other, when you intend to grow the Diskspace of the eDMS OVA, it is neccesary to assign Diskspace to your VM

Please refer to the Manual of your Virtualization Platform for this.

The Standard Size while deploying the OVA is 100 GB. This will naturally not suffice anymore after a while of adding Documents, Versions Previews etc.

We cannot give a general Recommendation as to how large your extension should become, but please contact us if this is unclear in your specific Situation.

Make Disk visible to the OVA

SSH into the CentOS OVA and sudo to root (unless you are already root)
sudo su -

List the block device to see the newly assigned vSphere hard disk.

lsblk

DMS Documentation > Extend Disk Space in the OVA with LVM > image2020-2-7_13-47-46.png

If you do not see the vSphere hard disk, force a rescan

for host in $(ls -1d /sys/class/scsi_host/*); do echo "- - -" > ${host}/scan ; done
for device in $(ls -1d /sys/class/scsi_disk/*); do echo "1" > ${device}/device/rescan ; done

create a new Partition that is compatible to LVM

Format the disk partition. Get the device name from the previous lsblk output

fdisk /dev/sdb
n (new partition)
p (primary)
(Press ENTER) (Use default partition number)
(Press ENTER) (Use default first sector)
(Press ENTER) (Use default last sector)

t (change the partition type)
8e (Linux LVM)

w (write)

Create the Physical Volume for LVM

and check afterwards with pvs
DMS Documentation > Extend Disk Space in the OVA with LVM > image2020-2-7_14-5-52.png

Extend the Volumegroup (vg).

first check for the group with "vgs" then "vgextend centos" then check again:
DMS Documentation > Extend Disk Space in the OVA with LVM > image2020-2-7_14-9-56.png

now extend the Logival Volume (lv)

first check for the Volume with "vgs" then "lvextend" then check again:
DMS Documentation > Extend Disk Space in the OVA with LVM > image2020-2-7_14-41-46.png

resize filesystem

now in order to actually use the additional space we need to resize the filesystem.
first check the existing file system
DMS Documentation > Extend Disk Space in the OVA with LVM > image2020-2-7_14-46-16.png
then actually resize the file system

and check again:

Voila!

In essence

Increase Diskspace (physically or on the Hypervisor Layer)
Reboot or rescan for disks
create a new Partition that is compatible to LVM
re-read Partition table either via reboot or command "partprobe"
Initialise a new PV with pvcreate
Increase the VG with vgextend
Increase the LV with lvextend
Increase the Filesystem with resize2fs