summaryrefslogtreecommitdiff
path: root/disk-expand/README.md
diff options
context:
space:
mode:
authorZach Marano <zmarano@google.com>2016-03-11 13:08:48 -0800
committerZach Marano <zmarano@google.com>2016-03-11 13:08:48 -0800
commit080c4cf6230c80e1cc2bc92eff8cbcaab448aa9a (patch)
tree2028c8c8f43baed9bc016381b1642f261e6cc013 /disk-expand/README.md
parentdfeb1ceba49bc660ab9f5a813c1eec8618a755f2 (diff)
parent43dbebf973364f0933c7e3ddc862e86b60451f8b (diff)
downloadgoogle-compute-image-packages-080c4cf6230c80e1cc2bc92eff8cbcaab448aa9a.tar.gz
Merge pull request #211 from zmarano/upstream
Add package for EL7 disk expand.
Diffstat (limited to 'disk-expand/README.md')
-rw-r--r--disk-expand/README.md24
1 files changed, 11 insertions, 13 deletions
diff --git a/disk-expand/README.md b/disk-expand/README.md
index 51b14c6..d93917d 100644
--- a/disk-expand/README.md
+++ b/disk-expand/README.md
@@ -4,23 +4,19 @@ This package is intended to expand the root partition up to 2TB on a GCE VM. It
consists of several scripts from other packages that for various reasons are not
maintained by the distros; cloud-utils-growpart, dracut-modules-growroot, and an
upstream version of the growpart script. See below for details. This package is
-being provided on an experimental basis for GCE CentOS and RHEL 6 images only.
+being provided on an experimental basis for GCE CentOS and RHEL images only.
### Build the package
A script to build the package is provided for convenience.
`./build_package.sh /OUTPUT_DIR` will yield an rpm and an srpm in the
-defined output directory.
+defined output directory for EL6 and EL7.
### Package usage
-1. Update to the latest packages and reboot. If there is a kernel update,
- you need to be running the new kernel for dracut to update it properly.
- Alternativley, if there is not a kernel update you can just install the
- gce-disk-expand package in the next step.
- `yum -y update ; reboot`
-1. Install the gce-disk-expand package with yum and reboot:
- `yum -y install /PATH_TO/gce-disk-expand-el6-VER-DATE.x86_64.rpm ; reboot`
+Install the gce-disk-expand package for your distro with yum and reboot:
+ CentOS/RHEL 6: `yum -y install /PATH_TO/gce-disk-expand-el6-VER-DATE.x86_64.rpm ; reboot`
+ CentOS/RHEL 7: 'yum -y install /PATH_TO/gce-disk-expand-el7-VER-DATE.x86_64.rpm ; reboot`
Your root partition will now be expanded to the full size of your disk up to
2TB.
@@ -38,15 +34,17 @@ further upstream releases of this script. It is therefore not recommended that
you try to use the [0.27 growpart package](http://rpmfind.net/linux/RPM/epel/6/x86_64/cloud-utils-growpart-0.27-10.el6.x86_64.html)
from the EPEL repo.
-#### Dracut modules
+#### Dracut module for EL6
The dracut module is taken from the [dracut-modules-growroot](http://rpmfind.net/linux/RPM/epel/6/x86_64/dracut-modules-growroot-0.20-2.el6.noarch.html)
package in the EPEL 6 repo. The dracut module allows the partition table to be
-expanded on boot before / is mounted and prevents an additional reboot.
+expanded on boot before / is mounted and prevents an additional reboot in CentOS
+and RHEL 6. CentOS and RHEL 7 support live partition resizing by the kernel and
+do not need the dracut module.
-#### The expand-root init.d script
+#### The expand-root script
-The expand-root init.d script is derived from the
+The expand-root script is derived from the
[bootstrap-vz version](https://github.com/andsens/bootstrap-vz/blob/c682dab6ec51767b6e529c1589c5630f6295953a/bootstrapvz/common/assets/init.d/expand-root)
of this script used for Debian instances. Essentially, it just calls the proper
filesystem expansion utility to live resize the filesystem on first boot. The