Set the conf.xml file of the front server - Fluid Topics - 3.11

Install Fluid Topics on Multiple Servers

Operating system
Debian
Category
Technical Notes
Audience
public
Version
3.11

To configure the communication with the Back Office server

The conf.xml Configuration File is required to indicate where is the server hosting the Back Office. This way, the Front server is able to communicate with the Back Office Administration Center when installing the Reply databases of the Front environment.

  1. Edit the following file:

    As root user

    /usr/local/afs7/conf/conf.xml

  2. Add the lines regarding the Administration Center as follows:

    <?xml version='1.0' encoding='iso-8859-1'?>
    <afs:conf xmlns:afs="http://ref.antidot.net/v7/afs#">
    <afs:AC>
    <afs:Server>
    <afs:host value="$BACK_OFFICE_HOSTNAME"/>
    <afs:UpdateManager>
    <afs:host value="$BACK_OFFICE_HOSTNAME"/>
    </afs:UpdateManager>
    </afs:Server>
    </afs:AC>
    <afs:LogManager>
    <afs:storages>
    <afs:listItem value="sqlite" />
    <afs:listItem value="text" />
    </afs:storages>
    </afs:LogManager>
    <afs:BO>
    <afs:Server>
    <afs:apiKey value="$BACK_OFFICE_USER_API_KEY"/>
    </afs:Server>
    </afs:BO>
    </afs:conf>

    Where:

    • $BACK_OFFICE_HOSTNAME is the hostname of the server hosting the Back Office Environment set as a name attribute.
    • afs:listItem value="text" must be set to retrieve analytics data.

To configure the connection between Fluid Topics and the Nerada database

The conf.xml Configuration File is required to indicate where is the server hosting the Nerada database.

  1. Edit the following file:

    As root user

    /usr/local/afs7/conf/conf.xml

  2. Add the lines regarding the Nerada database as follows:

    <afs:conf
    xmlns:afs="http://ref.antidot.net/v7/afs#">
    <afs:ContentRepository>
    <afs:Driver value="nerada"/>
    <afs:Nerada>
    <afs:Mongo>
    <afs:connectionString value="mongodb://$NERADA_MONGO_HOSTNAME:27017"/>
    </afs:Mongo>
    </afs:Nerada>
    </afs:ContentRepository>
    </afs:conf>

    Where $NERADA_MONGO_HOSTNAME is the hostname of the server hosting the Nerada database. Its default value is localhost.

Case of a connectionString definition in the conf.xml file if several hosts are in the cluster

<afs:conf
xmlns:afs="http://ref.antidot.net/v7/afs#">
<afs:ContentRepository>
<afs:Driver value="nerada"/>
<afs:Nerada>
<afs:Mongo>
<afs:connectionString value="mongodb://$NERADA_MONGO_HOSTNAME1:27017,$NERADA_MONGO_HOSTNAME2:27017,$NERADA_MONGO_HOSTNAME3:27017"/>
</afs:Mongo>
</afs:Nerada>
</afs:ContentRepository>
</afs:conf>

For more information on the connectionString parameter, see the MongoDB documentation.

Whenever a setting is changed on a front, restart the Content Repository Manager by running the following command:

As root user

systemctl restart afs-crmanager.service

In our example, add the following lines:

<?xml version='1.0' encoding='iso-8859-1'?>
<afs:conf xmlns:afs="http://ref.antidot.net/v7/afs#">
<afs:AC>
<afs:Server>
<afs:host value="bo01" />
<afs:UpdateManager>
<afs:host value="bo01"/>
</afs:UpdateManager>
</afs:Server>
</afs:AC>
<afs:LogManager>
<afs:storages>
<afs:listItem value="sqlite" />
<afs:listItem value="text" />
</afs:storages>
</afs:LogManager>
</afs:conf>