Skip to content
On this page

Deploy DBConvert Streams to Amazon EC2.

We are going to create an instance on Amazon Elastic Compute Cloud (EC2), and the steps to deploy DBConvert Streams on it are as follows:

Launch Amazon EC2 Instance.

Here are the general steps to launch an EC2 instance on AWS:

  1. Log in to the AWS Management Console.
  2. Navigate to the EC2 dashboard.
  3. Click on the Launch Instance button.
  4. Choose an Amazon Machine Image (AMI) - this is the operating system and software that the instance will use.
  5. Select the instance type - this determines the hardware resources available to the instance, such as CPU, memory, and storage.

    The minimum hardware resources required for launching DBConvert Streams on an AWS EC2 server are 1 CPU / 2 GB RAM. You may begin with an AWS t2.micro instance and opt for a more powerful server if high throughput is expected when replicating data between the source DB and target. Launch new EC2 instance.

  6. Select or create a key pair to access the instance via SSH.
    Configure key pair.
  7. Click on the Launch instanse button and wait until the new instance is initialized.

Running instance.

After the instance is launched, it will typically take a few minutes to become available. Once it is up and running, you can connect to it via SSH.

Connect to Amazon EC2.

  1. Click the Connect button at the top
  2. Navigate to the 'SSH client' tab to view your instance connection details. Connect to EC2 instance
  3. Copy and paste the command into terminal to connect to your instance using its Public DNS via ssh. To connect to your instance using its Public DNS via SSH, copy and paste the following command into your terminal:
ssh -i "/path/to/your/key.pem" ec2-user@public-dns-name

Note that you will need to replace /path/to/your/key.pem with the file path to the private key file you used to launch the instance, and public-dns-name with the Public DNS of your instance. Also, make sure that the security group associated with the instance allows incoming SSH traffic on port 22.


ssh -i "~/.ssh/dbs.pem" [email protected]


Install Docker.

To install Docker on your EC2 instance, follow these steps:

  1. Run the command below to ensure your operating system has the latest security updates and bug fixes for its installed packages.
     sudo yum update
  2. Run the following command to install docker.
    sudo yum install docker
  3. Add ec2-user to the docker group to run Docker commands without using the sudo command.
    sudo usermod -a -G docker ec2-user
  4. Switch the current shell session to the docker group, allowing the user to run Docker commands without opening a new shell session.
    newgrp docker
  5. Enable the Docker service to start automatically at boot time.
    sudo systemctl enable docker.service
  6. Start the Docker service
    sudo systemctl start docker.service

Install Docker Compose.

Since DBConvert Streams relies on several services, it's advisable to utilize Docker Compose to initiate the necessary containers. This tool allows you to define and run multi-container Docker applications, simplifying managing the services and dependencies required by DBConvert Streams.

  1. Install the Python package manager pip for Python 3
    sudo yum install python3-pip
  2. Install Docker Compose.
    pip3 install --user docker-compose

To learn how to use Docker Compose files to initiate DBS services, refer to the DBS docker containers section of the DBConvert Streams guide.

DBConvert Streams - event driven replication for databases