:title: Mirror Servers

.. _mirrors:

Mirror Servers
##############

Each cloud region hosts a dedicated mirror server which serves static
content from OpenAFS.

At a Glance
===========

:Hosts:
  * http://mirror.region.cloud.opendev.org
:Projects:
  * http://apache.org/
:Configuration:
  * :git_file:`launch/src/opendev_launch/mirror_volumes.sh`

Overview
========

When setting up a new mirror, add a cinder volume and run the
:git_file:`launch/src/opendev_launch/mirror_volumes.sh` to set up LVM
volumes. The cinder volume should be at least 200GB as we divide the volume
with 50% capacity assigned to Apache2 caches and 50% assigned to OpenAFS
caches. Starting with 200GB gives us at least 100GB for each of the caches
we run.

With the volume attached to the server determine the device path then run
this command::

  ./mirror_volumes.sh -d /dev/$DEVICE -g main \
    -v afscache:50%VG:/var/cache/openafs \
    -v proxycache:50%VG:/var/cache/apache2

This will configure the cinder volume with one lvm volume group for OpenAFS
and another for Apache2. Each volume will get an ext4 filesystem and /etc/fstab
will be updated. After confirming the script outputs look good you will need
to `systemctl daemon-reload` then `mount -a` to mount the new filesystems.
A reboot is also a good idea to confirm everything comes up on a fresh boot
too.