PingIntelligence Upgrade Guide - PingIntelligence for APIs - 5.1

• The Kafka and Zookeeper third-party components have been introduced for processing event streaming.
• Elasticsearch 7.13.4 is required to support the new dashboard data format and the new improvements, and so there is no upgrade available for the dashboard data.
• The PingIntelligence 5.1 dashboard has significant enhancements over the previous version:
  • New dashboards
  • Per IoA reporting with transaction level data
  • Faster availability of data in the dashboard
  • New API Publish service that publishes the changes made to the discovered APIs from PingIntelligence Dashboard to AI engine
  We recommended following the manual deployment steps for the dashboard, after completing the Kafka installation and the ABS upgrade.
• The new API Publish service, that publishes the changes made to the discovered APIs from PingIntelligence Dashboard to AI engine. As a new component API Publish must be installed manually. API Publish can be installed on the Dashboard server, or on the ABS Reporting Node server.

See the Release Notes PingIntelligence 5.1 - December 2021 for the summary of new features in PingIntelligence 5.1.

Prerequisites

Common upgrade steps

• Extract the PingIntelligence for APIs upgrade package pi-api-upgrade-5.1.tar.gz into a temporary directory on the host machine that has either ASE or ABS AI Engine or PingIntelligence Dashboard installed.

  # mkdir ~/pi-tmp
  # cp pi-api-upgrade-5.1.tar.gz ~/pi-tmp/
  # cd ~/pi-tmp/
  # tar -xvf pi-api-upgrade-5.1.tar.gz
  

  Following is the directory structure:

  
  └── pingidentity
      └── upgrade
          ├── abs
          │   └── abs-upgrade.sh
          ├── ase
          │   └── ase-upgrade.sh
          ├── dashboard
          ├── mongo
          │   └── mongo_upgrade_tool_5.1.tar.gz
          └── version.txt

  Note: You can copy the upgrade package onto the host machine using utilities like SCP, rsync, SFTP, or curl.
• Upgrade the components in the following order:
  • Step-1 Installing Kafka and Zookeeper
  • Step-2 Upgrading MongoDB (including Kafka and Zookeeper)
  • Step-3 Upgrading ABS AI Engine
  • Step-4 Upgrading ASE
  • Step-5 Installing API Publish and Dashboard