jumpmind/symmetricds-pro repository overview

---

This repository contains the JumpMind Inc. official Docker image for SymmetricDS Pro. This Docker image is based on the openjdk:alpine image. This installation contains the default web server configuration for SymmetricDS Pro.

⁠Overview

SymmetricDS is an open source database replication tool that is highly scalable and configurable. SymmetricDS supports a wide variety of database platforms such as MySQL, Microsoft SQL Server, PostgreSQL, SQLite, Oracle SQL, and more. Please visit the SymmetricDS website to learn more about the options and features: https://www.symmetricds.org/⁠

SymmetricDS Pro requires a license key to access the web console. To obtain a trial license key, please visit the following link: https://www.jumpmind.com/products/symmetricds/try⁠

⁠Running a SymmetricDS Pro Container

To start SymmetricDS Pro using HTTP run the following command: docker run -p 31415:31415 --name sym jumpmind/symmetricds-pro

The SymmetricDS Pro console can then be accessed at the URL: http://localhost:31415/app⁠

Please note that the SymmetricDS Pro Demo configuration only works with HTTP.

To start SymmetricDS Pro using HTTPS run the following command: docker run -p 31417:31417 --name sym jumpmind/symmetricds-pro

The SymmetricDS Pro console can then be accessed at the URL: https://localhost:31417/app⁠

Please note that you must allow the IP of the Docker container to connect to the database in your database settings. If you are running locally, allowing localhost is not sufficient since the Docker container is on a separate subnet.

⁠Connecting to a Running Container

SymmetricDS may require manual configuration on the file system via command line tools. To do this, run the following command to open a shell on a running container: docker exec -it sym /bin/sh

This will open the default shell for Alpine Linux so that manual changes can be made on the container's file system.

⁠Volumes

Volumes allow data and files to be persisted across multiple containers. This Docker image is configured to allow volumes for the engines, tmp, conf, and security directories so that configuration can be persisted.

To mount a volume, add one or more of the following argument to the run command: -v sym-engines:/opt/symmetric-ds/engines -v sym-tmp:/opt/symmetric-ds/tmp -v sym-conf:/opt/symmetric-ds/conf -v sym-security:/opt/symmetric-ds/security

As an example, the following run command can be used to start SymmetricDS Pro using HTTP and create the sym-engines, sym-conf, and sym-security volumes: docker run -p 31415:31415 --name sym -v sym-engines:/opt/symmetric-ds/engines -v sym-conf:/opt/symmetric-ds/conf -v sym-security:/opt/symmetric-ds/security jumpmind/symmetricds-pro

The above command will allow the engines, conf, and security directories to be persisted in the sym-engines, sym-conf, and sym-security volumes respectively. If this container is stopped or deleted, a new container can be created using the same command and the configuration from the previous container will be retained.

⁠Clustering

Clustering is required to ensure the state when the Docker container is restarted. Add the following property to any engines that are created.

cluster.lock.enabled=true

⁠Building a SymmetricDS Pro Image

docker build -t symmetricds-pro --build-arg SETUP_JAR=PATH_TO_SYMMETRIC_SETUP_JAR .