DRAFT KB-XXXX "No configuration setting found for key 'zkServers'" error appears while trying to reset analytics

Symptoms

When upgrading an environment, the following error appears while trying to reset analytics:

APPIAN_HOME\services\bin>resetAnalytics.bat -p ********** 
Exception in thread "main" com.typesafe.config.ConfigException$Missing: No configuration setting found for key 'zkServers'

Cause

This error appears when the appian topology file doesn't contain zookeeperCluster as per the following example:

<topology port="5000">
   <server host="localhost">
     <engine name="forums"/>
     <engine name="notify"/>
     <engine name="notify-email"/>
     <engine name="channels"/>
     <engine name="content"/>
     <engine name="collaboration-statistics"/>
     <engine name="personalization"/>
     <engine name="portal"/>
     <engine name="process-design"/>
     <engine name="process-analytics0"/>
     <engine name="process-analytics1"/>
     <engine name="process-analytics2"/>
     <engine name="process-execution0"/>
     <engine name="process-execution1"/>
     <engine name="process-execution2"/>
   </server>
   <search-cluster port="9300">
     <search-server/>
   </search-cluster>
   <kafkaCluster>
     <broker host="localhost" port="9092"/>
   </kafkaCluster>
   <zookeeperCluster>
     <zookeeper host="localhost" port="2181"/>
   </zookeeperCluster>
 </topology>

Action

Update the appian topology file in order to add the zookeeperCluster section. This file should be located in <APPIAN_HOME>/conf/ for Appian version 18.2 and later, or in <APPIAN_HOME>/ear/suite.ear/conf/ for Appian version 18.1 and earlier.

Affected Versions

This article applies to Appian version 18.3 and earlier.

Last Reviewed: March 2019