Overview | Environment Variables | Shell Scripts | Uses | Reserved Variables

Omnidex reserves some environment variables for its own use. Some of required, but most are optional. These variables either point to the location of the software or configure aspects of the software.

PATH points to the directory where the Omnidex executables reside. This variable is a system variable, and is not Omnidex-specific. The PATH variable is likely to contain other paths. To ensure that existing settings are not overridden, append the setting to the existing value.

If the PATH is not set, users will either be required to run all Omnidex executables from the directory in which the executable resides or must pass the fully qualified path to the executable.

UNIX
export PATH="/omnidex/bin:$PATH"

Windows
set PATH="c:\Program Files\Omnidex 5.1\bin";%PATH%

LD_LIBRARY_PATH points to the directory where shared libraries reside. This variable is a system variable, and is not Omnidex-specific. The LD_LIBRARY_PATH variable is likely to contain other paths. To ensure that existing settings are not overridden, append the setting to the existing value. LD_LIBRARY_PATH is only used on UNIX operating systems.

UNIX
export LD_LIBRARY_PATH="/omnidex/lib"

CLASSPATH points to the directory where the Omnidex.jar file resides and is required for Java development on all platforms. This variable is a system variable, and is not Omnidex-specific. The CLASSPATH variable is likely to contain other paths. To ensure that existing settings are not overridden, append the setting to the existing value.

Omnidex.jar is located in the bin subdirectory of the Omnidex root directory on the server, and in the lib subdirectory of the Omnidex Client root directory on the client machine.

UNIX
export CLASSPATH="/omnidex/bin/Omnidex.jar:$CLASSPATH"

Windows
set CLASSPATH="c:\Program Files\Omnidex 5.1\bin\Omnidex.jar";%CLASSPATH%

TMPDIR points to a directory where Omnidex temporary files are built. On UNIX, this system variable governs the directory for temporary files for all process, not just Omnidex; however, this variable is not commonly used on Microsoft Windows. Omnidex uses this variable on both UNIX and Microsoft Windows.

It is recommended that TMPDIR be set to a directory with plenty of available disk space, especially when building Omnidex indexes. It is also recommended that TMPDIR be placed on a separate drive, and preferably a separate disk controller, from the underlying data and the Omnidex index files.

UNIX
export TMPDIR="/temp"

Windows
set TMPDIR=d:\temp

The following environment variables must be set for Omnidex to function properly.

OMNIDEX_HOME points to the root directory of the Omnidex server software.

UNIX
export OMNIDEX_HOME="/omnidex"

Windows
set OMNIDEX_HOME=c:\program files\omnidex 5.1

The following environment variables are optional and can be used to configure the behavior of Omnidex.

The OMNIDEX_DEBUG variable controls Omnidex debugging and is described in Omnidex Debugging.

The OMNIDEX_QUALIFICATION_THRESHOLD variable controls when Omnidex indexes are used for qualifying rows in a table and is described in Configuring Omnidex Optimization.

The OMNIDEX_AGGREGATION_THRESHOLD variable controls when Omnidex indexes are used for aggregating rows in a table and is described in Configuring Omnidex Optimization.

The OMNIDEX_DATE_FORMAT, OMNIDEX_TIME_FORMAT and OMNIDEX_DATETIME_FORMAT variables control the default format for dates and times when converted from their internal binary format to a displayable character format. The environment variable can be set to a string that references the following tokens:

The following example establishes the default format for dates:

UNIX
export OMNIDEX_DATE_FORMAT="MMM D, YYYY"

Windows
set OMNIDEX_DATE_FORMAT="MMM D, YYYY"

> select birthdate from individuals;

BIRTHDATE
-------------------
July 14, 1938
November 22, 1957
July 28, 1960
August 22, 1929
July 9, 1933
August 1, 1944
September 14, 2004

The ODXSQLINIT variable points to an initialization file used by the OdxSQL Program. This initialization file contains OdxSQL statements to be run when OdxSQL is launched. Typically, these statements are SET commands; however, any OdxSQL commands are allowed.

UNIX
export ODXSQLINIT="/class/.odxsqlinit"

Windows
set ODXSQLINIT=d:\class\.odxsqlinit"

The ODXSQLHIST variable points to a history file used by the OdxSQL Program. This history file contains statements that have been run in the OdxSQL program. Note that if multiple sessions point to the same file, their statements will all be written to the same file.

UNIX
export ODXSQLHIST="/class/.odxsql_history"

Windows
set ODXSQLHIST=d:\class\.odxsql_history"

Prev

See also: