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. Run acfg to make sure the tools can see the configuration file correctly.
This will display the configured databases and indices.
11. If you want a central location for the configuration file which is immune to software updates, copy it to
12. Using a text editor, update the file so that the configuration is pointing to the correct SOLR instance.
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.
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.