Installing Apache Solr on remote machines

After you install IBM® Operations Analytics Log Analysis, you can use the Apache Solr remote installer to install Apache Solr on a remote machine.

About this task

If no local instances of Apache Solr exist, then you need to install the instances on the remote machine as soon as you install IBM Operations Analytics Log Analysis. If there is a local instance of Apache Solr, you can install the remote instances whenever you want.

You must use a non-root user to run the script.

You cannot use the installer to install Apache Solr on a local machine.

You cannot use the installer to install multiple Apache Solr nodes on a single remote machine.

Ensure that the Apache Solr ports are open and free from any firewall restrictions on the remote machine.

To install Apache Solr on multiple remote machines, run the script separately for each remote machine. You cannot use the installer to install instances of Apache Solr simultaneously or in parallel.

Procedure

Change the directory to <HOME>/IBM/LogAnalysis/solr_install_tool. For example:
```
cd <HOME>/IBM/LogAnalysis/solr_install_tool
```
To run the remote_deploy.sh script, enter the following command:
```
./remote_deploy_solr.sh -install
```
The script prompts you for the following information:

Remote Hostname in FQDN format

Enter the Fully Qualified Domain Name (FQDN) of the remote host.

Username

Enter the user name.

Password

Enter the password if password-less SSH authentication is disabled. If password-less SSH is enabled between the IBM Operations Analytics Log Analysis server and the remote host, the script reads the values that are specified in the ssh_config.properties file in the <HOME>/IBM/LogAnalysis/utilities/config directory. For more information, see ssh_config.properties.

SSH Port

Enter the remote machine port that is used for SSH. To use the default value of 22, press enter.

Top-level Installation Directory

To use the default value, which is <HOME>, press enter. Alternatively, you can enter the path to the directory where you want to install the DE.

Apache Solr Search Port

To use the default value, 9989, press enter. To use another port, enter the port number for another valid port. Do not enter a port that is being used for something else.

Apache Solr Query Service Port

To use the default value, 7205, press enter. To use another port, enter the port number for another valid port. Do not enter a port that is being used for something else.
To start the installation, press enter. In most cases, the installation takes about 5 minutes to complete.

Restart Log Analysis with the following command:

<HOME>/IBM/LogAnalysis/utilities/unity.sh -restart

Results

The results of the installation are output in the log file in the <HOME>/IBM/LogAnalysis/solr_install_tool/logs/ManageSolrnodes.log file.

To view the status for the instances of Apache Solr that are installed remote machines, run the unity.sh -status command.

Example

Here is an example script output:

Remote Hostname in FQDN format:12345.example.com
username:unity
password:*********
SSH port: [22]
Top-level Installation Directory: [/home/unity]
Solr Search Port: [9989]
Solr Query Service Port: [7205]

Script is ready for remote installation of Solr: 
Review the following inputs ....
-----------------------------------------------------------------------------
Remote Host Name: 12345.example.com
Remote User Name: unity
Remote SSH Port: 22
Top-level remote installation directory: /home/unity
Solr v9.0 - remote installation directory: 
/home/unity/IBM/LogAnalysis
Solr - remote ports: 9989, 7205
------------------------------------------------------------------------
['q' - Abort]['Enter' - Install]

Sat Nov 16 03:08:38 CST 2013 Starting remote installation of Solr
, this will take couple of minutes to complete  ....
Sat Nov 16 03:08:38 CST 2013 Waiting for remote installation to complete ....
Sat Nov 16 03:11:47 CST 2013 Successfully installed Solr
Solr on remote host:12345.example.com ....