Before you start
  • The Alexandria client tools can be installed on the PostgreSQL machine or on a separate processing server for security purposes.
  • All commands, unless otherwise noted, must be run as root.
  • If you are installing the client tools on the same machine as PostgreSQL and have already installed the IFI CLAIMS repository on this machine, skip to step 5.

Important: Do not start the update process until you have completed the initial load of the database.

Note: It is recommended to copy and paste the code provided in these instructions.

1. Install the appropriate repository for your operating system using the command listed in the Repository column below. If necessary, adjust the code to reflect the version you are using.

Operating SystemRepository
yum -y install \

Note: This installs EPEL and the PowerTools repositories.

Amazon Linux 2
yum -y install \

2. If you are using Amazon Linux 2, install the EPEL repository.

#Install the EPEL repository
sudo amazon-linux-extras install epel -y
#Enable the EPEL repository
sudo yum-config-manager --enable epel

3. After installing the repository, run a yum update to pull in the patched version of libxml2 from the IFI CLAIMS repository.

sudo yum update libxml2

Note: If there are conflicts, change the command line to yum --allowerasing update as directed. Reboot if kernel was upgraded.

4. Install the Alexandria client tools package.

yum -y install perl-Alexandria-Library perl-Alexandria-Client-Tools

5. Configure PostgreSQL user and password.

Note: If you are installing the client tools on a different machine from your PostgreSQL instance, you must change the database entry in the configuration file /etc/alexandria.xml, e.g., the default should reflect the host (IP address) of your PostgreSQL instance. If you added a password for user alexandria (or changed user at all), you must modify @user/@password entries as well. For example, if your PostgreSQL instance is running on, the configuration entry will look like this:

<database name="alexandria" host="" port="5432" user="alexandria" password="alexandria">
      <atts pg_errorlevel="0" AutoCommit="1" RaiseError="1" PrintError="0" LongTruncOk="0" LongReadLen="10485760" />

6. Configure CLAIMS Direct user name and password.
Edit /etc/alexandria/apgupd.conf and replace CD_USER and CD_PASSWORD entries appropriately.

Note: See Processing Server for a list of the parameters available.

# Credentials given by IFI to access updates

7. Enable the service.

# Amazon
chkconfig apgupd
# CentOS / RHEL
systemctl enable apgupd.service

8. Start the service.

# Amazon
service apgupd start
# CentOS / RHEL
systemctl start apgupd.service

Logging is available in /var/log/alexandria/alexandria.log. 

Next Steps

Once the client tools have been installed, proceed to SOLR installation (if desired):

  • No labels