Configuring and Running DBSync Cloud CDM On Docker

Prerequisites

Install Docker

Download and install Docker Desktop from Docker.

Configuration

Create a docker-compose.yml file in your project directory with the following content:

docker-compose.yml

version: '3'
services:
  dbsync-cdm-local:
    container_name: dbsync-cloud-cdm
    image: dbsync/cloud-cdm:latest
    ports:
      - "8080:8080"
    environment:
      - system_dir=/opt/data/db/conf
      - profile_db_path=/opt/data/db
      - storage_path=/opt/data/profiles
    volumes:
      - docker-volume:/opt/data
volumes:
  docker-volume:
    external: true # Set to false to create a new volume automatically

Explanation of Configuration

services:

• dbsync-cdm-local: Defines the Docker service for DBSync Cloud CDM.

• container_name: Specifies the name of the Docker container (dbsync-cloud-cdm).

• image: Specifies the Docker image (dbsync/cloud-cdm:ext_9.0.3) to use for DBSync Cloud CDM.

• ports: Maps port 8080 of the Docker container to port 8080 of the host.

• environment: Sets environment variables required by DBSync Cloud CDM, based on the provided configuration:

• system_dir: Externalizes app specific system properties.

• profile_db_path: Externalizes profile database (profile_db.mv.db). Used to store Application users and roles along with Profile log entries.

• storage_path: Externalizes profiles (config.properties).

• volumes: Mounts a Docker volume (docker-volume) to /opt/data in the container.

You can configure the environment and volumes in the provided docker-compose.yaml as per the requirement

Running the Application

1. Start Docker Containers:

• Open a terminal and navigate to the directory containing your docker-compose.yml file.

• Run the following command to start DBSync Cloud CDM:

docker-compose up -d

2. Check the running containers

docker ps

3. Login into docker with below command

# From git bash
winpty docker exec -it <container id> bash

#For other terminals
docker exec -it <container id> bash

4. Check tomcat logs

# change your current directory to logs
cd logs


# To check running logs 
# Note the log file will be displayed with date
tail -f catalina.***.log


# To check logs from the beginning of tomcat
cat catalina.***.log

5. Access DBSync Cloud CDM:

• Once Docker Compose has started the containers, access DBSync Cloud CDM at http://localhost:8080/dbsync in your web browser.

Accessing application User Interface

You can open the following URL in your browser(with Javascript enabled)

http://localhost:8080/dbsync

Default login:

Username: admin@localhost

Password: admin

Password can be changed after you login by heading to administration page, additional roles and users can also be added

You can follow the documentation for more details on how to configure and get started with the replication of data.