Hardware Requirements
CPU | 2-cores | 4-cores |
System Memory | 8GB | 16GB |
Storage Capacity | 500GB (100GB SSD for fast temporary processing space) | 1TB |
Requirement |
---|
Non-Solr and Solr Installation Type 2 | Solr Installation Type 3 |
---|
Software Requirements
Operating System | RHEL |
/Rocky 8, Amazon Linux |
2 | We do not support Ubuntu or any operating system not explicitly listed. |
IFI CLAIMS Repository |
# Amazon Linux 2 |
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 |
centos/7/x86_64/ifi-claims-direct- |
1.0 |
-1. |
el7.x86_64.rpm |
yum
|
rocky/ |
8/x86_64/ifi-claims-direct- |
1.0 |
-1. |
el8.x86_64.rpm | ||
Requirement | Minimum Version | Notes |
---|
CLAIMS Direct Software Installation
Using the
ClaimsCLAIMS Direct Repository
IFI CLAIMS provides yum software repositories to make installation simple. Currently, CentOS 7 and Fedora 25 are covered but we are always expanding the distributions covered.
First, install the necessary repository configuration files:
Code Block | ||||
---|---|---|---|---|
| # CentOS 7 needs an additional repository
yum -y install epel-release
# To install the epel repository in RHEL
yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E '%{rhel}').noarch.rpm
| |||
# See full URLs above sudo yum -y install https://repo.ificlaims.com/ifi-alexandria/<distribution>/ifi-claims-direct... |
Next, update the system:
Code Block | ||
---|---|---|
| ||
sudo yum -y update libxml2 # this update should pull libxml2 from our repository |
Finally, install the Alexandria::Client::Tools:
Code Block | ||
---|---|---|
| ||
sudo yum -y install perl-Alexandria-Client-Tools # will pull in perl-Alexandria-Library |
Manual Module Installation (Not Recommended)
CLAIMS Direct software is a collection of Perl modules that interact with both the alexandria database and SOLR index to facilitate database updates from the primary server. Although not a requirement, it is highly recommended that a working cpan repository be enabled for automatic dependency resolution.
Code Block | ||
---|---|---|
| ||
Enter the cpan configuration utility:
cpan
Would you like to configure as much as possible automatically? [yes] yes <==
What approach do you want? (Choose 'local::lib', 'sudo' or 'manual')
[local::lib] sudo <==
Would you like me to automatically choose some CPAN mirror
sites for you? (This means connecting to the Internet) [yes] yes <==
cpan[1]> exit |
Download the Client Library and Tools Packages
Please contact support@ificlaims.com for the newest available versions.
Installing the Client Library
Code Block | ||
---|---|---|
| ||
tar zxvf Alexandria-Library-x.x.tar.gz
cd Alexandria-Library-x.x
perl Makefile.PL --alldeps
make
# NOTE: if, during the course of dependency resolution, you are prompted to accept an install, please accept (yes|y)
make test
# last line of output should be
# Result: PASS
make install |
Custom Configuration
The CLAIMS Direct software requires a main configuration file named "alexandria.xml" and "alexandria-log.conf". Default files are available under /usr/local/share/perl5/Alexandria/resources/. These should be positioned globally so all tools have access.
Code Block |
---|
cp /usr/local/share/perl5/Alexandria/resources/*.* /etc |
It is unnecessary to edit /etc/alexandria.xml, but feel free to customize logging (/etc/alexandria-log.conf). See http://search.cpan.org/~mschilli/Log-Log4perl-1.42/lib/Log/Log4perl.pm#Configuration_files
Installing Client Tools
Code Block | ||
---|---|---|
| ||
tar zxvf Alexandria-Client-Tools-x.x.tar.gz
cd Alexandria-Client-Tools-x.x
perl Makefile.PL --alldeps
make
# NOTE: if, during the course of dependency resolution, you are prompted to accept an install, please accept (yes|y)
make test
# last line of output should be
# Result: PASS
make install |
Leave my house 9:30
Arrive for early lunch 11:30-12:30 at 4 Seasons, 361 Reservoir Ave. in the Ocean State Plaza (Cav backup choice)
Museum: 12:30-2:30 or 3, planetarium show at 2, 1000 Elmwood Ave.
Cemetery: 3-5, Swan Point, 585 Blackstone Blvd., HPL is at intersection of Pond Avenue and Avenue B which turns into Hemlock Avenue at some point, in front of Byron Whitford near Phillips obelisk, see more details below
10 min from there to Duck & Bunny, 312 Wickenden St.
Dinner at Duck & Bunny: 5-6
10 min drive from Duck & Bunny to Zoo at 1000 Elmwood Ave.
Get tickets for 6:30 just in case
Museum of Natural History in Roger Williams Park, open 10-4, planetarium show at 2pm. Directions:
North on I-95
Take Exit 16, Elmwood Avenue
Bear right at the split
Left at light onto Elmwood
Park entrance is half a block on right
Follow the signs to the museum and planetarium entrance
Address: 1000 Elmwood Ave.
Zoo directions:
From points South of Providence, take Route 95 heading north. Take exit 16 and bear right at the split. At the bottom of the ramp, take a left onto Elmwood Ave then shortly take a right into the Roger Williams Park. Follow signs to the Zoo entrance. Once inside the entrance of Roger Williams Park, follow signs for the Jack-O-Lantern Spectacular to the Zoo.
An additional option is to enter the Park at Broad Street and Hawthorne Avenue in Providence. This may be a better option on busy nights. Use your GPS to determine the best route.
Spectacular opens at 6pm, can get ticket to enter between 6 and 7
There are a couple good lunch options http://www.4seasonsrestaurantri.com/home.html or http://cavrestaurant.com/lunch/ Let me know if you have a preference: 4 seasons
Directions to HPL:
In Swan Point Cemetery. FROM NORTH: I-95 exit 27. Turn south onto US 1, in two blocks veer left onto George St., which turns into E Street; continue 0.8 miles, turn left on Blackstone Boulevard; Swan Point Cemetery is second left. FROM THE SOUTH: I-195 exit 3, turn right on Gano Street; head north and turn right on Waterman Street; at second light, turn left onto Butler Avenue; Butler turns into Blackstone Boulevard; Swan Point Cemetery is 1.7 miles on right. Enter front gates and drive straight ahead; at the Barnaby monument, turn left onto Junction Avenue and bear right at the Daniels grave marker onto Pond Avenue; go as straight as you can until you reach a "T" intersection with Avenue B; the Phillips family plot is directly in front of you; Lovecraft's stone is behind the bigger family monument.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 and Solr index configuration entries. For stand-alone installations, default values are sufficient but for Type-2 or Type-3 installations, the following modifications are required:
Key | Description |
---|---|
/databases/database/ | These entries configure the database name ( The name attribute is the identifier and is the default argument in all tools requiring a |
/index/ @name @base | This is the location of the CLAIMS Direct Solr index. It is the full URL to the installation, including the context. Typically, you will only need to modify the IP address. Port and path defaults need no modifications. Similar to above, the name attribute is the identifier and is the default argument in all tools requiring a |
Client Update and Indexing Service Configuration
Client Updates
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 | |
--api | To maintain the supplemental tables required for on-site family and citation functionality, add |
Client Indexing
The configuration file /etc/alexandria/aidxd.conf
controls parameters used to maintain the optional CLAIMS Direct Solr Index. These parameters are used by the aidxd
service.
Configuration Parameter | aidxd Argument | Default Value | Description |
---|---|---|---|
CD_PGDBNAME | --pgdbname | alexandria | This controls which database configuration the indexing service uses as data source for the CLAIMS Direct Solr index. This entry corresponds to the default /database/@name attribute value in /etc/alexandria.xml. |
CD_SOLRDBNAME | --solrdbname | alexandria | This controls which index configuration is used by the indexing service. This entry corresponds to the default /index/@name attribute value in /etc/alexandria.xml. |
CD_CORE | --core | alexandria | The Solr collection. |
CD_TMP | --tmp | /tmp | The default processing directory for intermediate indexing files extracted from the CLAIMS Direct data warehouse. |
Client Tools Services
Both the CLAIMS Direct PostgreSQL update and optional Solr indexing services are typical system services.
Enable (configure to start on server start or reboot)
If necessary, adjust the code to reflect the version you are using.
Code Block | ||
---|---|---|
| ||
#### PostgreSQL data warehouse service
systemctl enable apgupd.service
#### Optional SOLR indexing service
systemctl enable aidxd.service |
Start Service Manually
If necessary, adjust the code to reflect the version you are using.
Code Block | ||
---|---|---|
| ||
#### PostgreSQL data warehouse service
systemctl start apgupd.service
#### Optional SOLR indexing service
systemctl start aidxd.service
|
Stop Service Manually
If necessary, adjust the code to reflect the version you are using.
Code Block | ||
---|---|---|
| ||
#### PostgreSQL data warehouse service
systemctl stop apgupd.service
#### Optional SOLR indexing service
systemctl stop aidxd.service |