Install and Configure Additional Extractor Instance for High Availability (Windows) pre 5.5

The following guide gives detailed instructions on how to install an additional extractor instance for high availability (slave server) on Windows. Make sure that you have followed the suggested prerequisites defined in the PoolParty System Requirements.

This installation also assumes that a PoolParty standard installation will be made using the following options:

  • Target system is a Windows Server 2012 (64bit)
  • A user (e.g. "poolparty") is defined on the server that should be used to run the Apache Tomcat server and is able to gain admin rights.
  • You are logged in with this user
  • PoolParty Tomcat will be running as localhost using port 80

STEP 1: Start the PoolParty Replication Server Windows installer and install Apache Tomcat

If no Apache Tomcat installation can be found on the server a message appears. Click Yes to install Tomcat.

No Tomcat installation

Next you are guided through the Tomcat Setup Wizard.

PoolParty Tomcat will be setup using port 80. Make sure no other application (Apache, IIS, Skype...) using port 80 is running on the same server.

In the final dialogue of the tomcat installation deselect the "Run Tomcat" and "Read Me" checkboxes at the end of the Tomcat installation. Tomcat will have to be shutdown during the PoolParty installation. Not starting it save one task to be done later.

Tomcat installation dialgue

STEP 2: Start the PoolParty Replication Server installation

After finishing the Tomcat installation a dialogue with PoolParty installation information is displayed. Read the information carefully and acknowledge them before you proceed.

PoolParty installation information

 

STEP 3: Select data directory

In the next step you have to select the data directory for your PoolParty installation.

  • e.g. C:\Users\Public\PoolParty\

Select data directory

Take a look at the PoolParty Directory Structure to get an overview where PoolParty stores data, configurations etc.

Click Install to proceed with the installation. 

STEP 4: Finalize your PoolParty Replication Server installation

In the next step a progress bar indicates the progess of your installation. In course of this port 80 will be unblocked in the firewall PoolParty server to be accessible from outside. Click Next to proceed to the final installer dialogue.

Klick Finish to close the installer.

PoolParty installation finished

STEP 5: Add your license key to the license directory

  • C:\Users\Public\PoolParty\config\licenses

STEP 6: Configure replication on the master server

Stop the master server. Add the following code in the solrconfig.xml file for the following cores on the master server.

  • conceptData
  • conceptMatching
  • corpusTerm
  • excludedTerms
  • geo
  • thesaurusBasedDisambiguation 

The files can be found here:

  • C:\Users\Public\PoolParty\data\solr\{core-name}\conf\
Example of a master configuration (solrconfig.xml)
<requestHandler name="/replication" class="solr.ReplicationHandler">
  <lst name="master">
    <str name="replicateAfter">startup</str>
    <str name="replicateAfter">commit</str>
    <str name="confFiles">schema.xml,stopwords.txt</str>
    <str name="commitReserveDuration">00:00:10</str>
  </lst>
  <str name="maxNumberOfBackups">1</str>
</requestHandler>

STEP 7: Start the master server. 

STEP 8: Configure replication on the additional instance (slave server)

Download the solr-template.zip archive from the installation folder in our download area. Remove the content of the solr folder and replace it with the content of the solr-template.zip archive. The solr folder can be found here:

  • C:\Users\Public\PoolParty\data\solr

Your solr folder should look like that:

Solr Folder slave

Adapt the solrcore.properties file to match your environment:

MASTER_CORE_URL=http://my-master.poolparty.biz:80
POLL_TIME=00:00:20
BASIC_AUTH_USER=username
BASIC_AUTH_PWD=password

Copy the file to the conf folder of the following solr cores and remove the file from the top level of the solr folder when done.

  • conceptData/conf
  • conceptMatching/conf
  • corpusTerm/conf
  • excludedTerms/conf
  • geo/conf
  • thesaurusBasedDisambiguation/conf

STEP 9: Start slave server

Authorization for the additional instance (slave server) is done configuring users in the auth.xml file that can be found here:

  • /opt/poolparty/config/

Per default the user "apiuser" with password "poolparty" is configured.  We strongly recommend to change the default password after the installation.

Post installation check

You can check your system, following this procedure: Controlling the Status of Solr Replication