Open main menu

CDOT Wiki β

Changes

IRCC-Hyperkitty/SOP

2,546 bytes added, 21:08, 3 February 2016
Created page with '{{Admon/important|Seneca-Specific SOP|This SOP is specific to the environment at Seneca CDOT since it refers to specific hosts, configurations, and tools. It is intended solely a…'
{{Admon/important|Seneca-Specific SOP|This SOP is specific to the environment at Seneca CDOT since it refers to specific hosts, configurations, and tools. It is intended solely as a reference for the OSTEP team at CDOT, but the content may be useful to readers in other contexts.}}



= Introduction =
This page covers all the Hyperkitty/Postorius/Mailman3 maintenance information for IRCC instance. All the services are running inside a docker container.

= Docker =

== Login to a running container ==
1. Login to colo server and become root
ssh colo/code>
sudo -i
2a. Run hyperkitty-docker.sh under the root home folder. The script should automatically attach a running container, or start a new container if there is no container is running.
/root/hyperkitty-docker.sh
2b. '''Manually''' attach to running container
# Checkout container name
docker ps
# Attach to the Hyperkitty docker container
docker attach <container_name>
3. Now you should get the bash prompt inside the container

== Start a new container ==
1. Login to colo server and become root
ssh colo
sudo -i
2a. Run hyperkitty-docker.sh under the root home folder. The script should automatically attach a running container, or start a new container if there is no container is running.
/root/hyperkitty-docker.sh
2b. '''Manually''' start a new container
# Checkout the latest image name
docker images
# Start a container
docker run -it -p <IP_ADDRESS>:80:80 \
-p <IP_ADDRESS>:443:443 \
-p <IP_ADDRESS>:25:25 \
--cap-add SYS_ADMIN \
--add-host rcc-icn.ca:127.0.0.1 \
--add-host forum.rcc-icn.ca:127.0.0.1 \
--add-host forum.admin.rcc-icn.ca:127.0.0.1 \
--add-host wiki.rcc-icn.ca:127.0.0.1 \
<IMAGE_NAME> bash
3. Run the following scripts inside the container
# Mount the SAN and start backup scripts in the background
start-services
# Start postfix, mailman ,and httpd
hk start

= Backup =

All the backups files are located under <code>/Volume3/backup/colo</code> on our SAN, mounted on <code>/mnt/backup</code> inside the container.

There are several directories under <code>/Volume3/backup/colo</code>:

'''ircc_backups''': compressed data backups of Mailman3, Postorius, Hyperkitty, and Mediawiki

'''ircc_logs''': latest log files of the backup scripts

'''ircc_programs''': Program files of Mailman3, Postorius, Hyperkitty, and Mediawiki (Manually backed up)