add backup topic for enterprise server/private chef

Author: jamescott

Makefile

@@ -2,12 +2,12 @@ BUILDDIR = build
 S3BUCKET = chef-docs
 S3OPTIONS = --delete-removed --acl-public --exclude='.doctrees/*' --exclude='chef/.doctrees/*' --config ~/.s3cfg-chef-docs  --add-header "Cache-Control: max-age=900"
 
-release: master enterprise open_source all
+release: master enterprise open_source all server 11-4 11-6
 
 # 
 # OTHER BUILDS -- REMOVED FOR THE MOMENT
 # 
-# all server 11-4 11-6
+# 
 # 
 
 clean:

docs_oec/source/index.rst

@@ -207,6 +207,7 @@ The |chef server| can be managed in the following ways:
 
 .. raw:: html
 
+   &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_backup_restore.html">Backup and Restore</a> </br>
    &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_firewalls_and_ports.html">Firewalls and Ports</a> </br>
    &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_high_availability.html">High Availability</a> </br>
    &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_ldap.html">LDAP / Active Directory</a> </br>
@@ -217,7 +218,7 @@ The |chef server| can be managed in the following ways:
    &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_services.html">Services</a> </br>
    &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_users.html">Users</a> </br>
 
-..   &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_backup_restore.html">Backup and Restore</a> </br>
+
 ..   &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_orgs.html">Organizations</a> </br>
 ..   &nbsp;&nbsp;&nbsp;   <a href="http://docs.opscode.com/enterprise/server_data.html">Server Data</a> </br>
 

docs_oec/source/server_backup_restore.rst

@@ -3,3 +3,8 @@ Backup and Restore
 =====================================================
 
 .. include:: ../../includes_server_backup_restore/includes_server_backup_restore.rst
+
+High Availability
+=====================================================
+
+.. include:: ../../includes_server_backup_restore/includes_server_backup_restore_ha.rst

docs_server/source/private_chef_1x_install_ha.rst

@@ -120,6 +120,10 @@ Configure
 -----------------------------------------------------
 .. include:: ../../includes_private_chef_1x/includes_private_chef_1x_install_ha_config_private_chef_on_frontend.rst
 
+Backups
+-----------------------------------------------------
+.. include:: ../../includes_server_backup_restore/includes_server_backup_restore_ha.rst
+
 Success!
 =====================================================
 .. include:: ../../includes_private_chef_1x/includes_private_chef_1x_install_ha_success.rst

includes_server_backup_restore/includes_server_backup_restore.rst

@@ -1,4 +1,4 @@
 .. The contents of this file are included in multiple topics.
 .. This file should not be changed in a way that hinders its ability to appear in multiple documentation sets.
 
-placeholder_text
+Periodic backups of |chef server oec| data are an essential part of managing and maintaining a healthy configuration and to help ensure that important data can be restored, if required.

includes_server_backup_restore/includes_server_backup_restore_ha.rst

@@ -0,0 +1,24 @@
+.. The contents of this file may be included in multiple topics.
+.. This file should not be changed in a way that hinders its ability to appear in multiple documentation sets.
+
+To configure backups on the backend servers in a |ha| configuration, set a |cron| job in ``/etc/cron.d/opc_snapshot`` similar to the following:
+
+.. code-block:: bash
+
+   # rendered by private-chef-ctl reconfigure, do not modify
+   # Add to /etc/cron.d/opc_snapshot, and then remove comment below MAILTO to activate the cron job
+   SHELL=/bin/bash
+   HOME=/opt/opscode/bin
+   PATH=/usr/bin:/usr/sbin:/bin:/opt/opscode/embedded/bin:/opt/opscode/bin
+   MAILTO=SOMEONE@payingattention
+   #17 23 * * * root drbd-backups -g opscode -l drbd > /dev/null 2>&1 
+
+A |cron| job similar to the previous example will mount a new snapshot logical volume named::
+
+   /dev/opscode/backup-{+%Y-%m-%d-%H-%M-%S}
+
+where ``{+%Y-%m-%d-%H-%M-%S}`` is a format string for year, month, day, so on.
+
+After the |cron| job has run successfully, the ``mount`` command will show the new logical volume mounted on the ``/var/opt/opscode/drbd-backups`` mount point. The backup script will create a snapshot logical volume in unused space in the ``/opscode`` volume group. After the snapshot is created, the backup script will attempt to mount the snapshot logical volume, after which the snapshot will stay mounted for 24 hours. Upon the next |cron| job run, the backup script will attempt to unmount, destroy the snapshot, and then repeat the sequence.
+
+.. note:: The ``drbd-backups`` script with default settings requires at least 40 GB free space in the ``/opscode`` volume group on the backend servers.