Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide will help you get started with IBM® DataPower® Operations Dashboard

...

v1.0.

...

14.0

...

.

...

Product Overview

IBM® DataPower® Operations Dashboard delivers advanced operations for real-time visibility of transactions and centralized operations to enable quicker problem resolution and operational resiliency. The product installation media is provided as a bootable ISO file, that

...

can be deployed on a virtual machine as well as physical hardware. For more information about system requirements or a detailed installation procedure, please consult the administration guide.

Step 1: Obtain the software

Download the package from IBM® Passport Advantage®. The package includes the following components:

  • The image to deploy:

    • An ISO file for Appliance package (Std or Developer Edition).

    • A CEF file (Compressed Executable File) for Non-Appliance package.

    • A tar.gz Docker image file (lightweight "Developer edition") - Available on IBM® Fix Central.

  • This document.

Step 2: Review hardware and system configuration

  • The Product supports installation on either physical hardware or hypervisors which both requires:

...

    • Support of 64 bit architecture

    • Must be Intel® CPU's with hyper threading

  • The product supports the following 

...

  • hypervisors:

...

    • VMWare ESX v6.0, v6.5

...

    • VMWare Player - v14, v15

    • VMWare Workstation - v14, v15

    • VMware Fusion v11.0, v11.5, v12.0

    • PureApp (only on Intel Processors) - no pattern yet available, can be provided only as an imported OVA.

    • For Hyper

...

    • V support - contact your IBM sales

...

    • representatives.

  • Non Appliance installations will require a user pre installed operating system

...

  • :

    • CentOS 7.

...

    • 7-7.9 - x86-64 bit only on supported HW or Hypervisor as stated above

    • RHEL 7.7-7.9, 8.3 - x86-64 bit only on supported HW or Hypervisor as stated above

  • Installation for Docker Container with Light Developer Edition has been tested only on CentOS 7.

...

  • 8 with Docker CE

...

  • version 18.09.

...

  • 2 and Ubuntu

...

  • Desktop 18.04.3 LTS

...

  • with Docker CE version

...

  • 18.09.

...

  • 2.

  • Docker hosted on Windows is not supported.

  • The minimum resource allocation for the Developer Edition installation is as follows:

    • 2 virtual processors (vCPU)

    • Minimum of 3 GB RAM (4 GB recommended)

    • Disk space of

...

    • 25GB, with only 1 disk

  • The minimum resource allocation for the Docker Container for Light Developer Edition installation is as follows:

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

    • At least 3GB of free memory (RAM).

  • The minimum resource allocation for Standard Edition:

    • 4 virtual processors (vCPU)

    • 18 GB RAM 

    • Disk space of 180 GB (thick provisioned) configured as follows:

      • Appliance package - Storage space must be divide divided to 3 disks:

        • Operating System - 40GB

        • Install - 40GB

        • Data - 100GB 

      • Non Appliance package - follow the Appliance configuration for performance.

        • The installation process will not verify the usage of 3 Disks but performance issues can not be addressed if this configuration is not applied.

Step 3

...

: Installation

Option A

...

: Appliance and software installation

Install the ISO file

...

Use the appropriate ISO file to install DPOD:

  • Standard Edition (Production and Non-Production Environment)

    • Appliance Package - DPOD_CentOS_v.v.v.iso  (can be download from PPA)

    • Non Appliance Package - DPOD_RedHat__v.v.v.cef (can be download from PPA)

  • Developer Edition: DPOD_Developer_CentOS_v.v.v.iso  

When installing on a physical hardware:

  • The ISO file should be burned to a bootable DVD or copied to a bootable USB drive.

  • Make sure to enable the bootable DVD or USB drive in the machine's BIOS boot order list.

When installing on a virtual environment:

  • Create a new virtual machine based on the system requirements above.

  • Make sure to define a DVD/CD in the virtual machine configuration.

  • Link the DVD/CD defined before to the ISO file.

Start the machine and follow the steps below:

  • Accept license agreement.

  • Follow the on screen instructions and provide the installation script with general OS parameters such as time, time zone, NTP, Network and more.

  • Choose your environment name

  • Choose the correct architecture load based on the aggregated TPS on all your monitored devices.

  • Set passwords for the application user and root user.

  • Wait for system to reboot.

Deploy Software

  • Login as root with the password you set in a previous step.

  • Execute the following command:

    • installApp

  • Follow the instructions on screen until the installation finishes successfully.

Option B: Software Installation on a pre-prepared Appliance

Install the CEF file

You can install DPOD on an fresh, dedicated pre installed CentOS/RHEL 7.

...

7-7.8 by following the steps below:

  • Prepare your appliance.

  • Download the CEF package and move it to the /tmp folder of your server.

  • Run the CEF package and follow the on-screen instructions.

  • Verify your installation.

Option C: Docker Container Deployment

  • Import the Docker image to your local Docker repository.

  • Download the desired DPOD Docker image from IBM's Fix Central

  • 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

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

    Code Block
    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

...

  • 
    iptables-save
  • Use the following command to create a DPOD Docker container:

    Code Block
    docker run -d \
    --security-opt seccomp:unconfined \
    --cap-add SYS_ADMIN \
    --cap-add SYS_RESOURCE \ 
    --cap-add SYS_TIME \ 
    --tmpfs /tmp:exec \
    --tmpfs /run \
    --tmpfs /run/lock \
    -v /sys/fs/cgroup:/sys/fs/cgroup:ro \
    -v /etc/localtime:/etc/localtime:ro \
    --device /dev/rtc \
    -p 9022:22 \
    -p 443:443 \
    -p 60000:60000 \
    -p 60020:60020 \
    --stop-timeout 10 \
    --hostname dpod \
    --name dpod

...

  •  \
    datapower-operations-dashboard: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"
  • For further details regarding  the docker run command please see product documentation.

Step 4: Get started

  • Access the Web console via the URL: https://<DPOD ip address>

  • Sign in using the default credentials (case sensitive):

    • Username: admin

    • Password: adminuser

  • Perform the verification steps as described in the administrative guide.

  • Perform the  post-installation steps as described in the administrative guide.