Run multiple Openfire servers & DBs in Docker for local testing Federation or Cluster configurations/management
Go to file
Dan Caseley 7caafe6056 Fix READMEs 2022-07-27 14:47:41 +02:00
_common Move all the files into purpose-defined subdirectories 2022-07-27 14:47:41 +02:00
cluster Fix READMEs 2022-07-27 14:47:41 +02:00
cluster_with_federation Fix READMEs 2022-07-27 14:47:41 +02:00
federation Fix READMEs 2022-07-27 14:47:41 +02:00
scripts Update scripts to ignore fixed name formats 2021-12-20 11:28:33 +00:00
.gitignore Update scripts to ignore fixed name formats 2021-12-20 11:28:33 +00:00
README.md Fix READMEs 2022-07-27 14:47:41 +02:00
block_federation.sh Update blocking to ignore fixed names 2021-12-20 11:16:40 +00:00
block_node_from_cluster.sh Update blocking to ignore fixed names 2021-12-20 11:16:40 +00:00
reset_cluster_blocking.sh Add scripts for dropping and readding nodes to the cluster 2021-09-03 19:56:43 +01:00
stop.sh Supply separate stack stop script 2021-12-23 12:31:31 +00:00
unblock_federation.sh Update for dev environment, containing: 2021-12-01 12:43:18 +01:00
unblock_node_from_cluster.sh Add scripts for dropping and readding nodes to the cluster 2021-09-03 19:56:43 +01:00

README.md

Multiple Openfires in Docker

Quickly create multiple Openfire servers with associated PostgreSQL DBs in Docker containers for local testing.

Data and config snapshots have been taken of each DB and Openfire server so that a known desired state is configured on start. See the "How it's built" section below if you want to understand how this was done or need to add more nodes.

Prerequisites

Quick Start

  1. Make sure you have docker and docker-compose installed
  2. Create a local Openfire docker image, tagged openfire:latest that contains the version of Openfire that you want to run
    1. run docker build --tag openfire:latest . in the root of the Openfire repository (https://github.com/igniterealtime/Openfire)
  3. Launch the environment using the start.sh in the directory of your choice.

How it's built

To recreate the known good state for the system we first create base Openfire and relevant database containers. We then perform the manual setup and any other configuration that we require, such as adding users and MUC rooms. Once the setup is complete we dump the database from the container to the Docker host and copy the Openfire config files from the container to the Docker host. These are then used with Docker volumes for creating the same state in subsequent Openfire and database containers.