IBM DataPower Operations Dashboard v1.0.7.1

A newer version of this product documentation is available.

You are viewing an older version. View latest at IBM DPOD Documentation.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

The Docker Container Edition is a lightweight "Developer edition" (previously known Light)  designated mainly for developers.

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

The Docker Container Edition does not support upgrades and not entitled to IBM support. Each new version requires deployment of new container.

Limitations

Docker installations are limited to 3 monitored devices.
Docker installation is limited to 7 days, after 7 days, you will be redirected to a license page where a license request key will be generated.
Send the license request key to IBM representative to get your license (the representative's email address will appear on-screen).

Software and Hardware Prerequisites

Software

The Docker Container Edition has been tested only on CentOS 7.4 (kernel 3.10) with Docker CE (Community Edition) version 17.09.1 and Ubuntu 16.04.3 LTS (Xential) with Docker CE version 17.09.1.
Docker hosted on Windows is not supported.

Make sure to configure your Docker installation as recommended in Docker Compatibility Matrix , especially make sure to use the recommended storage driver.

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"




  • No labels