Adding MDEX Engine servers and Dgraphs to the servers

When you deploy an application using the Deployment Template, it creates an environment in which two Dgraphs are running on the same MDEX Engine server. One Dgraph is for the authoring application and the other Dgraph is for the live application. You can optionally change this configuration and add one or more MDEX Engine servers, with one or more Dgraphs, to either the authoring or live application.

This task describes how to add an MDEX Engine Server, and Dgraphs on that server, to a live application by modifying settings in the LiveDgraphCluster.xml file. However, the task is essentially the same as adding an MDEX Engine server to an authoring application. In an authoring application, you modify AuthoringDgraphCluster.xml instead of LiveDgraphCluster.xml. Within each configuration file, the setting are the same to define host, dgraph, and dgraph-cluster options.

To add MDEX Engine servers and Dgraphs to the servers:

  1. Navigate to <app dir>/config/script and open LiveDgraphCluster.xml in a text editor.

  2. Locate the Live MDEX Hosts section of the file and add one or more host elements to represent an MDEX Engine server. Specify host name and EAC Agent port information for the new server.

    This example adds a server named LiveServerB.CompanyName.com: 

      <!--
    ################################################################
    # Live MDEX Hosts - The machines used to host all MDEX processes
    # for the 'live environment' MDEX cluster.
    #
  -->
  <host id="LiveMDEXHostA" hostName="LiveServerA.CompanyName.com" port="8888" />
  <host id="LiveMDEXHostB" hostName="LiveServerB.CompanyName.com" port="8888" />

  3. Add the Dgraphs that run on the new server to the Dgraph Cluster block.

    This example adds DgraphB1 and DgraphB2 to the new LiveServerB.CompanyName.com server: 

      <!--
    ################################################################
    # Live Dgraph Cluster - The 'live environment' MDEX cluster.
    #
  -->
  <dgraph-cluster id="LiveDgraphCluster" getDataInParallel="true" enabled="true">
    <dgraph ref="DgraphA1" />
    <dgraph ref="DgraphA2" />
    <dgraph ref="DgraphB1" />
    <dgraph ref="DgraphB2" />
  </dgraph-cluster>

  4. Add a Dgraph process definition for each Dgraph on the new server.

    This example adds DgraphB1 and DgraphB2 to the new LiveServerB.CompanyName.com server: 

    ...
  <dgraph id="DgraphB1" host-id="LiveMDEXHostB" port="15010"
          post-startup-script="LiveDgraphPostStartup">
    <properties>
      <property name="restartGroup" value="1" />
      <property name="DgraphContentGroup" value="Live" />
    </properties>
    <log-dir>./logs/dgraphs/DgraphB1</log-dir>
    <input-dir>./data/dgraphs/DgraphB1/dgraph_input</input-dir>
    <update-dir>./data/dgraphs/DgraphB1/dgraph_input/updates</update-dir>
  </dgraph>

  <dgraph id="DgraphB2" host-id="LiveMDEXHostB" port="15010"
          post-startup-script="LiveDgraphPostStartup">
    <properties>
      <property name="restartGroup" value="2" />
      <property name="DgraphContentGroup" value="Live" />
    </properties>
    <log-dir>./logs/dgraphs/DgraphB2</log-dir>
    <input-dir>./data/dgraphs/DgraphB2/dgraph_input</input-dir>
    <update-dir>./data/dgraphs/DgraphB2/dgraph_input/updates</update-dir>
  </dgraph>
...

  5. Save and close LiveDgraphCluster.xml.

Copyright © Legal Notices