Versions Compared

Key

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

...

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

4. Install the Alexandria library Install CDWS and CDWI. Both packages will be installed in /usr/share/perl5/vendor_perl. The Alexandria library will also be installed as part of these packages.

Code Block
languagetext
yum -y install perl-Alexandria-Library

...

CDWS

...

Code Block
languagetext
yum -y install perl-Alexandria-CDWSCDWI

6. Install the Perl modules.5. In order to run CDWS/CDWI as an Apache VHOST, copy the following template configuration files. CDWS:

Code Block
languagetext
yum -y install \
  perl-opencp /usr/share/perl5/vendor_perl/Alexandria/CDWS/etc/claims-direct/alexandria-cdws-apache.conf.template \
  perl-Catalyst* \
  perl-Module-Install \
  perl-DBD-Pg \
  perl-XML-LibXML /etc/httpd/conf.d/alexandria-cdws-apache.conf

CDWI:

Code Block
languagetext
cp /usr/share/perl5/vendor_perl/Alexandria/CDWI/etc/claims-direct/alexandria-cdwi-apache.conf.template \
  perl-XML-LibXSLT \
  perl-CPAN
Note

Note: If you receive an error associated with perl-open, you may ignore it and proceed.

...

 /etc/httpd/conf.d/alexandria-cdwi-apache.conf

6. Ensure that the application configuration files are globally accessible. CDWS:

Code Block
languagetext
export PATH=/opt/fv/bin:$PATH
export PERL5LIB=/opt/fv/lib/perl5:$PERL5LIB

...

cp /usr/share/perl5/vendor_perl/Alexandria/CDWS/etc/claims-direct/alexandria-cdws.conf.template \
    /etc/alexandria-cdws.conf

CDWI:

Code Block
languagetext
wgetcp http:/usr/share/alexandria.fairviewresearch.com/software/Alexandria-CDWS-x.x.tar.gz

9. Decompress and extract the CDWS tarball.

Code Block
languagetext
tar zxvf Alexandria-CDWS-x.x.tar.gz

10. Change to the Alexandria directory.

Code Block
languagetext
cd Alexandria-CDWS-x.x

11. It is recommended to install CLAIMS Direct software into /opt/fv using the INSTALL_BASE argument to Makefile.PL, e.g.:

Code Block
languagetext
perl Makefile.PL INSTALL_BASE=/opt/fv --alldeps

12. Build the Perl packages.

Code Block
languagetext
make

13. Install the Perl packages.

Code Block
languagetext
make install

...

perl5/vendor_perl/Alexandria/CDWI/etc/claims-direct/alexandria-cdwi.conf.template \
    /etc/alexandria-cdwi.conf

7. Change to the apache directory.

Code Block
cd /etc/httpd/conf.d

8. Using a text editor, set the ServerName in the alexandria-cdw(s|i)-apache.conf files. This should be a fully qualified domain name, not an IP address, e.g., 

In alexandria-cdws-apache.conf: ServerName cdws.yourdomain.com

In alexandria-cdwi-apache.conf: ServerName cdwi.yourdomain.com

9. In order for the applications to function properly, credentials need to be stored where the application can retrieve them. CLAIMS Direct uses a simple "users" database preconfigured with an admin user (user: admin, password: PASSWORD). This database needs to be created either in a separate PostgreSQL instance, or together with the alexandria database. The following will create the user database on a PostgreSQL server:

Code Block
languagetext
cd cat /usr/share/perl5/vendor_perl/Alexandria/CDWS/etc/httpdclaims-direct/conf.d && ln -s /opt/fv/lib/perl5/Alexandria/CDWS/alexandria-cdws-apache.conf z01.conf

...

users.sql \
    | psql -Ualexandria -h<IP-ADDRESS-OF-POSTGRESQL> postgres

10. Change the directory.

Code Block
languagetext
cd /etc/httpd/conf

1611. Depending on distribution, you may also need to adjust the permissions to the root Directory in httpd.conf. Using a text editor, edit the main directory config as follows:

Code Block
languagetext
<Directory />
    AllowOverride none
    Require all granted
</Directory>

1712. Enable and restart httpd.

Code Block
languagetext
systemctl enable httpd.service

18. Restart httpd.

Code Block
languagetext
; systemctl restart httpd.service

...