DPOD Docker Container Edition is a lightweight edition designated mainly for developers.

Software and Hardware Prerequisites

Software

DPOD Docker Container Edition has been tested only on Red Hat / CentOS 7.2 (kernel 3.10) Docker host with Docker version 1.13.1.

Hardware

1. At least 2GB of disk space that can grow up to 4GB.
2. At least 3GB of free memory.

Installation

Image Download

Download the desired DPOD Docker image from IBM Docker Hub:

1. Specific version: dpod:<version number>. For example: dpod:1.0.7.0
2. Latest version: dpod:latest

Image Installation

There are two options for installing DPOD Docker image on you local image repository:

1. Use the Docker pull command:

   docker pull ibmcom/dpod:latest

2. Manual load: after downloading the desired images to your Docker host use the load command:

   docker load < /tmp/dpod-latest.tar.gz

Use the following command to display your local image repository:

docker images

This is how the result should look like:

Enable Firewall Rules

If needed enable firewall rules for allowing DataPower access to DPOD Docker container agents (syslog on port 60000 and wsm on port 60020 ) :

iptables -I INPUT 1  -p tcp -m tcp -s 0.0.0.0/0 -d 0.0.0.0/0 --dport 60000 -j ACCEPT
iptables -I INPUT 1 -p tcp -m tcp -s 0.0.0.0/0 -d 0.0.0.0/0 --dport 60020 -j ACCEPT

save the configuration :

iptables-save

Create a new Docker container

Use the following command to create a DPOD Docker container:

docker run -d \
   --security-opt seccomp:unconfined \
   --cap-add SYS_ADMIN \
   --tmpfs /tmp \
   --tmpfs /run \
   --tmpfs /run/lock \
   -v /sys/fs/cgroup:/sys/fs/cgroup:ro \
   -v /etc/localtime:/etc/localtime:ro \
   -p 9022:22 \
   -p 443:443 \
   -p 60000:60000 \
   -p 60020:60020 \
   --stop-timeout 10 \
   --hostname dpod \
   --name dpod \
   dpod:latest && docker exec -d -u root dpod /bin/su - -c "export TIME_ZONE=America/New_York ;export DPOD_EXT_HOST_IP=192.168.65.110 ;/app/scripts/app-init.sh"

Notes:

Ports: the container should expose the following ports:

• 22 – SSH access to the container
• 443 – Web Console access
• 60000 – Syslog agent. It is important that you map this port as it is exposed (60000)
• 60020 – WS-M agent. It is important that you map this port as it is exposed (60200)

Important:

You should run the Docker exec command immediately after running the Docker container in order to apply your specific Docker environment.

The following environment variables can be used when invoking the command:

• TIME_ZONE: (optional) use the time zone configured to your monitored device. The time zone should be compatible with the “tz database time zone”. The default time zone is “America/New_York”.
• DPOD_EXT_HOST_IP: (optional) Use this variable if your monitored device does not have direct access to your DPOD container (for example, if you are using physical or virtual IDG appliance).
  The  value should be the Docker host IP address.
• DPOD_NTP_1: (optional) use this value to configure your primary NTP server IP address inside the DPOD container.
• DPOD_NTP_2, DPOD_NTP_3, DPOD_NTP_4: (optional) use this value to configure your secondary NTP servers IP address inside the DPOD container.

Access the DPOD container

• Web Console - From your web browser use the container IP address, or more likely your Docker host IP address mapped to the Web Console port (443 in the example) : https://<IP address>.
  user : admin and default password : adminuser
• SSH - Use the container IP address, or more likely your Docker host IP address mapped to the ssh port (9022 in the example) .
  user : root and default password : dpod

Re Run Previously Created DPOD Docker Container

docker start dpod  && docker exec -d -u root dpod /bin/su - -c "export TIME_ZONE=America/New_York ;export DPOD_EXT_HOST_IP=192.168.65.110 ; /app/scripts/app-init.sh"