Page tree
Skip to end of metadata
Go to start of metadata
Before you start

There are two options available for installing SOLR. Please review the documentation to determine which option best meets your needs.

This guide provides instructions for a basic distributed installation. If you are doing an advanced distributed installation, please follow the instructions in the Type 3 link above.

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.

useradd -m asolr

3. Create a password for asolr.

passwd asolr

4. Become user asolr.

su - asolr

5. Download the package.

cd /home/asolr
wget http://alexandria.fairviewresearch.com/software/alexandria-solr-v2.1.2-standalone-distribution.tar.gz &

6. When the download is complete, untar the file.

tar zxvf alexandria-solr-v2.1.2-standalone-distribution.tar.gz
cd /home/asolr/alexandria-solr-v2.1.2-standalone-distribution

7. Using a text editor, adjust solr-alexandria-vars. Confirm or set the following variables.

Variable

Value

Description

ALEXANDRIA_SOLR_PORT 8080The port SOLR (Jetty) should listen on and accept requests.
ALEXANDRIA_SOLR_URLhttp://xxx.xxx.xxx.xxx:$ALEXANDRIA_SOLR_PORT/$ALEXANDRIA_SOLR_CONTEXTThe URL to configure collections. The IP address should be the local address of the server.
ALEXANDRIA_SOLR_JVM_MEM64gThis 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.

./solrctl start

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. Run acfg to make sure the tools can see the configuration file correctly.

acfg

This will display the configured databases and indices.

Using configuration from: /usr/share/perl5/vendor_perl/auto/share/dist/Alexandria-Library/alexandria.xml
  
  
Configured databases:
    alexandria: [alexandria; 192.168.10.9; 5432]
    customers: [customers; 10.234.1.25; 5432]
  
  
Configured Indices:
    alexandria (http://192.168.10.61:8080/alexandria-v2.1):

11. If you want a central location for the configuration file which is immune to software updates, copy it to /etc.

cp /usr/share/perl5/vendor_perl/auto/share/dist/Alexandria-Library/alexandria.xml /etc

12. Using a text editor, update the file so that the configuration is pointing to the correct SOLR instance.

/etc/alexandria.xml

13. Update the IP address if necessary. If you run acfg again, the "Using configuration" line should reflect the new location.

14. Run aidxd to start the SOLR update process.

/usr/bin/aidxd --idxversion=21 --idxcls=Alexandria::DWH::Index::DocumentEx

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:

Last Modified:
Num Docs:
Max Doc:
Heap Memory Usage:
Deleted Docs:
etc...

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.

$ wget -O- -q 'http://xxx.xxx.xxx.xxx:8080/alexandria-v2.1/alexandria/select?q=*:*&rows=0'

2. The result will show numFound, which is equivalent to Num Docs in the interface.

{
 "responseHeader":{
   "status":0,
   "QTime":9,
   "params":{
     "q":"*:*",
     "df":"text",
     "echoParams":"all",
     "indent":"true",
     "fl":"score,ucid",
     "start":"0",
     "rows":"0",
     "wt":"json"}},
 "response":{"numFound":0,"start":0,"maxScore":0.0,"docs":[]

 }}
Next Steps

Once SOLR has been installed, proceed to Web Server Installation (if desired).

Further Reading

  • No labels