From ca68f6e03cfef2f67771c7ad6b26126cc75b2615 Mon Sep 17 00:00:00 2001
From: "James E. Blair" <jeblair@openstack.org>
Date: Wed, 17 Jul 2013 15:31:32 -0700
Subject: [PATCH] Document volume maintenance on static

Change-Id: Ia42cd5d5d0e942d627f7d457c75142076fcbdfa9
---
 doc/source/static.rst  | 106 +++++++++++++++++++++++++++++++++++++++++
 doc/source/systems.rst |   1 +
 2 files changed, 107 insertions(+)
 create mode 100644 doc/source/static.rst

diff --git a/doc/source/static.rst b/doc/source/static.rst
new file mode 100644
index 0000000000..894e7918a6
--- /dev/null
+++ b/doc/source/static.rst
@@ -0,0 +1,106 @@
+:title: Static Web Hosting
+
+.. _static:
+
+Static Web Hosting
+##################
+
+Several virtual hosts serve static data from an Apache server on
+static.openstack.org.
+
+At a Glance
+===========
+
+:Hosts:
+  * http://logs.openstack.org
+  * http://docs-draft.openstack.org
+  * http://status.openstack.org
+  * http://pypi.openstack.org
+:Puppet:
+  * :file:`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
+====================================
+
+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
diff --git a/doc/source/systems.rst b/doc/source/systems.rst
index ad87e8c732..56fce1ff37 100644
--- a/doc/source/systems.rst
+++ b/doc/source/systems.rst
@@ -18,5 +18,6 @@ Major Systems
    paste
    planet
    puppet
+   static
    lists
    wiki