1. The Docker Container for Developer Edition is free, under a restricted license, and may be used for development and evaluation only.

2. It is geared towards the DataPower developer that wants to run DPOD on their development workstation, in the context of limited functionality.

3. It is deployed as a Docker container on a virtual machine or a laptop.

4. The Docker Container for Developer Edition is not entitled to IBM support.

Limitations

Docker installations are limited to:

• 3 monitored gateways.

• 1 monitored Cloud Agent, monitoring up to 3 monitored containerized gateways.

• 7 days, after which the container needs to be deleted and re-launched (unless the activation key is extended by generating an activation request key and sending it by email to your IBM representative).

Software Prerequisites

• CentOS/RHEL/Ubuntu Desktop/MacOS operating system (Windows is not supported)

• Docker installed

• If needed, enable firewall rules:
  Port 9022 – SSH access

  Port 443 – Web Console access

  Port 60000 – Syslog agent (consumes messages from the DataPower gateways)

  Port 60020 – WS-M agent (consumes messages from the DataPower gateways)
  For example:

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

Hardware Prerequisites

• At least 4GB of disk space that can grow up to 6GB.

• At least 3GB of free memory.

• At least 4 Cores of Intel based CPUs.

Running the Docker Container

1. Use the docker pull command to pull the desired image from IBM container registry (icr.io). You may use a specific version (e.g. 1.0.20.2) or the latest version (using the latest tag). For example:

   docker pull icr.io/dpod/dpod-developer-edition:latest

2. Use the docker run command to create the DPOD Docker container
   Make sure to replace <Host IP Address> in the command below with the IP Address of the host machine that runs the Docker containers.

   test -e /dev/rtc && DPOD_DEV="/dev/rtc" || DPOD_DEV="/dev"; docker run -d \ --security-opt seccomp:unconfined \ --cgroupns host \ --cap-add SYS_ADMIN \ --cap-add=SYS_PTRACE \ --cap-add SYS_RESOURCE \ --cap-add SYS_TIME \ --tmpfs /tmp:exec \ --tmpfs /run \ -v /sys/fs/cgroup:/sys/fs/cgroup:rw \ --device ${DPOD_DEV} \ -p 9022:22 \ -p 443:443 \ -p 60000:60000 \ -p 60020:60020 \ --stop-timeout 10 \ --hostname dpod \ --name dpod \ icr.io/dpod/dpod-developer-edition:latest && docker exec -d -u root dpod /bin/su - -c "export ACCEPT_LICENSE=true; export TIME_ZONE=America/New_York; export DPOD_EXT_HOST_IP=<Host IP Address>; /app/scripts/app-init.sh"

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

   • ACCEPT_LICENSE: (mandatory) Indication that the user has accepted the EULA (End User License Agreement). The value for accepting is the number 1. (For reviewing the license agreement see "reviewing license agreement ")

   • TIME_ZONE: (optional) use the time zone configured to your monitored gateway. 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 gateway 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 - Use the host machine IP address with the https protocol.

• SSH - Use the host machine IP address with port 9022.
  User is root with a default password of dpod.

Re-run Previously Created DPOD Docker Container

Make sure to replace <Host IP Address> in the command below with the IP Address of the host machine that runs the Docker containers.

Review the License Agreement

For reviewing the license agreement execute the following command when the container is running: