How to expand the Messaging Gateway disk on virtual infrastructure

Products

• Messaging Gateway

Issue/Introduction

In some situations it may be neccessary to increase the amount of disk space allocated to a Messaging Gateway virtual machine to accomodate increased log or quarantine storage requirements. Prior to SMG 10.8.0 it was not possible to expand the SMG filesystem even though the underlying virtual disk had been expanded. This has been addressed with the 10.8.0 and later releases.

Environment

Release : 10.8.0

Resolution

To expand the disk space availe able to SMG for virtual machines under VMWare, Hyper-V, and Linux KVM:

1. Shut down the Messaging Gateway virtual machine
2. Take a snapshot of the existing SMG VM (optional but highly recommended)
3. Expand the underlying virtual disk via the standard method for your particular virtual infrastructure / hypervisor. Please see your virtual infrastructure documentation for details on how to expand the virtual disk.
4. Start the Messaging Gateway virtual machine. The system will not show the newly available disk space as available.
5. Log into the SMG command line interface as `admin`
6. Run the `grow-disk` command. This will expand the /data filesystem on SMG to take advantage of the newly available disk space and restart the SMG system.

Additional Information

grow-disk

usage: grow-disk [ --resize | --status ]

options:
    -r, --resize
        Just perform the final resize of the filesystem
        Will perform a reboot
    -s, --status
        Show the characteristics of the physical disk and partitions,
        but make no changes

    If no option is provided, the system will be rebooted, and the disk
    partition table will be modified to increase the size of the /data
    partition to the maximum space available.