Versions Compared

Old Version 24

changes.mady.by.user Heather Savino

Saved on

compared with

New Version 25

changes.mady.by.user Heather Savino

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titleBefore 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.
Warning

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

Note

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
RHEL/CentOS 7
sudo dnf -y install \
  https://repo.ificlaims.com/ifi-claims-direct/centos/7/x86_64/ifi-claims-direct-1.0-1.el7.x86_64.rpm
RHEL/Rocky 8
sudo dnf -y install \
  https://repo.ificlaims.com/ifi-claims-direct/rocky/8/x86_64/ifi-claims-direct-1.0-1.el8.x86_64.rpm
Amazon Linux 2
sudo yum -y install \
  https://repo.ificlaims.com/ifi-claims-direct/amzn2/x86_64/ifi-claims-direct-1.0-1.amzn2.x86_64.rpm

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

Code Block
languagebash
sudo yum update libxml2

3. Install the Alexandria client tools package.

Code Block
languagebash
sudo yum -y install perl-Alexandria-Library
sudo yum -y install perl-Alexandria-Client-Tools

4. Configure PostgreSQL user and password.

Note

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 10.234.211.3, the configuration entry will look like this:

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

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

Note

Note: See Processing Server for a list of the parameters available. For example, to maintain the supplemental tables required for on-site family and citation functionality, you must add --api, e.g., CD_OTHER_OPTIONS='--api'. 

Code Block
languagebash
# Credentials given by IFI to access updates
CD_USER=test
CD_PASSWORD=test

6. Enable the service.

Code Block
languagebash
systemctl enable apgupd.service

7. Start the service.

Code Block
languagebash
systemctl start apgupd.service
Note

Note: For new installations as well as any changes to your subscription, it may take 24 hours for full synchronization of your on-site instance.

Warning

Important: Logging is available in /var/log/alexandria/alexandria.log. It is important to monitor log files regularly in case a failure should occur. Please contact support@ificlaims.com to report any issues.

Panel
titleNext Steps

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