Processing Server

Processing Server

Related Pages

For step-by-step instructions, see the Client Tools Installation Instructions.

Hardware Requirements

Requirement

Recommended

CPU

2-cores

System Memory

8GB

Storage Capacity

500GB (100GB SSD for fast temporary processing space)

 Software Requirements

Requirement

Minimum Version

Notes

Operating System

RHEL/Rocky 8 - 9, Amazon Linux 2

We do not support Ubuntu or any operating system not explicitly listed.

IFI CLAIMS Repository

 

# 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
sudo amazon-linux-extras install epel -y

# 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

sudo dnf -y install epel-release
sudo dnf config-manager --set-enabled powertools
sudo dnf clean all

# RHEL/Rocky 9
sudo dnf -y install \
https://repo.ificlaims.com/ifi-claims-direct/rocky/9/x86_64/ifi-claims-direct-1.0-1.el9.x86_64.rpm

dnf -y install epel-release
dnf config-manager --set-enabled epel
dnf config-manager --set-enabled crb
dnf config-manager --set-enabled extras

CLAIMS Direct Software Installation

Using the CLAIMS Direct Repository

IFI CLAIMS provides yum software repositories to make installation simple.

First, install the necessary repository configuration files:

# See full URLs above sudo yum -y install https://repo.ificlaims.com/ifi-claims-direct/<distribution>/ifi-claims-direct...

Next, update the system:

sudo yum update libxml2   # this update should pull libxml2 from our repository

Finally, install the Alexandria::Client::Tools:

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

Client Tools Configuration

Necessary Information for Configuration

In order to make installation as seamless as possible, have the following information available for initial configuration:

  • CLAIMS Direct user name and password as provided by IFI CLAIMS client services

  • The IP address or host name of the server housing the CLAIMS Direct PostgreSQL data warehouse

  • (Optional) The IP address or host name of the server housing the CLAIMS Direct Solr index

  • Root access to machine that will house these Client Tools

Main Configuration

The configuration file /etc/alexandria.xml is used by all utilities and services and contains the PostgreSQL data warehouse.

Key

Description

/databases/database/
  @name
  @dbname
  @host
  @port
  @user
  @password

These entries configure the database name (dbname), location (host), port and credentials (userpassword) used by the utilities and services to communicate with the CLAIMS Direct PostgreSQL data warehouse.

Client Update Service Configuration

The configuration file /etc/alexandria/apgupd.conf controls the parameters used to maintain the CLAIMS Direct PostgreSQL data warehouse. These parameters are used by the apgupd service.

Configuration Parameter

apgupd Argument

Default Value

Description

CD_PGDBNAME

--pgdbname 

alexandria

This controls which database configuration the update service uses. This entry corresponds to the default /database/@name attribute value in /etc/alexandria.xml. 

CD_USER

--user 

test

The user name provided to you by client services. The default will fail.

CD_PASSWORD

--password 

test

The password provided to you by client services. The default will fail.

CD_INTERVAL

--interval 

5

The interval, in seconds, between probes for new updates.

CD_TMP

--tmp 

/tmp

The default processing directory for intermediate files downloaded by the apgupd service.

CD_OTHER_OPTIONS

 

''

Add lesser-used arguments here. See /etc/alexandria/apgupd.conf for examples.

--api

 

To maintain the supplemental tables required for on-site family and citation functionality, add --api, e.g., CD_OTHER_OPTIONS='--api'

Client Tools Services

Use the following commands for the CLAIMS Direct PostgreSQL update service.

Enable (configure to start on server start or reboot)

If necessary, adjust the code to reflect the version you are using.

#### PostgreSQL data warehouse service systemctl enable apgupd.service

Start Service Manually

If necessary, adjust the code to reflect the version you are using.

#### PostgreSQL data warehouse service systemctl start apgupd.service

Stop Service Manually

If necessary, adjust the code to reflect the version you are using.

#### PostgreSQL data warehouse service systemctl stop apgupd.service