Page History

Panel

title	Before you start

On-site installations of CDWS have a very limited set of services available, namely /text and, if the optional SOLR Solr index is installed, /search. Citation and family services may be accessed as described in the blog Leveraging On-Site Citation and Family Functionality. 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.
Check for user database connectivity.
Review the information on CLAIMS Direct Web Services. Complete the pre-install worksheet below. This will be is used to manage all connectivity between the web server, SOLRSolr, and the database:

Parameter(s)		Description	Variables
1	<Model::DWH::Standard> <Model::DWH::Premium> <Model::DWH::Premium::Plus> It is only necessary to configure the parameter used with your subscription level	Interface into the main `Alexandria` XML data warehouse	dbname
			host (IP or domain name)
			port (DB port)
			user
			username
			password
2	<Model::Users>	Interface into the users database supporting the authentication plugin	dbname
			host (IP or domain name)
			port (DB port)
			user
			username
			password
3	<Model::Solr::Standard> <Model::Solr::Premium> <Model::Solr::Premium::Plus>	Main interfaces into the SOLR Solr index	host (IP or domain name)
3		Main interfaces into the SOLR Solr index	port (SOLR Solr port)

Note
Note: It is recommended to copy and paste the code provided in these instructions.

1. Test Test the data warehouse (DWH) database connectivity and responsiveness. This will make setup and troubleshooting much easier. Depending on your base OS configuration, you may or may not have psql installed. For this test, we will assume psql is NOT installed. From the pre-install worksheet, you will need to obtain the username, host, and dbname from row 1.

...

Code Block

language	text

   ucid
-------------
US-952687-A
US-954232-A
US-950468-A
US-946897-A
US-950860-A

(5 rows)

2. Test SOLR Test Solr for connectivity and responsiveness. This will also make things easier during the installation process. From the pre-install worksheet, you will need to obtain the host and port information from row 3.

...

Operating System

Repository

RHEL/CentOS Rocky 8

yumsudo dnf -y install \
 https://repo.ificlaims.com/ifi-claims-direct/centosrocky/8/x86_64/ifi-claims-direct-beta-01.0.2-21.el8.x86_64.rpm

Note: This installs EPEL and the PowerTools repositories

Amazon Linux 2

sudo yum -y install \
 https://repo.ificlaims.com/ifi-claims-direct/amzn2/x86_64/ifi-claims-direct-beta-01.0.2-1.amzn2.x86_64.rpm

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.

...

8. Using a text editor, set the ServerName in the alexandria-cdw(s|i)-apache.conf files files. This should be a fully qualified domain name, not an IP address. It is also necessary to make sure the VirualHost Make sure that the VirtualHost parameter is set to reflect port 80. See below:

In alexandria-cdws-apache.conf: ServerName cdws.yourdomain.com
<VirtualHost *:80>

...

Note

Note: If you have trouble accessing your local instance of CDWI, try the following:

1. In order to use CDWI, you must assign an alias to the server’s IP address. For example, if the server is running on IP 123.45.67.89, you cannot access CDWI through http://cdwi.123.45.67.89. You must make a name assignment like this:

123.45.67.89 cdws.mydomain.com cdwi.mydomain.com

“mydomain.com” must match the domain name used in step 9 8 above. It should be a domain name you have permission to use. If you are only using the service internally, then this name could be anything, but if you are exposing it externally, it should be a registered name. For For testing, you can make the name assignment on a local hosts file. You You should be able to reach CDWI from any machine on your network where the name assignment has been made. If you make a name assignment on the enterprise name server, then anyone in the organization should be able to access CDWI at http://cdwi.mydomain.com.

2. After updating the hosts file on a local machine, you need to open a new browser session. In the new browser, you should be able to access CDWI. If you open a new tab in an old browser session, you may find that CDWI is not accessible.

Page tree

Versions Compared

Old Version 9

New Version Current

Key