Installation of SearchBlox on Amazon Linux 2
Recommended EC2 instance type is i3.xlarge.
Install OpenJDK 11 by running the following command:
amazon-linux-extras install -y java-openjdk11
Install wget by running the following command:
yum install wget
Verify the installation by running the following command:
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:
Please login as root using sudo su if you are not the root user.
Create a SearchBlox user
sudo adduser searchblox
sudo passwd searchblox
SearchBlox has to be installed in /opt folder, so change directory to /opt
Download SearchBlox rpm package
sudo wget https://d2fco3ozzrfhhd.cloudfront.net/v9.2/searchblox-9.2-0.noarch.rpm
Install the rpm package
sudo rpm -ivh searchblox-9.2-0.noarch.rpm
Change permission for the following 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
To start Elasticsearch and SearchBlox services
systemctl start sbelastic
systemctl start searchblox
To stop Elasticsearch and SearchBlox services
systemctl stop sbelastic
systemctl stop 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.
curl -sL https://rpm.nodesource.com/setup_10.x | sudo bash -
sudo yum install nodejs
Run the command to go to the analytics folder
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
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:
SearchBlox Server runs on port 8080 by default.
You can change the port by following the following steps:
Edit the file /opt/searchblox/start.ini at line number 163 as follows:
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:
yum remove searchblox
To learn more on installing SearchBlox in Amazon Linux 2: Installing SearchBlox in Amazon Linux 2