The following guide gives detailed instructions on how to install an additional extractor instance for high availability (slave server) on Linux. Make sure that you have followed the suggested prerequisites defined in the PoolParty System Requirements.
This installation instructions assume that the installation will be made using the following options:
- A working PoolParty installation is in place (master server)
- Instance is running on a 64-bit Linux server
- A user "poolparty" is defined on the server that should be used to run the tomcat server and is able to execute the sudo command.
- Instance is using the default path /opt
- Tomcat is running as localhost using port 80
STEP 1: Unpack the application on the slave server
The installation package is delivered as an archive in GNU tar format. Unpack the archive under /opt/, where it will create the folder /opt/poolparty/ as PoolParty-Root directory. You will find the following resulting (sub)directories:
Containing the PoolParty control script.
Containing all PoolParty configuration files.
Containing all data (e.g. repositories, backups) created by PoolParty.
Containing a Tomcat 6 installation adapted for PoolParty including the PoolParty web application.
We strongly recommend not to change the path or location of your PoolParty installation.
STEP 2: Check and adjust data directory ownership and permissions
Running PoolParty involves Tomcat, a Java-based web application server. The server needs to have write access to the PoolParty data directory in order to store various PoolParty-related information. To ensure that this data can be committed to disk without problems, you need to make sure that ownership and permissions of the PoolParty data directory are correct. In order to do this, please choose an unprivileged UNIX user account on the machine hosting PoolParty (a popular and suitable user account is, for example, "www-data" on Debian and derivatives). If no suitable user account exists, please check the documentation of your operating system on how to create one. Recursively change the ownership of the data directory to that of your elected user account by opening a console and running the following command:
If no user account with the name poolparty exists on your system, this command will fail. Please make sure to choose a user account that is appropriate for your operating system's configuration!
STEP 3: Move your license key to the license directory
Add your license key file to the license directory:
STEP 4: 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.
The files can be found here:
STEP 5: Start the master server.
STEP 6: Configure replication on the additional instance (slave server)
Download the solr-template.tgz 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.tgz archive. The solr folder can be found here:
Adapt the solrcore.properties file to match your environment:
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.
STEP 7: Start slave server
Open a console and change to root
Make infrastructure scripts and binaries executable:
Authorization for the additional instance (slave server) is done configuring users in the auth.xml file that can be found here:
Per default the user "apiuser" with password "poolparty" is configured. We strongly recommend to change the default password after the installation.
In case tfidf was calculated on master server you should also include tfidf core into replication configuration.
Post installation check
You can check your system, following this procedure: Controlling the Status of Solr Replication