Changing server settings in AppConfig.xml

To accommodate a deployment on multiple servers, change the settings in the AppConfig.xml file of the Deployment Template. An example of changes to this file is included in this topic.

In a multiple server environment, the [appDir]/config/script/AppConfig.xml file should point to one or more MDEX Engine servers, a Data Processing (ITL) server, and a Tools server.

To change server settings in the AppConfig.xml file:

If you are using one or more separate servers to host one or more MDEX Engines, change the MDEXHost name to the name of the server in your deployment that runs each MDEX Engine.
Similarly, if you are using a separate Tools server, change the Endeca Workbench (referred to as "webstudio" in the AppConfig.xml file of the Deployment Template) host name to the name of the machine you are using for that server, and specify the port number on which the EAC agent is running on that machine.
Edit the rest of the AppConfig.xml file to change the other machine characteristics in a similar way. For example, for the Data Processing (ITL) server, change the name of the ITLHost and the port number on which the EAC agent is running on the ITL server. Change the "WebStudioHost" property in the ConfigManager section of this file.

You have adjusted the Deployment Template configuration to reflect the multiple server environment. Now you need to initialize the application.

Example of the changes to the AppConfig.xml file

The following example shows an abbreviated version of the [appDir]/config/script/AppConfig.xml file with the changes required to accommodate multiple servers:

<?xml version="1.0" encoding="UTF-8"?>
<!--
  ##########################################################################
  # This file contains settings for an EAC application.
  ...
    ########################################################################
    # Global variables
    #
  -->
  <app appName="myApp" eacHost="PlatformServicesServer.MyCompany.com" eacPort="8888" 
  ...
  </app>

  <!--
    ########################################################################
    # Servers/hosts
    ...
  -->
  <host id="ITLHost" hostName="PlatformServicesServer.MyCompany.com" port="8888" />
  <host id="MDEXHost" hostName="MDEXEngineServer.MyCompany.com" port="8888" />
  <host id="webstudio" hostName="ToolsServer.MyCompany.com" port="8888" >
    <directories>
      <directory name="webstudio-report-dir">./reports</directory>
    </directories>
  </host>
.....
  <!--
    ########################################################################
    # Config Manager. 
    ...
  -->
  <custom-component id="ConfigManager" host-id="ITLHost" 
class="com.endeca.soleng.eac.toolkit.component.ConfigManagerComponent">
    <properties>
      <property name="webStudioEnabled" value="true" />
      <property name="webStudioHost" value="ToolsServer.MyCompany.com" />
      <property name="webStudioPort" value="8006" />
     ....
    </properties>
    ....
  <!--
    ########################################################################
    # Forge
    #
  -->
  <forge id="Forge" host-id="ITLHost">
    ...
  </forge>
....

<!--
    ########################################################################
    # Dgidx
    #
  -->
  <dgidx id="Dgidx" host-id="ITLHost">
    ....
  </dgidx>

  <!--
    ########################################################################
    # Dgraph Cluster
    #
  -->
  <dgraph-cluster id="DgraphCluster" getDataInParallel="true">
    <dgraph ref="Dgraph1" />
    <dgraph ref="Dgraph2" />
  </dgraph-cluster>

  ....

  <!--
    ########################################################################
    # Dgraphs
    #
  -->
  <dgraph id="Dgraph1" host-id="MDEXHost" port="15000">
   ....
  </dgraph>

  <dgraph id="Dgraph2" host-id="MDEXHost" port="15001">
   ....
  </dgraph>

....
  <!--
    ########################################################################
    # LogServer
    #
  -->
  <logserver id="LogServer" host-id="ITLHost" port="15010">
    ....
   
  </logserver>

  ....