How do I get started with SearchBlox Server for Linux/Unix?

1. Download SearchBlox Server for Linux/Unix (searchblox_unix.tar.gz).

2. Copy the file searchblox_unix.tar.gz to the directory /opt.

3. Uncompress the file searchblox_unix.tar.gz using gzip with the following command:

        [root@localhost opt]#gzip -d searchblox_unix64.tar.gz

The resulting file will be named searchblox_unix.tar.

4. Under the file searchblox_unix.tar using tar with the following command:

       [root@localhost opt]#tar -xvf searchblox_unix64.tar

The files will be extracted to the directory /opt/searchblox.

5. Change your current directory to /opt/searchblox using the command:

       [root@localhost opt]#cd /opt/searchblox

6. Start the SearchBlox Server using the following command:

        [root@localhost searchblox]#./startSearchBlox

7. Go to http://mydomain:8080/searchblox/admin/main.jsp in your browser and Login using:

username: admin

password: Temp password will be displayed onscreen

8. Go to the Collections tab and click on Add Collection to create a new collection.

9. Choose whether it is an HTTP or FileSystem-based collection, assign a unique name and choose the language for this collection. And click Add to finish creating the collection.

10. Go to the Root sub-tab, and type in RootURL / Filepath and click OK.

11. Go to the Indexer sub-tab and click the Index button to start indexing.

12. Click on the DashBoard sub-tab under collections to view indexing status.

13. Go to http://yourhost/searchblox/search.jsp to start searching.


 Recommended Linux OS Settings

We recommend that you update the Linux system variables for faster indexing/search performance.

1.) Increase the number of open files descriptors on the machine (or for the user running SearchBlox). Setting it to 64k is recommended. You can check the existing value by running the command cat /proc/sys/fs/file-max.

You need to edit /etc/sysctl.conf file and put the  following line so that after reboot the setting will remain as it is:

fs.file-max = 100000

Verify your settings with the command:
# cat /proc/sys/fs/file-max
# sysctl fs.file-max

2.) The default operating system sets limits on mmap counts, which may result in out-of-memory exceptions. On Linux, you can increase the limits by running the following command as root:

sysctl -w vm.max_map_count=262144

To set this value permanently, update the vm.max_map_count setting in /etc/sysctl.conf.

3.) Disable swap or configure swappiness:

You can disable swap temporarily by running: sudo swapoff -a. To disable it permanently, you will need to edit the /etc/fstab file and comment out any lines that contain the word swap.

To modify the system setting for swappiness, add or modify this line in /etc/sysctl.conf and reboot the server:

vm.swappiness = 10 

If you need to set up SearchBlox as a Linux service, please go to our next article in this series.

Have more questions? Submit a request


  • Avatar
    Brown Todd

    Does this method run more effectively than the Tomcat WAR file? My install of the WAR file seems to run slow on REFRESH.