SearchBlox installation process does not allow for in-place upgrades due to the complexity of the search configuration and data mapping involved between different version upgrades.
To avoid any issues or downtime, we recommend installing and testing the latest version in a development or staging environment before installing on a production instance. We can provide a license key to set up a similar production environment with the new version so you can switch over without any downtime.
To upgrade from one version of SearchBlox to another, we recommend doing a clean uninstallation when upgrading from one version of SearchBlox to another since the presence of files from the previous installation can cause errors. So to remove another version of SearchBlox, please follow the steps given in the Uninstall section of this page, delete the SearchBlox folder, and restart the Windows instance.
Once restarted, please install the latest SearchBlox version.
- Download SearchBlox for Windows.
- Run the SearchBlox setup file, then follow the installer wizard to install the application on your C:\ drive. C:\ drive is the default installation drive for SearchBlox.
- The installer will install SearchBlox, Elasticsearch, and the Analytics server for this application.
- After installation please set
JAVA_HOMEand environment path variable for Java.
If there are other Java versions installed in the system, please remove the references from the path variable.
To set the environment variable:
- Right-click on My Computer, select Properties and click Advanced System Settings.
- On the Advanced tab, select Environment Variables.
- Create a new System Variable
Pathunder System Variable and add
%JAVA_HOME%\binas a new path.
- Verify if Java is installed correctly by running the command:
Open Command Prompt as Administrator. Go to
C:\SearchBloxServer\elasticsearch\binand run the following command:
You can start the service from the Control Panel > Administrative Services > Services.
- Verify the Elasticsearch access by opening the browser and going to the URL:
You can find the Elasticsearch login credentials in the searchblox.yml file, found in the following file path:
- You can make the service Startup Type as Automatic in the Services, so Easticsearch service starts automatically on restart.
To stop Elasticsearch service, please run the following command in the folder
- Go to the
C:\SearchBloxServer\services\bat\folder within the SearchBlox installation.
- Right-click the
installService.batfile and run as Administrator. This will install the service.
- You can start the SearchBlox service manually from the Control Panel > Administrative Services > Services.
- Restart the Windows Server if you are not able to start SearchBlox.
- Check if Elasticsearch service is running. If not, start the Elasticsearch service before starting SearchBlox.
- SearchBlox service will start automatically upon server restart.
- After you start the service, wait for 30 seconds then open the link: https://localhost:8443/searchblox/admin/main.jsp in your browser to access the SearchBlox Admin Console.
You can stop the SearchBlox service from the Control Panel > Administrative Services > Services.
- Start the Analytics server to display search query data on the Analytics page within SearchBlox Admin Console.
- The Analytics Server will use default port 8444.
- Go to the folder
- To stop the Analytics service, please terminate the process using Control+C or close the Command Prompt.
- As an alternative, terminate the process using the Task Manager.
To learn about Windows Analytics Service, visit: SearchBlox Analytics as a service in Windows
- 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.
- SearchBlox Server runs on port 8443 by default.
You can change the port by following the steps as shown here:
- Stop SearchBlox service
C:\SearchBloxServer\start.d\https.inifile and add the below line to set the required port number:
- Save the https.ini file
- Start SearchBlox service
You can install SearchBlox from a different drive or path using these steps:
- Edit the file
..\SearchBlox Server\services\conf\wrapper.confand change the value for
searchblox_home=C:\\SearchBlox Server\\to the deployed location. Use the double slash in the path.
- Set the Java Environment variable for the location (example: D: drive or E: drive).
- Set the SearchBlox Environment variable using the following steps(This may be required in few systems)
1. Go to Control Panel > System and Security
2. Select Advanced System Settings
3. Select Environmental Variable
4. Under System, Variables Select Path and click Edit
5. Click New to add a new path
6. And add
- Update Elasticsearch installation path in
searchblox.elasticsearch.url: https://localhost:9200/ searchblox.basic.username: xxxxxx searchblox.basic.password: xxxxxxxxxxx es.home: D:\SearchBloxServer\elasticsearch
- To start Elasticsearch using D:\ drive, please edit the
D:\SearchBloxServer\elasticsearch\bin\elasticsearch-env.batfile to update the JAVA_HOME path to
- Go to
D:\SearchBloxServer\elasticsearch\binfolder and run the command
D:\SearchBlox Server\services\batto install SearchBlox service.
- Run the Elasticsearch and SearchBlox services.
- Wait for 30 seconds.
- Check the status.log to verify if SearchBlox has started successfully.
- To remove the SearchBlox service, please stop Elasticsearch and SearchBlox and then run
To uninstall SearchBlox:
- Stop the Elasticsearch service, SearchBlox service and Analytics server/service
- Open the Command Prompt as Administrator
- Go to
C:\SearchBloxServer\elasticsearch\binand uninstall Elasticsearch service by running the command:
- Go to the
C:\SearchBloxServer\services\bat\and uninstall SearchBlox service by running the command:
C:\SearchBloxServer\uninstall.exeto uninstall the application.
- Delete C:\SearchBloxServer folder for clean uninstall.
After the uninstallation, it is required to restart the machine when prompted. This action will terminate all the existing background services if any.
Updated about a month ago