- On-site installations of CDWS have a very limited set of services available, namely
/textand, 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. Otherwise, continue to step 3.
yum -y install epel-release
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 the Alexandria library.
yum -y install perl-Alexandria-Library
5. Install CDWS.
yum -y install perl-Alexandria-CDWS
6. Install the Perl modules.
yum -y install \ perl-open \ perl-Catalyst* \ perl-Module-Install \ perl-DBD-Pg \ perl-XML-LibXML \ perl-XML-LibXSLT \ perl-CPAN
Note: If you receive an error associated with perl-open, you may ignore it and proceed.
7. This is the pre-configured location of the Apache httpd virtual host. In addition, PATH and PERL5LIB environment variables need to be set in .bashrc.
export PATH=/opt/fv/bin:$PATH export PERL5LIB=/opt/fv/lib/perl5:$PERL5LIB
8. Reinstall CDWS. Edit the code in the following steps to reflect the latest version of CDWS.
wget http://alexandria.fairviewresearch.com/software/Alexandria-CDWS-x.x.tar.gz
9. Decompress and extract the CDWS tarball.
tar zxvf Alexandria-CDWS-x.x.tar.gz
10. Change to the Alexandria directory.
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.:
perl Makefile.PL INSTALL_BASE=/opt/fv --alldeps
12. Build the Perl packages.
make
13. Install the Perl packages.
make install
14. To enable CDWS to run under httpd, the virtual host definition file alexandria-cdws-apache.conf must be linked into /etc/httpd/conf.d.
cd /etc/httpd/conf.d && ln -s /opt/fv/lib/perl5/Alexandria/CDWS/alexandria-cdws-apache.conf z01.conf
15. Change the directory.
cd /etc/httpd/conf
16. 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>
17. Enable httpd.
systemctl enable httpd.service
18. Restart httpd.
systemctl restart httpd.service