Microsoft Windows Support

Transparensee does not provide support for Windows servers because our development effort goes into supporting the major Linux versions available. That being said, Transparensee attempts to write portable Java and as such, the engine will run under Microsoft Windows for developers wishing to test their applications locally on their workstations.

What to Expect

  1. The engine must be run from the command line. There is no support for demonizing the engine.
  2. Any settings, including available memory, specified in discovery.properties will be ignored. These settings need to be translated into arguments for the JAVA command line and placed into an edited version of the provided server.bat file.

server.bat

Customers are expected to install the engine into the recommended folder hierarchy that creates an archives, releases and engines folder as described in Recommended Installation Directory Hierarchy

The bin folder of the releases directory includes a starter server.bat file that must be edited to work with your local configuration

To configure server.bat

  1. Copy server.bat to your engines folder.
  2. Rename the file to discovery.bat.
  3. Adapt the batch file to use the correct locations of the desired discovery.jar file and logging.properties.
  4. Add any JVM arguments that you wish to apply to the engine
  5. Save the changes.

To Start the Engine

  1. Open a Command Prompt window.
  2. Change your current working directory to the correct engines folder.
  3. Run discovery.bat
  4. The Command Prompt will not return while the engine is running

To Stop the Engine

  1. From the Command Prompt window, press CTRL+C

Example

Releases: c:/discovery/releases
Engines: c:/discovery/engines
Desired Release: c:/discovery/releases/discovery-3.6.1
Engine Folder: c:/discovery/engines/vista

  1. Change Working Directory to the engine folder:

    cd c:/discovery/engines/vista

  2. Copy server.bat as discovery.bat in your engines

    C:\> copy c:/discovery/releases/discovery-3.6.1/lib/server.bat discovery.bat

  3. Edit discovery.bat to use the correct releases folders. The example below allocates 500 MB heap memory and sets some additional 64-bit JVM Options.

     @echo off
     REM Very simple example that shows how to run the engine under  
     REM Windows for development purposes.  
     echo.  
     echo Starting Discovery Search Engine, see log directory for more information.  
     echo.  
     if not exist log mkdir log  
     java -showversion -Djava.util.logging.config.file=c:\discovery\releases\discovery-3.6.1\logging.properties  
              -jar c:\discovery\releases\discovery-3.6.1\lib\discovery.jar  
              -Xmx500M  
              -XX:+UseCompressedOops -XX:+DoEscapeAnalysis -XX:+UseCompressedStrings  
              -XX:+UseStringCache
    
  4. To start the engine:

    c:\> discovery.bat