opendev/system-config
Code Issues Proposed changes
master
system-config/doc/source/mirrors.rst
James E. Blair 439ba7bd3b Add some documentation about the mirror volume config script 
And update the static page.

Change-Id: I13295f90c0f0792b0c3f55bfa55b9f2b82cf291b
2024-10-10 09:24:18 -07:00

1.3 KiB
Raw Permalink Blame History

title

Mirror Servers

Mirror Servers

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

At a Glance

Hosts
Projects
Configuration

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.