Difference between revisions of "Server Configuration File"
Jump to navigation
Jump to search
Line 12: | Line 12: | ||
|- | |- | ||
| DailyLogFileSuffix || Log file name suffix used when '''LogRotationMode''' is set to 1 (daily), can contain [http://www.unix.com/man-page/posix/3/strftime/ strftime(3)] macros || %Y%m%d | | DailyLogFileSuffix || Log file name suffix used when '''LogRotationMode''' is set to 1 (daily), can contain [http://www.unix.com/man-page/posix/3/strftime/ strftime(3)] macros || %Y%m%d | ||
|- | |||
| DataDirectory || Directory where server looks for compiled MIB files, keep server encryption key, etc. || "/var/netxms" or "C:\NetXMS\var" | |||
|- | |- | ||
| DBDriver || Database driver to be used. || No default value | | DBDriver || Database driver to be used. || No default value | ||
|- | |||
| DBEncryptedPassword || Hashed password, as produced by "nxencpass" || none | |||
|- | |- | ||
| DBDrvParams || Additional driver-specific parameters. || Empty string | | DBDrvParams || Additional driver-specific parameters. || Empty string | ||
Line 22: | Line 26: | ||
|- | |- | ||
| DBPassword || Database user's password. || Empty password | | DBPassword || Database user's password. || Empty password | ||
|- | |||
| DBSchema || Schema name || not set | |||
|- | |- | ||
| DBServer || Database server (ODBC source name for ODBC driver). || localhost | | DBServer || Database server (ODBC source name for ODBC driver). || localhost | ||
|- | |- | ||
| DumpDirectory || Directory for storing crash dumps. || C:\ | | DumpDirectory || Directory for storing crash dumps. || "/" or "C:\" | ||
|- | |||
| FullCrashDumps || Write full crash dump instead of minidump (Windows only) || no | |||
|- | |||
| JavaLibraryDirectory || || | |||
|- | |||
| JavaPath || || | |||
|- | |||
| LibraryDirectory || || | |||
|- | |- | ||
| ListenAddress || Interface address which should be used by server to listen for incoming connections. Use value 0.0.0.0 or * to use all available interfaces. || 0.0.0.0 | | ListenAddress || Interface address which should be used by server to listen for incoming connections. Use value 0.0.0.0 or * to use all available interfaces. || 0.0.0.0 | ||
Line 32: | Line 46: | ||
|- | |- | ||
| LogFile || Server's log file. To write log to syslog (or Event Log on Windows), use {syslog} as file name. || {syslog} | | LogFile || Server's log file. To write log to syslog (or Event Log on Windows), use {syslog} as file name. || {syslog} | ||
|- | |||
| LogHistorySize || Number rotated files to keep, older will be discarded || 4 | |||
|- | |- | ||
| LogRotationMode || Log rotation mode. Possible values: 0 (disabled), 1 (daily), 2 (when current file size is bigger than '''MaxLogSize''') || 2 | | LogRotationMode || Log rotation mode. Possible values: 0 (disabled), 1 (daily), 2 (when current file size is bigger than '''MaxLogSize''') || 2 | ||
|- | |- | ||
| MaxLogSize || Maximum log file size in bytes, used only if '''LogRotationMode''' is set to 2 || 16777216 | | MaxLogSize || Maximum log file size in bytes, used only if '''LogRotationMode''' is set to 2 || 16777216 | ||
|- | |- | ||
| Module || Additional server module to be loaded at server startup. To load multiple modules, add additional Module parameters. || No default value | | Module || Additional server module to be loaded at server startup. To load multiple modules, add additional Module parameters. || No default value | ||
| - | |||
| ProcessAffinityMask || || | |||
|} | |} | ||
Revision as of 14:08, 14 September 2012
File netxmsd.conf is a master configuration file for NetXMS server. It should contain information necessary for establishing database connection, and some optional server parameters. Default location for this file is /etc/netxmsd.conf on UNIX systems and InstalationPath\erc\netxmsd.conf on Windows.
The file can contain the following parameters in Parameter = Value format:
Parameter | Description | Default Value | ||||
---|---|---|---|---|---|---|
CodePage | Code page used by NetXMS server. Has no effect on Windows or if server was compiled without iconv support. | Depends on your system, usually ISO8859-1 | ||||
CreateCrashDumps | Control creation of server's crash dumps. Possible values: yes or no. Has effect only on Windows platforms. | No | ||||
DailyLogFileSuffix | Log file name suffix used when LogRotationMode is set to 1 (daily), can contain strftime(3) macros | %Y%m%d | ||||
DataDirectory | Directory where server looks for compiled MIB files, keep server encryption key, etc. | "/var/netxms" or "C:\NetXMS\var" | ||||
DBDriver | Database driver to be used. | No default value | ||||
DBEncryptedPassword | Hashed password, as produced by "nxencpass" | none | ||||
DBDrvParams | Additional driver-specific parameters. | Empty string | ||||
DBLogin | Database user name. | netxms | ||||
DBName | Database name (not used by ODBC driver). | netxms_db | ||||
DBPassword | Database user's password. | Empty password | ||||
DBSchema | Schema name | not set | ||||
DBServer | Database server (ODBC source name for ODBC driver). | localhost | ||||
DumpDirectory | Directory for storing crash dumps. | "/" or "C:\" | ||||
FullCrashDumps | Write full crash dump instead of minidump (Windows only) | no | ||||
JavaLibraryDirectory | ||||||
JavaPath | ||||||
LibraryDirectory | ||||||
ListenAddress | Interface address which should be used by server to listen for incoming connections. Use value 0.0.0.0 or * to use all available interfaces. | 0.0.0.0 | ||||
LogFailedSQLQueries | Control logging of failed SQL queries. Possible values: yes or no. | yes | ||||
LogFile | Server's log file. To write log to syslog (or Event Log on Windows), use {syslog} as file name. | {syslog} | ||||
LogHistorySize | Number rotated files to keep, older will be discarded | 4 | ||||
LogRotationMode | Log rotation mode. Possible values: 0 (disabled), 1 (daily), 2 (when current file size is bigger than MaxLogSize) | 2 | ||||
MaxLogSize | Maximum log file size in bytes, used only if LogRotationMode is set to 2 | 16777216 | ||||
Module | Additional server module to be loaded at server startup. To load multiple modules, add additional Module parameters. | No default value | - | ProcessAffinityMask |
Configuration file example:
#
# Sample configuration file for NetXMS server
#
DBDriver = mysql.ddr
DBServer = localhost
DBName = netxms_db
DBLogin = netxms
DBPassword = password
LogFailedSQLQueries = yes
LogFile = {syslog}