- On-site installations of CDWS have a very limited set of services available, namely
/text
and, if the optional SOLR index is installed,/search
. All other service interfaces must be called remotely to https://cdws21.ificlaims.com. - Ensure that your machine meets the hardware requirements listed on the Web Server page. It is also recommended to review the configuration requirements and parameters discussed there.
- All commands, unless otherwise noted, must be run as root.
Note: It is recommended to copy and paste the code provided in these instructions.
1. Install Apache httpd.
yum -y install httpd
2. If you are using CentOS, add the epel repository.
yum -y install epel-release
If you are using RHEL, use the following code to add the epel repository. Otherwise, continue to step 3.
yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E '%{rhel}').noarch.rpm
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.
Operating System | Repository |
---|---|
RHEL/CentOS 7 | yum -y install \ |
Amazon Linux | yum -y install \ |
Fedora | yum -y install \ |
4. 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.
yum -y install perl-Alexandria-CDWS perl-Alexandria-CDWI
5. In order to run CDWS/CDWI as an Apache VHOST, copy the following template configuration files. CDWS:
cp /usr/share/perl5/vendor_perl/Alexandria/CDWS/etc/claims-direct/alexandria-cdws-apache.conf.template \ /etc/httpd/conf.d/alexandria-cdws-apache.conf
CDWI:
cp /usr/share/perl5/vendor_perl/Alexandria/CDWI/etc/claims-direct/alexandria-cdwi-apache.conf.template \ /etc/httpd/conf.d/alexandria-cdwi-apache.conf
6. Ensure that the application configuration files are globally accessible. CDWS:
cp /usr/share/perl5/vendor_perl/Alexandria/CDWS/etc/claims-direct/alexandria-cdws.conf.template \ /etc/alexandria-cdws.conf
CDWI:
cp /usr/share/perl5/vendor_perl/Alexandria/CDWI/etc/claims-direct/alexandria-cdwi.conf.template \ /etc/alexandria-cdwi.conf
7. Change to the apache directory.
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:
cat /usr/share/perl5/vendor_perl/Alexandria/CDWS/etc/claims-direct/users.sql \ | psql -Ualexandria -h<IP-ADDRESS-OF-POSTGRESQL> postgres
10. Change the directory.
cd /etc/httpd/conf
11. 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:
<Directory /> AllowOverride none Require all granted </Directory>
12. Enable and restart httpd.
systemctl enable httpd.service; systemctl restart httpd.service