{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This guide will help you get started with IBM® DataPower® Operations Dashboard v1.0.23.x.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Product Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"IBM® DataPower® Operations Dashboard delivers advanced operations for real-time visibility of transactions and centralized operations to enable quicker problem resolution and operational resiliency.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information about system requirements and detailed installation procedures, please consult the Admin Guide in the product documentation at ","type":"text"},{"text":"https://ibm.biz/dpod-docs","type":"text","marks":[{"type":"link","attrs":{"href":"https://ibm.biz/dpod-docs"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step 1: Choose the type of installation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD supports the following installation scenarios. Choose an installation scenario. For production, this would be either All-in-One or the Cell environment:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All-in-One","type":"text","marks":[{"type":"strong"}]},{"text":": The most simple installation for production environments, installed on a single virtual or physical server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cell Environment","type":"text","marks":[{"type":"strong"}]},{"text":" (Federated Deployment): Contains multiple virtual or physical servers, designed for very high throughput, does not replicate data between the members.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Developer Edition","type":"text","marks":[{"type":"strong"}]},{"text":": Free, under a restricted license, and may be used for development and evaluation only, installed on a small virtual machine.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker Container for Developer Edition","type":"text","marks":[{"type":"strong"}]},{"text":": Free, under a restricted license, and may be used for development and evaluation only, runs as a Docker container.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Simulator","type":"text","marks":[{"type":"strong"}]},{"text":": Free, under a restricted license, and may be used for demonstrations and POCs, includes containers (Docker) that run DPOD along with gateways, MQ and additional components to simulate a complete and rich environment with real data constantly flowing into DPOD.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD supports the following server installation modes. Choose a server installation mode:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Non-Appliance Mode","type":"text","marks":[{"type":"strong"}]},{"text":": The non-appliance mode may be installed on a virtual or a physical server with a pre-installed operating system (RHEL/Rocky Linux only). The application is installed on the provided operating system.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Appliance Mode","type":"text","marks":[{"type":"strong"}]},{"text":": The appliance mode may be installed on a virtual or a physical server using an ISO file. It includes both the operating system (Rocky Linux) and the application.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step 2: Review the hardware and software requirements","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The following DataPower gateways can be monitored and managed by DPOD:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DataPower Gateway","type":"text","marks":[{"type":"strong"}]},{"text":" firmware v10.0.x, v10.5.x and v10.6.x.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DataPower Gateway operator","type":"text","marks":[{"type":"strong"}]},{"text":" v1.8.x-v1.13.x (for the ","type":"text"},{"text":"DPOD Cloud Agent component","type":"text","marks":[{"type":"link","attrs":{"href":"https://montier.atlassian.net/wiki/spaces/DPOD010023x/pages/16440886220"}}]},{"text":" to monitor containerized DataPower gateways in Kubernetes).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API Connect","type":"text","marks":[{"type":"strong"}]},{"text":" v10.0.x.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD only supports gateways with ","type":"text"},{"text":"supported firmware levels","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.ibm.com/support/pages/ibm-datapower-gateway-firmware-support-lifecycle"}}]},{"text":" that meet the minimum ","type":"text"},{"text":"system requirements for DataPower Gateway","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.ibm.com/support/pages/system-requirements-ibm-datapower-gateway"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The DataPower Gateway language must be set to English.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD can be installed on a virtual infrastructure (hypervisor). The following hypervisors are supported for running DPOD:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VMware ESXi","type":"text","marks":[{"type":"strong"}]},{"text":" v7.x-v8.x with Intel processors.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VMware Workstation/Player","type":"text","marks":[{"type":"strong"}]},{"text":" v16.x-v17.x with Intel processors.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VMware Fusion","type":"text","marks":[{"type":"strong"}]},{"text":" v12.x-v13.x on Mac with Intel processors.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AWS EC2 Instance","type":"text","marks":[{"type":"strong"}]},{"text":" (Virtual Machine) with Intel processors (using Non-Appliance installation mode only).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Azure Virtual Machine","type":"text","marks":[{"type":"strong"}]},{"text":" with Intel processors (using Non-Appliance installation mode only).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD can be installed on physical servers with Intel processors, especially when the load is high and the performance requires so. Physical hardware should be purchased according to specifications provided by the DPOD support team in a short sizing process.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The DPOD Cloud Agent component (which is optional) requires:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kubernetes","type":"text","marks":[{"type":"strong"}]},{"text":" 1.25-1.32 / OpenShift Container Platform (OCP) 4.12-4.17.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Operator Lifecycle Manager","type":"text","marks":[{"type":"strong"}]},{"text":" (OLM) installed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IBM DataPower Gateway operator ","type":"text","marks":[{"type":"strong"}]},{"text":"v1.8.x-v1.13.x.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Operating system requirements (only applicable to Non-Appliance mode):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RHEL","type":"text","marks":[{"type":"strong"}]},{"text":" v8.3-v8.10, v9.4-v9.5 - x86-64 bit only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rocky Linux","type":"text","marks":[{"type":"strong"}]},{"text":" v8.3-v8.10, v9.4-v9.5 - x86-64 bit only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some maintenance or advanced configuration tasks requires ","type":"text"},{"text":"root","type":"text","marks":[{"type":"code"}]},{"text":" or a user capable of running the ","type":"text"},{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" command (e.g. installation, upgrade, backup and restore of the DPOD application).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Review the ","type":"text"},{"text":"Operating System Requirements for Non-Appliance Mode","type":"text","marks":[{"type":"link","attrs":{"href":"https://montier.atlassian.net/wiki/spaces/DPOD010023x/pages/16440887137"}}]},{"text":" and work with your Linux team to configure the OS properly.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Third-party software such as antivirus, cybersecurity, monitoring, APM, endpoint protection, backup, etc. might significantly decrease the performance of DPOD and impact its functionality. During the resolution of issues, DPOD support will ask the customer to disable any 3rd party software in order to isolate the issues and verify their source. Support cannot be provided if the 3rd party tools are not disabled.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The required resources depend on the type of installation, the expected TPS and the duration of the retention period.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there are more than 1,000 TPS (transactions per second), or you plan to use the Cell environment, it is required to complete a sizing process by opening a support ticket with IBM Support.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The minimum required resources for All-in-One are 4 virtual CPU cores, 18 GB RAM, 200 GB disk.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The minimum required resources for the Developer Edition are 2 virtual CPU cores, 5 GB RAM, 60 GB disk.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The minimum required resources for the Docker Container for Developer Edition are 2 virtual CPU cores, 5 GB RAM, 6 GB disk.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The minimum required resources for the Simulator are 8 virtual CPU cores, 12 GB RAM, 25 GB disk.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD is I/O intensive, as it needs to persist all logs and information at very high rates. Therefore, for most of the installations, it needs to be configured with very fast disks, and with at least 3 separate disks (OS, app/logs, data).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD has the following network requirements:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At least one network interface for accessing DPOD's User Interface and communications with Gateway's Management Interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some configurations, such as the Cell environment, require two network interfaces.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Firewall requirements are detailed in the Admin Guide in the product documentation.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step 3: Obtain the software","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For the ","type":"text"},{"text":"All-in-One","type":"text","marks":[{"type":"strong"}]},{"text":" or a ","type":"text"},{"text":"Cell environment","type":"text","marks":[{"type":"strong"}]},{"text":" installations:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Non-Appliance Mode","type":"text","marks":[{"type":"strong"}]},{"text":": Download the CEF file from IBM® Passport Advantage® (file name is ","type":"text"},{"text":"DPOD_NonAppliance_.cef","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Appliance Mode","type":"text","marks":[{"type":"strong"}]},{"text":": Download the ISO file from IBM® Passport Advantage® (file name is ","type":"text"},{"text":"DPOD_Appliance_.iso","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the activation key file from IBM® Passport Advantage® (file name is ","type":"text"},{"text":"DPOD-full-version-activation-key-.zip or DPOD-api-calls-activation-key-.zip","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For the ","type":"text"},{"text":"Developer Edition","type":"text","marks":[{"type":"strong"}]},{"text":", download the ISO file from ","type":"text"},{"text":"IBM Fix Central","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm%7EWebSphere&product=ibm/WebSphere/WebSphere+DataPower+SOA+Appliances&release=All&platform=All&function=textSearch&text=datapower+operations+dashboard"}}]},{"text":" (file name is ","type":"text"},{"text":"DPOD_Developer_Edition_Appliance_.iso","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Docker Container for Developer Edition","type":"text","marks":[{"type":"strong"}]},{"text":" image is hosted in IBM Container Registry (icr.io), so there’s no need to download anything.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For the ","type":"text"},{"text":"Simulator","type":"text","marks":[{"type":"strong"}]},{"text":", follow the instructions at ","type":"text"},{"text":"https://ibm.biz/dpod-simulator","type":"text","marks":[{"type":"link","attrs":{"href":"https://ibm.biz/dpod-simulator"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"DPOD Cloud Agent","type":"text","marks":[{"type":"strong"}]},{"text":" images are hosted in IBM Container Registry (icr.io), so there’s no need to download anything.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step 4: Installation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ISO installation","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the DPOD ISO file on your virtual/physical server's DVD and make sure it is configured in the server’s boot order.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Power on the virtual/physical server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start the installation and follow the instructions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide the network configuration and set passwords.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After the server OS is installed and the server reboots, login as ","type":"text"},{"text":"dpodadm","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute the command ","type":"text"},{"text":"sudo /opt/DPOD_Appliance.cef","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure time zone, NTP, and environment name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read the End User License Agreement (EULA) and choose whether to accept it or not.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wait for the installation to complete.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CEF installation","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the CEF file to ","type":"text"},{"text":"/installs","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute the following commands:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd \nsudo chmod 755 \nsudo ./","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure time zone, NTP, and environment name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read the End User License Agreement (EULA) and choose whether to accept it or not.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wait for the installation to complete.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cell Environment","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the Cell Manager as All-in-One.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the Cell Member(s) as All-in-One.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Federate each Cell Member to the Cell Manager.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker Container for Developer Edition","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure the firewall:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo firewall-cmd --add-service=https --permanent\nsudo firewall-cmd --add-port=9022/tcp --permanent\nsudo firewall-cmd --add-port=60000-60003/tcp --permanent\nsudo firewall-cmd --add-port=60020-60023/tcp --permanent\nsudo firewall-cmd --reload","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a directory for the container’s volumes:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DPOD_VOLUMES_PATH=\"\"\nmkdir -p \"${DPOD_VOLUMES_PATH}/data\" \"${DPOD_VOLUMES_PATH}/logs/httpd\" \"${DPOD_VOLUMES_PATH}/installs_logs\"\nchmod -R 777 \"${DPOD_VOLUMES_PATH}\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pull the image from IBM Container Registry:","type":"text"}]},{"type":"codeBlock","content":[{"text":"docker pull icr.io/dpod/dpod-developer-edition:latest","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the container:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"DPOD_VOLUMES_PATH=\"\"\ndocker run -d \\\n --security-opt seccomp:unconfined \\\n --cgroupns host \\\n --cap-add=SYS_ADMIN \\\n --cap-add=SYS_PTRACE \\\n --cap-add=SYS_RESOURCE \\\n --tmpfs /tmp \\\n --tmpfs /run \\\n --tmpfs /app/tmp:exec \\\n --tmpfs /data/messaging/agentsMessaging \\\n -v /sys/fs/cgroup:/sys/fs/cgroup:rw \\\n -v /etc/localtime:/etc/localtime:ro \\\n -v ${DPOD_VOLUMES_PATH}/logs:/logs:rw \\\n -v ${DPOD_VOLUMES_PATH}/data:/data:rw \\\n -v ${DPOD_VOLUMES_PATH}/installs/logs:/installs/logs:rw \\\n -p 9022:22 \\\n -p 443:443 \\\n -p 60000:60000 \\\n -p 60020:60020 \\\n --stop-timeout 10 \\\n --hostname dpod \\\n --name dpod \\\n -e DPOD_EXT_HOST_IP= \\\n -e DPOD_ACCEPT_LICENSE=true \\\n icr.io/dpod/dpod-developer-edition:latest","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Simulator","type":"text","marks":[{"type":"strong"}]},{"text":": Follow the instructions at ","type":"text"},{"text":"https://ibm.biz/dpod-simulator","type":"text","marks":[{"type":"link","attrs":{"href":"https://ibm.biz/dpod-simulator"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DPOD Cloud Agent","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use your entitlement key to create a pull secret for accessing IBM Entitled Registry (","type":"text"},{"text":"cp.icr.io/cp/dpod","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the Cloud Agent CatalogSource.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the Cloud Agent operator.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deploy the DPOD Cloud Agent instance (configure the images to use the pull secret with the ","type":"text"},{"text":"imagePullSecrets","type":"text","marks":[{"type":"code"}]},{"text":" property).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect the Cloud Agent instance to the DPOD instance.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step 5: Get started","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log in to the Web Console (default username: ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"strong"}]},{"text":", default password: ","type":"text"},{"text":"adminuser","type":"text","marks":[{"type":"strong"}]},{"text":") via the URL: ","type":"text"},{"text":"https://","type":"text","marks":[{"type":"underline"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Perform the ","type":"text"},{"text":"post-installation tasks","type":"text","marks":[{"type":"strong"}]},{"text":" as described in the Admin Guide in the product documentation.","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported