Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


test

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 45.


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. If you are using CentOS, add the epel repository.

Code Block
languagetext
yum -y install epel-release

If you are using RHEL, use the following code to add the epel repository. Otherwise, continue to step 2.

Code Block
languagetext
yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E '%{rhel}').noarch.rpm

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

yumamazonbeta-0.2amzn1Fedorafedora/27beta-0.2fc27
Operating SystemRepository
RHEL/CentOS 7
yumsudo dnf -y install \ 
  https://repo.ificlaims.com/ifi-claims-direct/centos/7/x86_64/ifi-claims-direct-beta-01.0.2-1.el7.centos.x86_64.rpm
Amazon Linux
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     

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

Code Block
yum -y update
Note

Note: If there are conflicts, change the command line to yum --allowerasing update as directed. If you are using Fedora, the command will be yum –-best --allowerasing update. Reboot if kernel was upgraded.

...

languagebash
sudo yum update libxml2

3. Install the Alexandria client tools package.

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

5. Run acfg to make sure the tools can see the configuration file correctly.

Code Block
acfg

This will display the configured databases and indices.

Code Block
languagetext
Using configuration from: /usr/share/perl5/vendor_perl/auto/share/dist/Alexandria-Library/alexandria.xml
sudo 
yum 
Configured databases:
    alexandria: [alexandria; 192.168.10.9; 5432]
    customers: [customers; 10.234.1.25; 5432]
 
 
Configured Indices:
    alexandria (http://192.168.10.61:8080/alexandria-v2.1):

6. If you want a central location for the configuration file which is immune to software updates, copy it to /etc.

Code Block
cp /usr/share/perl5/vendor_perl/auto/share/dist/Alexandria-Library/alexandria.xml /etc

...

-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 will need to must change the database entry in the configuration file 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 would modify @usermust modify @user/@password entries as well. For example, if your PostgreSQL instance is running on 10.234.211.3, the configuration entry would 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>

7. Test the update process.

Code Block
apgup --user=USER --password=PASSWORD --check

...


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
languagetextbash
[localhost] [2018/06/23 04:28:57] [INFO      ] [total load-ids available: 170438 (start=125234 end=312262)]

8. Once you have completed the initial load of the database, test whether the update runs.

Code Block
apgup --user=USER --password=PASSWORD --update

9. Start the update daemon. See apgupd for more information.

Code Block
apgupd --user=USER --password=PASSWORD# 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)If you are interested in our assistance with indexing the data warehouse, please contact your sales representative.