Jeremy Stanley 350b6939a6 Clean up Static Web Hosting document

* doc/source/static.rst: Correctly indent a few preformatted command
example blocks, add a couple internal hyperlinks and clean up some
trailing whitespace on a number of lines.

Change-Id: I57980c21ac2eb08dafb05a4dc669992952b7465f

2013-08-23 16:36:32 +00:00

2.5 KiB

Raw Blame History

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

http://apache.org/

Bugs

http://bugs.launchpad.net/openstack-ci

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