Endeca Server configuration

You can set the locations of the Endeca data store components and other settings in the configuration script.

The Endeca Server configuration script (endeca-server.windows.conf.bat on Windows or endeca-server.linux.conf on Linux) has settings that the Endeca Server will use for its start-up behavior, as well as the locations where certain Endeca data store artifacts are stored. These locations are used by the Endeca Server when Endeca data stores are created or modified, and when the data store's Endeca process is started.

The configuration script is located in the $ROOT/endeca-server directory. You can edit the script with any text-based editor.

The meanings of the configuration settings are as follows:

Configuration Setting	Meaning
ENDECA_SERVER_PORT	The port on which the Endeca Server will be listening for requests. The default is 7770.
ENDECA_SERVER_STOP_PORT	The port on which the Endeca Server will be listening for stop commands. The default is 9420.
ENDECA_DATASTORE_PORT_MIN and ENDECA_DATASTORE_PORT_MAX	The range of port numbers from which the Endeca Server selects the HTTP and bulk-load ports for the Dgraph processes. Once a port is assigned to a Dgraph process, that port is not used for subsequent Dgraph port assignments (unless the data store is detached). This port assignment strategy prevents port collisions among the Dgraph processes. Note that when you create an Endeca data store, you can use the `create-ds` command's `--ws-port>` and `--bulk-load-port` flags to set a specific port number.
DATA_DIR	The location where the data files for the Endeca data stores are created. The default is the $ROOT/endeca-server/data directory.
STATE_DIR	The location of the Endeca Server's state directory. The default is the $ROOT/endeca-server/state directory.
LOGS_DIR	The location of the Dgraph's standard out/err log and request log, as well as the PID file. The default is the $ROOT/endeca-server/logs directory.
DGRAPH_INSTALL	The location of the Dgraph application. Do not change this setting.
JETTY_INSTALL	The location of the Jetty installed files. Do not change this setting.

The following is an example of a Windows endeca-server.windows.conf.bat script with modified settings:

@echo off

set ROOT=%~dp0

set ENDECA_SERVER_PORT=6850
set ENDECA_SERVER_STOP_PORT=9255

REM port range where datastores can be spun up
set ENDECA_DATASTORE_PORT_MIN=8000
set ENDECA_DATASTORE_PORT_MAX=65535

set DATA_DIR=c:\endeca\apps\indexes
set STATE_DIR=%ROOT%\state
set LOGS_DIR=c:\endeca\apps\logs
set DGRAPH_INSTALL=%ROOT%\dgraph
set JETTY_INSTALL=%ROOT%\jetty-distribution-8.0.1.v20110908

REM Use our locally installed JRE, if it's present.
SET JAVA_CMD=java
IF EXIST %ROOT%\..\shared\jre SET JAVA_CMD=%ROOT%..\shared\jre\bin\java

In this example, the Endeca Server now starts on port 6850 and stops on port 9255. The Dgraph port range begins at 8000. The data files for the Endeca data stores and the Dgraph logs are now stored in C:\Endeca\Apps sub-directories.