IBM Watson Explorer Foundational Components, Version 11.0.2 Fix Pack 6 Readme

Upgrading AppBuilder and ZooKeeper to V11.0.2.6

These instructions apply when you upgrade from V11.0.2.5 or earlier versions of fix packs to V11.0.2.6. To upgrade AppBuilder to V11.0.2.6, you must first upgrade ZooKeeper to V11.0.2.6. Previous fix packs of ZooKeeper are not supported with AppBuilder V11.0.2.6.

Attention:

• ZooKeeper data from fix packs prior to V11.0.2.6 is not compatible with ZooKeeper V11.0.2.6. You must back up your ZooKeeper data from versions prior to V11.0.2.6 in case you need to revert your installation to a previous version.
• AppBuilder V11.0.2.6 is not compatible with ZooKeeper prior to V11.0.2.6. Therefore, ZooKeeper must be updated to V11.0.2.6 prior to updating AppBuilder to V11.0.2.6, as written in the following task.

To upgrade to AppBuilder and ZooKeeper V11.0.2.6 from V11.0.2.5 or earlier:

1. Back up the ZooKeeper configuration file and ZooKeeper data files for your AppBuilder configuration.
   • Attention: Later, if you need to revert ZooKeeper to a previous version, the backup file is required.
   • To view a list of files that need to be backed up, see Backing Up Application Builder System Files.
2. Upgrade ZooKeeper to V11.0.2.6.
3. Upgrade AppBuilder to V11.0.2.6.

Troubleshooting the ZooKeeper upgrade

If you encounter the following issues after upgrading ZooKeeper, try these workarounds:

• If Zookeeper doesn't start and you see the following message in the log file, "java.io.IOException: No snapshot found, but there are log entries. Something is broken!", open the $WEX_INSTALL/ZooKeeperData/version-2 directory and check if there is a snapshot.* file. If there is no snapshot file, create a file titled snapshot.0 as described in ZooKeeper issue 3056 .
• If AppBuilder doesn't start with the exception, Address already in use, add the following configuration to $WEX_INSTALL/ZooKeeper/zookeeper/conf/zoo.cfg:

      reconfigEnabled=false
      admin.enableServer=false
      admin.serverPort=8081