Make sure the following prerequisites are met:
  • All the MongoDB nodes in the replica set must be online and reachable.
  • It is recommended to retain only 10-days of data in order to facilitate fast upgrade process.
  • MongoDB binary must be added to the PATH variable.
    export PATH=$PATH:<path to mongo binary>
  • All ABS instances connected to this replica set must be stopped and there should be no reads or writes occurring during the upgrade.
  • Extract the upgrade scripts from the PingIntelligence upgrade package as explained in Common upgrade tasks section.
Complete the following steps to upgrade MongoDB:
  1. Navigate to ~/pi-tmp/pingidentity/upgrade/mongo/ and copy the mongo-upgrade.sh script and place it in MongoDB Primary node.
    # cd ~/pi-tmp/pingidentity/upgrade/mongo/
    # cp mongo-upgrade.sh /<ABS 4.4.1 installation path>/pingidentity/mongo/util/
    
  2. Stop ABS on all nodes by entering the following command.
    # /<ABS installation path>/pingidentity/abs/bin/stop.sh
    
    For example:
    
    # /home/pi-user/pingidentity/abs/bin/stop.sh
    
    If ABS is running as a service, then run the following command.
    # systemctl stop pi-abs.service
  3. Navigate to the /<ABS 4.4.1 installation path>/pingidentity/mongo/util/ directory and run the mongo upgrade script.
    # ./mongo-upgrade.sh -u <abs-mongo-user> -p <abs-mongo-password>
    For example:
    # ./mongo-upgrade.sh -u absuser -p absxxx --port 27017
    please make sure that there is no ABS process running before running the mongo-upgrade script.
    are you sure you want to continue? (yes/no): yes
    progress will be logged in ./pi-abs-upgrade/mongo-upgrade.log
    
    Important: The mongo-upgrade.sh script must be executed only on the MongoDB Primary node. If the upgrade process fails due to any reason, compress the pi-abs-upgrade directory and send it to Ping Identity support for troubleshooting.
  4. Verify the indexes created on MongoDB collections to make sure the upgrade is successful. For more information, see Verifying MongoDB indexes.
Proceed to Step-2 Upgrading ABS AI Engine.
Important: Only after successful upgrade of MongoDB, proceed with ABS upgrade.