SOLR Installation Instructions
Note: It is recommended to copy and paste the code provided in these instructions.
1. Ensure that your machine meets the hardware and software requirements listed in the links above.
Note: Java must be installed before you begin the installation.
2. It is recommended to create the user asolr.
3. Create a password for asolr.
4. Become user asolr.
5. Download the package.
6. When the download is complete, untar the file.
7. Using a text editor, adjust
solr-alexandria-vars. Confirm or set the following variables.
|8080||The port SOLR (Jetty) should listen on and accept requests.|
|http://xxx.xxx.xxx.xxx:$ALEXANDRIA_SOLR_PORT/$ALEXANDRIA_SOLR_CONTEXT||The URL to configure collections. The IP address should be the local address of the server.|
|64g||This is the java heap setting. Generally speaking, you should allocate at least 64g. The exact amount should be approximately 80% of total memory.|
8. Start SOLR. Note that it may take 3-4 weeks to complete the initial indexing process.
9. Edit the following URL to reflect your IP address: http://xxx.xxx.xxx.xxx:8080/alexandria-v2.1/old.html. You can now visit this address in your browser to see the SOLR interface.
10. On the server with Alexandria-Client-Tools installed, configure, enable and start the indexing service.
/etc/alexandria.xml, set @base to IP/hostname of SOLR installation.
b) Enable and start service. If necessary, adjust the code to reflect the version you are using.
11. If you are undertaking a complete re-index of all data, please see Re-indexing Data from CLAIMS Direct Data Warehouse.
Note: You can check on the progress of the indexing process in two ways.
The SOLR Administration User Interface
1. Visit the URL http://xxx.xxx.xxx.xxx:8080/alexandria-v2.1/old.html#/ (assuming you are on the same network as SOLR or can access it). Edit the URL to reflect your IP address. This will bring you to the Dashboard.
2. Use the Core Selector drop down and choose 'alexandria'. From this page you can see various statistics such as:
Heap Memory Usage:
3. Num Docs represents the number of documents currently available in the index. To learn more about the SOLR Administration User Interface, see https://lucene.apache.org/solr/guide/6_6/overview-of-the-solr-admin-ui.html.
The SOLR API
1. Submit the following query to the SOLR API. Edit the code to reflect your IP address.
2. The result will show
numFound, which is equivalent to Num Docs in the interface.