system-config/doc/source/static.rst
James E. Blair ca68f6e03c Document volume maintenance on static
Change-Id: Ia42cd5d5d0e942d627f7d457c75142076fcbdfa9
2013-07-17 15:31:32 -07:00

2.5 KiB

title

Static Web Hosting

Static Web Hosting

Several virtual hosts serve static data from an Apache server on static.openstack.org.

At a Glance

Hosts
Puppet
  • modules/openstack_project/manifests/static.pp
Projects
Bugs

Overview

Each apache vhost has a section in the puppet manifest for the static host. Some of the vhosts hold large amounts of data; Cinder volumes and LVM are used to manage those.

Adding a New Device

If the main volume group doesn't have enough space for what you want to do, this is how you can add a new volume.

Log into ci-puppetmaster.openstack.org, su to root and run:

. ~/cinder-venv/bin/activate
. ~/ci-launch/cinder.sh

nova list
cinder list
  • Add a new cinder volume (substitute the next number in series for NN):

    cinder create --display-name "static.openstack.org/mainNN" 512 nova volume-attach <server id> <volume id> auto

  • On static.openstack.org, create the partition table:

    DEVICE=/dev/xvdX parted $DEVICE mklabel msdos mkpart primary 0% 100% set 1 lvm on pvcreate ${DEVICE}1

  • It should show up in pvs:

    root@static:/etc/lvm# pvs

    PV VG Fmt Attr PSize PFree /dev/xvdX1 lvm2 a- 512.00g 512.00g

  • Add it to the main volume group:

    vgextend main ${DEVICE}1

Creating a New Logical Volume

Make sure there is enough space in the volume group:

root@static:~# vgs
  VG   #PV #LV #SN Attr   VSize VFree  
  main   4   2   0 wz--n- 2.00t 347.98g

If not, see "Adding a New Device".

Create the new logical volume and initialize the filesystem:

NAME=newvolumename
/sbin/lvcreate -L1500GB -n $NAME main

mkfs.ext4 -m 0 -j -L $NAME /dev/main/$NAME
tune2fs -i 0 -c 0 /dev/main/$NAME

Be sure to add it to /etc/fstab.

Expanding an Existing Logical Volume

Make sure there is enough space in the volume group:

root@static:~# vgs
  VG   #PV #LV #SN Attr   VSize VFree  
  main   4   2   0 wz--n- 2.00t 347.98g

If not, see "Adding a New Device".

The following example to increase the size of a volume by 100G is untested; please confirm:

NAME=volumename
lvextend -L+100G /dev/main/$NAME
resize2fs /dev/main/$NAME