Installation of SearchBlox on Ubuntu
-
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
-
Verify the java installation by running the below command:
java -version
-
Install wget using the below command:
sudo apt-get update
sudo apt-get install wget
-
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
-
Please login as root using sudo su if you are not the root user or install using sudo as below.
-
Create a SearchBlox user by giving the necessary details
sudo adduser searchblox
-
SearchBlox has to be installed in /opt folder, so change directory to /opt
cd /opt
-
Download SearchBlox debain package
sudo wget https://d2fco3ozzrfhhd.cloudfront.net/v9.2/searchblox_9.2-0_all.deb
-
Install the debian package
sudo dpkg -i searchblox_9.2-0_all.deb
-
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
-
To start Elasticsearch and SearchBlox services
systemctl start sbelastic
systemctl start searchblox
-
To stop Elasticsearch and SearchBlox services
systemctl stop sbelastic
systemctl stop searchblox
-
To verify the status of the elasticsearch and searchblox services please use below commands:
systemctl status sbelastic
systemctl status searchblox
Start the Analytics server to display search query data on the Analytics page within SearchBlox Admin Console. The Analytics Server will use port 4000.
-
Install node.js
sudo apt-get install nodejs
sudo apt-get install npm
-
Run the command to go to the analytics folder
cd /opt/searchblox/analytics
-
Run the command to start the analytics service in the background
nohup ./cubejs &
-
Find the process ID of Analytics server using the following command:
ss -nutlp |grep 4000
-
Run the following command to terminate the process:
kill -9 <process-id>
#please use the process id from the previous step
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
SearchBlox Server runs on port 8080 by default.
You can change the port by following the steps below:
-
Stop SearchBlox
-
Edit the file /opt/searchblox/start.ini at line number 163 as follows:
jetty.http.port=8080
-
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
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
Comments
0 comments
Please sign in to leave a comment.