<?xml version="1.0" encoding="UTF-8" ?>
<?xml-stylesheet type="text/xsl" href="https://community.appian.com/cfs-file/__key/system/syndication/rss.xsl" media="screen"?><rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/"><channel><title>KB-2227 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch</link><description /><dc:language>en-US</dc:language><generator>Telligent Community 12</generator><item><title>KB-2227 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch</link><pubDate>Wed, 25 Sep 2024 20:02:52 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Ryan Good</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Current Revision posted to Appian Knowledge Base by Ryan Good on 9/25/2024 8:02:52 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In &lt;strong&gt;tomcat-stdOut.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In &lt;strong&gt;search-server.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to versions that fall between 21.1 and 24.2.&lt;/p&gt;
&lt;p&gt;Last Reviewed:&amp;nbsp;September 2024&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>KB-2227 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/12</link><pubDate>Wed, 25 Sep 2024 20:02:37 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Ryan Good</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 12 posted to Appian Knowledge Base by Ryan Good on 9/25/2024 8:02:37 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In &lt;strong&gt;tomcat-stdOut.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In &lt;strong&gt;search-server.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to versions that fall between 21.1 and 24.2.&lt;/p&gt;
&lt;p&gt;Last Reviewed:&amp;nbsp;May 2023&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>KB-2227 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/11</link><pubDate>Wed, 24 May 2023 05:17:44 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Maggie Deppe-Walker</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 11 posted to Appian Knowledge Base by Maggie Deppe-Walker on 5/24/2023 5:17:44 AM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In &lt;strong&gt;tomcat-stdOut.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In &lt;strong&gt;search-server.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to 21.1 and later.&lt;/p&gt;
&lt;p&gt;Last Reviewed:&amp;nbsp;May 2023&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>KB-2227 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/10</link><pubDate>Thu, 17 Nov 2022 06:37:41 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Maggie Deppe-Walker</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 10 posted to Appian Knowledge Base by Maggie Deppe-Walker on 11/17/2022 6:37:41 AM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In &lt;strong&gt;tomcat-stdOut.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In &lt;strong&gt;search-server.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to 21.1 and later.&lt;/p&gt;
&lt;p&gt;Last Reviewed: November 2022&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>DRAFT SP-7917 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/9</link><pubDate>Thu, 17 Nov 2022 06:35:07 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Maggie Deppe-Walker</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 9 posted to Appian Knowledge Base by Maggie Deppe-Walker on 11/17/2022 6:35:07 AM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In &lt;strong&gt;tomcat-stdOut.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In &lt;strong&gt;search-server.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to 21.1 and later.&lt;/p&gt;
&lt;p&gt;Last Reviewed: November 2022&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>DRAFT SP-7917 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/8</link><pubDate>Mon, 10 Oct 2022 21:31:43 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Maggie Deppe-Walker</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 8 posted to Appian Knowledge Base by Maggie Deppe-Walker on 10/10/2022 9:31:43 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In &lt;strong&gt;tomcat-stdOut.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In &lt;strong&gt;search-server.log&lt;/strong&gt;:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to 21.1 and later.&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>DRAFT SP-7917 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/7</link><pubDate>Mon, 10 Oct 2022 21:31:26 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Maggie Deppe-Walker</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 7 posted to Appian Knowledge Base by Maggie Deppe-Walker on 10/10/2022 9:31:26 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;When starting up the search server after an upgrade, the following errors appear:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In tomcat-stdOut.log:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;In search-server.log:
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;There are two places for search server API key values in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The value:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The value:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the &lt;a href="https://docs.appian.com/suite/help/latest/Upgrade_Guide.html#6.-copy-your-data"&gt;upgrade documentation&lt;/a&gt;&amp;nbsp;points to&amp;nbsp;manually copying over the old &lt;strong&gt;custom.properties&lt;/strong&gt;&lt;span&gt;&amp;nbsp;file located at&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;OLD_APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;to&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;code class="language-plaintext highlighter-rouge"&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&lt;/code&gt;. This will overwrite the newly generated search-server &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value with the old &lt;span&gt;search-server&amp;nbsp;&lt;/span&gt;&lt;code&gt;apiKey&lt;/code&gt; value.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the newly generated API key.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;apiKey&lt;/code&gt;&amp;nbsp;value in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old API key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;Ensure the values of the search server API key properties are the same in&amp;nbsp;&lt;strong&gt;custom.properties&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;/strong&gt;&lt;span&gt;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;(via &lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt;) &lt;/span&gt;and&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;strong&gt;custom.properties&lt;/strong&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;(via&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;). This can be done in either one of the following ways:&amp;nbsp;&lt;/span&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Copy the&amp;nbsp;value from&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;in &lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/code&gt;&amp;nbsp;&lt;/span&gt;to &lt;code&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&lt;/code&gt;.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;Copy the&lt;/span&gt;&lt;span&gt;&amp;nbsp;value f&lt;/span&gt;rom&amp;nbsp;&lt;span&gt;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt;&amp;nbsp;in &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/&amp;nbsp;&lt;/code&gt;to&lt;/span&gt;&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt;&amp;nbsp;&lt;/span&gt;&lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;&lt;/span&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;This article applies to versions of Appian upgrading&amp;nbsp;from 20.4 and earlier to 21.1 and later.&lt;/p&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>DRAFT SP-7917 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/3</link><pubDate>Mon, 03 Oct 2022 15:10:25 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Sam Hammermaster</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 3 posted to Appian Knowledge Base by Sam Hammermaster on 10/3/2022 3:10:25 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;There are a few different symptoms that can be experienced. The error will appear after starting the search server post upgrade. The following errors have been observed:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;&lt;/span&gt;&lt;/p&gt;
&lt;p&gt;There are two places for search server API keys in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The field:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The field:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the upgrade documentation then&amp;nbsp;points to&amp;nbsp;merging configurations. Copying over the old &lt;code&gt;custom.properties&lt;/code&gt; file into the new Appian install directory will overwrite the newly generated search-server apiKey with the old one.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The apiKey in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt; will be the newly generated one.&lt;/li&gt;
&lt;li&gt;The apiKey in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old one.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Copy the search server API key from &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;in the&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;section to &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;span style="font-family:arial, helvetica, sans-serif;"&gt; in the&amp;nbsp;&lt;/span&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;span style="font-family:arial, helvetica, sans-serif;"&gt;section.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;The content of the apiKey does not matter as long as the values are the same, so copying over the other way works too.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;&lt;/span&gt;&lt;/h2&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;This article applies to upgrading from all versions of Appian starting with 21.1&lt;/li&gt;
&lt;/ul&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>DRAFT SP-7917 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/2</link><pubDate>Mon, 03 Oct 2022 15:10:03 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Sam Hammermaster</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 2 posted to Appian Knowledge Base by Sam Hammermaster on 10/3/2022 3:10:03 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;There are a few different symptoms that can be experienced. The error will appear after starting the search server post upgrade. The following errors have been observed:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;&lt;/span&gt;&lt;/p&gt;
&lt;p&gt;There are two places for search server API keys in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The field:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The field:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the upgrade documentation then&amp;nbsp;points to&amp;nbsp;merging configurations. Copying over the old &lt;code&gt;custom.properties&lt;/code&gt; file into the new Appian install directory will overwrite the newly generated search-server apiKey with the old one.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The apiKey in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt; will be the newly generated one.&lt;/li&gt;
&lt;li&gt;The apiKey in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old one.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Copy the search server API key from &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;in the&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;section to &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;span style="font-family:arial, helvetica, sans-serif;"&gt; in the&amp;nbsp;&lt;/span&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;span style="font-family:arial, helvetica, sans-serif;"&gt;section.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;The content of the apiKey does not matter as long as the values are the same, so copying over the other way works too.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;&lt;/span&gt;&lt;/h2&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;This section includes any relevant version information for Appian or other third/party configurations. Some examples of valid affected versions are as follows:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;This article applies to upgrading from all versions of Appian starting with 21.1&lt;/li&gt;
&lt;/ul&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item><item><title>DRAFT SP-7917 401 unauthorized error caused by apiKey mismatch</title><link>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch/revision/1</link><pubDate>Mon, 03 Oct 2022 15:08:41 GMT</pubDate><guid isPermaLink="false">d3a83456-d57b-489c-a84c-4e8267bb592a:76e94efb-4f07-488a-8d29-2c6a6cf04c99</guid><dc:creator>Sam Hammermaster</dc:creator><comments>https://community.appian.com/support/w/kb/2748/kb-2227-401-unauthorized-error-caused-by-apikey-mismatch#comments</comments><description>Revision 1 posted to Appian Knowledge Base by Sam Hammermaster on 10/3/2022 3:08:41 PM&lt;br /&gt;
&lt;h2&gt;&lt;span&gt;Symptoms&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;There are a few different symptoms that can be experienced from this problem. The error will appear after starting the search server post upgrade. The following errors have been observed:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;pre&gt;method [GET], host http://localhost:9200, URI [/_nodes/http?timeout=1000ms], status line [HTTP/1.1 401 Unauthorized]&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;com.appiancorp.common.persistence.search.AppianSearchSpringConfig - error initializing client&lt;/pre&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;pre&gt;fetching geoip databases overview from [https://geoip.elastic.co/v1/database?elastic_geoip_service_tos=agree] exception during geoip databases update java.net.SocketTimeoutException: connect timed out&lt;/pre&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;Cause&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;&lt;/span&gt;&lt;/p&gt;
&lt;p&gt;There are two places for search server API keys in Appian:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The field:&amp;nbsp;&lt;code&gt;conf.data.search-server.restclient.apiKey&lt;/code&gt; in&amp;nbsp;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;span&gt;The field:&amp;nbsp;&lt;code&gt;conf.search-server.http.auth.apiKey&lt;/code&gt; in&amp;nbsp;&lt;/span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&amp;nbsp;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These keys must be the same value for the search server to function as expected.&lt;/p&gt;
&lt;p&gt;When upgrading Appian and deploying configurations, the two API keys will match. However, the upgrade documentation then&amp;nbsp;points to&amp;nbsp;merging configurations. Copying over the old &lt;code&gt;custom.properties&lt;/code&gt; file into the new Appian install directory will overwrite the newly generated search-server apiKey with the old one.&lt;/p&gt;
&lt;p&gt;The apiKey in&amp;nbsp;&lt;span&gt;&lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt; will be the newly generated one.&lt;/p&gt;
&lt;p&gt;The apiKey in &lt;code&gt;&lt;span&gt;&amp;lt;APPIAN_HOME&amp;gt;&lt;/span&gt;&lt;/code&gt;&lt;span&gt;&lt;code&gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;&lt;/span&gt;will be the old one.&lt;/p&gt;
&lt;p&gt;&lt;/p&gt;
&lt;p&gt;This issue has been reported to the Appian Product Team. The reference number for this issue is&amp;nbsp;&lt;strong&gt;AN-215019&lt;/strong&gt;.&lt;/p&gt;
&lt;h2&gt;&lt;span&gt;Action&lt;/span&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Copy the search server API key from &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/conf/custom.properties&lt;/code&gt;&amp;nbsp;in the&amp;nbsp;&lt;code&gt;&lt;span&gt;conf.data.search-server.restclient.apiKey&lt;/span&gt;&lt;/code&gt;&amp;nbsp;section to &lt;code&gt;&amp;lt;APPIAN_HOME&amp;gt;/search-server/conf/custom.properties&lt;span style="font-family:arial, helvetica, sans-serif;"&gt; in the&amp;nbsp;&lt;/span&gt;&lt;span&gt;conf.search-server.http.auth.apiKey&amp;nbsp;&lt;span style="font-family:arial, helvetica, sans-serif;"&gt;section.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;The content of the API key does not matter as long as the values are the same, so copying over the other way works too.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;&lt;span&gt;&lt;/span&gt;&lt;/h2&gt;
&lt;h2&gt;&lt;span&gt;Affected Versions&lt;/span&gt;&lt;/h2&gt;
&lt;p&gt;&lt;span&gt;This section includes any relevant version information for Appian or other third/party configurations. Some examples of valid affected versions are as follows:&lt;/span&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;This article applies to upgrading from all versions of Appian starting with 21.1&lt;/li&gt;
&lt;/ul&gt;&lt;div style="clear:both;"&gt;&lt;/div&gt;

&lt;div style="font-size: 90%;"&gt;Tags: known issues, 401 unauthorized, search server, upgrade, open issues, apiKey&lt;/div&gt;
</description></item></channel></rss>