DownloadsDocumentationAPI ReferenceChangelogOpen A TicketContact

## Installation on Windows

  1. [Download](🔗) SearchBlox 10.2 for Windows.

  2. Right-click the `searchblox_windows64` file and run as Administrator. Install4j will set up the SearchBlox wizard and start the process for SearchBlox installation.

971


SearchBlox Installation Wizard starts up.

502


Choose the SearchBlox installation directory.

492


Chooses the SearchBlox startup shortcut by default.

491


SearchBlox installation in progress.

491


SearchBlox installation is complete.

494


  1. The installer will install SearchBlox along with Elasticsearch and Analytics server for this application.

## Prerequisites

  • After installation please set `JAVA_HOME` and environment path variable for Java.

Please Note

If there are other Java versions installed in the system, please remove the references from the path variable.

To set the environment variable

  1. Right-click on My Computer, select Properties and click Advanced System Settings.

  2. On the Advanced tab, select Environment Variables.

583


  1. Create a new System Variable `JAVA_HOME` with value `C:\SearchBloxServer\jre`

NOTE

  • If SearchBlox is installed on D drive then JAVA_HOME value will be `D:\SearchBloxServer\jre`

930


  1. Select `Path` under System Variable and add `%JAVA_HOME%\bin` as a new path.

481

598


  1. Verify if Java is installed correctly by running the command: `java -version`

475


## Start SearchBlox Service

  1. Go to the `C:\SearchBloxServer\service` folder within the SearchBlox installation.

  2. Right-click the `install-service` file and run as Administrator. This will install the service.

1261


  1. You can start the SearchBlox service manually from the Control Panel > System and Security > Administrative Tools> Services.

512


  1. To Start SearchBlox Service, Right-click the `Searchblox Enterprise Search` and Click `start`.

512


Note

  • Restart the Windows Server if you are not able to start SearchBlox.

  • Check if Elasticsearch service is running.

  • SearchBlox service will start automatically upon server restart.

  • After you start the service, wait for 30 seconds then open the link: https://localhost:8443/console/ in your browser to access the SearchBlox Admin Console.

  • You will be taken to the License Agreement page. Click on “I AGREE” at the bottom of the page.

1741


  • You will be taken to Create a Super Admin Create Password Page.

1760


Use the Super Admin password to log in and access the dashboard page.

612


## Verify Installation

  • You can verify if SearchBlox has started successfully by viewing the **status.log** file in the `C:\SearchBloxServer\webapps\ROOT\logs` folder.

  • Please confirm the message "SearchBlox Started" is shown in the log.

  • In case of any errors, this log will provide additional information for troubleshooting.

You can see the SearchBlox Account details by clicking the Avatar Icon.

1912


Note

  • To learn about Troubleshooting visit: [Logging and Troubleshooting](🔗)

  • To learn about using SearchBlox Admin Console visit: [Overview of SearchBlox](🔗)

  • To learn about tuning for high-performance visit: [Installation Tuning](🔗)

## Change SearchBlox Server Port

  • SearchBlox Server runs on port **8443** by default. For secure ports refer **Secure Ports used by SearchBlox** section on [Requirements](🔗)

You can change the port by following the steps as shown here:

  • Stop SearchBlox service

  • Update `C:\SearchBloxServer\start.d\https.ini` file and add the below line to set the required port number: `jetty.ssl.port=443`

  • Save the **https.ini** file

  • Start SearchBlox service

## SearchBlox Installation on alternate drive or path

We recommend installing SearchBlox in the C:\ drive. Please follow the following steps if you wish to install SearchBlox on a different drive. For example, if you want to install in D:\ drive, follow the below steps:

  1. [Download](🔗) SearchBlox for Windows.

  2. Run the Installation Wizard and give the preferred installation path. By default, it will be `C:\SearchBloxServer` change it to `D:\SearchBloxServer`.

492


  • For the next steps refer **Installation on Windows** section from step 3 and 4.

  • Set the Java Environment variable for the location (example: D: drive or E: drive).

  • To set the Java Environment variable follow the steps from **Prerequisites** section.

To update Elasticsearch/Analytics installation path:

  • Go to`D:\SearchBloxServer\webapps\ROOT\WEB-INF`.

  • In `searchblox.yml` file, in the lines 7, change the value of `es.home` to `D:\SearchBloxServer\analytics`, and in the line 16, change the value of `searchblox-analytics.home` to `D:\SearchBloxServer\analytics`.


  • Now save the searchblox.yml file.
  • To Start the SearchBlox service, go to `D:\SearchBloxServer\service` and follow the steps from the **Start SearchBlox service** section.
## Uninstall SearchBlox
  1. To Stop the SearchBlox service. Go to Control Panel > System and Security > Administrative Tools> Services.
512

  1. Go to the `C:\SearchBloxServer\service` and uninstall SearchBlox service by running `uninstall-service` as administrator.
512

  1. Run SearchBlox uninstall.exe file from Installation Directory.
1025

SearchBlox Uninstallation successful.
1133

  1. Delete C:\SearchBloxServer folder for clean uninstall.
Note
After the uninstallation, it is required to restart the machine when prompted. This action will terminate all the existing background services if any.