How do I install SearchBlox on Ubuntu?

Installation of SearchBlox on Ubuntu

Prerequisites

1. Install OpenJDK 11 by running the following command:
   sudo add-apt-repository ppa:openjdk-r/ppa && sudo apt-get update -q && sudo apt install -y openjdk-11-jdk

2. Verify the java installation by running the below command:
   java -version

3. Install wget using the below command:
   sudo apt-get update
sudo apt-get install wget

4. Increase the map count with the following command
   sysctl -w vm.max_map_count=262144
   set this permanently in /etc/sysctl.conf by adding the following line:
   vm.max_map_count=262144

 SearchBlox Installation

1. Please login as root using sudo su if you are not the root user or install using sudo as below.

2. Create a SearchBlox user by giving the necessary details
   sudo adduser searchblox

3. SearchBlox has to be installed in /opt folder, so change directory to /opt
   cd /opt

4. Download SearchBlox debain package
   sudo wget https://d2fco3ozzrfhhd.cloudfront.net/v9.2/searchblox_9.2-0_all.deb

5. Install the debian package
   sudo dpkg -i searchblox_9.2-0_all.deb

6. Change permission for few folders
   sudo chown -R searchblox:searchblox /opt/searchblox
sudo chmod -R 755 /opt/searchblox/logs
sudo chmod -R 755 /opt/searchblox/elasticsearch/logs
sudo chmod -R 755 /opt/searchblox/bin
sudo chmod -R 755 /opt/searchblox/analytics/node/bin

7. To start Elasticsearch and SearchBlox services
   systemctl start sbelastic
systemctl start searchblox

8. To stop Elasticsearch and SearchBlox services
   systemctl stop sbelastic
systemctl stop searchblox

9. To verify the status of the elasticsearch and searchblox services please use below commands:
   systemctl status sbelastic
systemctl status searchblox

 

 

Start Analytics Server

Start the Analytics server to display search query data on the Analytics page within SearchBlox Admin Console. The Analytics Server will use port 4000.

1. Install node.js
   sudo apt-get install nodejs
sudo apt-get install npm

2. Run the command to go to the analytics folder
   cd /opt/searchblox/analytics

3. Run the command to start the analytics service in the background
   nohup ./cubejs &

 Stop Analytics Server

1. Find the process ID of Analytics server using the following command:
   ss -nutlp |grep 4000

2. Run the following command to terminate the process:
   kill -9 <process-id> #please use the process id from the previous step

Verify Installation

Once you see the message "The service has started", wait for few seconds then go to http://localhost:8080/searchblox/admin/main.jsp to validate.

• You can verify if SearchBlox has started successfully by viewing the status.log file in the <SEARCHBLOX_INSTALLATION_PATH>/webapps/searchblox/logs folder.

Please confirm the message "Started Successfully" is shown in the log. In case of any errors, this log will provide additional information for troubleshooting.

• To learn more on Troubleshooting visit: Logging and Troubleshooting

• To learn about accessing SearchBlox visit: Overview of SearchBlox

• To learn about tuning after installation visit: Installation Tuning

🚧

SearchBlox Admin Console Access using IP Address or Domain Name

• You can use your IP instead of localhost in the URL to access the SearchBlox Admin Console.
• If a domain name is mapped to the IP address, you can use the domain name:
  https://exampledomain:port/searchblox/admin/main.jsp
  https://exampledomain:port/searchblox/plugin/index.html

 

 Change SearchBlox Server Port

SearchBlox Server runs on port 8080 by default.

You can change the port by following the steps below:

1. Stop SearchBlox

2. Edit the file /opt/searchblox/start.ini at line number 163 as follows:
   jetty.http.port=8080

3. Start SearchBlox

If it is not possible to run SearchBlox in a port less than 1024 since SearchBlox runs as a non-root user, you can enable port forwarding if required using :
iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080

 Uninstall

Run the following command to uninstall or remove SearchBlox:

apt-get remove searchblox

To learn more on installation in Ubuntu read: Installing SearchBlox in Ubuntu