istore

Name

istore — Gromox Information Store launcher

Synopsis

/usr/libexec/gromox/istore [-c config]

Description

The Gromox Information Store, exmdb_provider(4gx), is built as a shared object, and can be either be loaded by gromox-http(8) or run in a separate process which is gromox-istore. The benefit of a separate process is improved debuggability.

Options

-c config: Read configuration directives from the given file. If this option is not specified, /etc/gromox/gromox.cfg will be read if it exists.

Configuration directives (gromox.cfg)

The following directives are recognized when reading from /etc/gromox/gromox.cfg, or when the -c option is used to specify a custom file:

config_file_path: Colon-separated list of directories which will be scanned when locating further configuration files, especially those used by subcomponent instances. (For example, mysql_adaptor(4gx) would be directed to look at /etc/gromox/istore/mysql_adaptor.cfg before /etc/gromox/mysql_adaptor.cfg.)

Default: /etc/gromox/istore:/etc/gromox
daemons_fd_limit: In gromox-istore, this is treated as an alias for istore_fd_limit.
data_file_path: Colon-separated list of directories which will be scanned when locating data files.

Default: /usr/share/gromox/istore:/usr/share/gromox
host_id: A unique identifier for this system. It is used for the Server HTTP responses header, for components like exmdb_provider(4gx), which makes use of it for SMTP HELO lines, for DSN report texts, for MIDB database/EML cache. The identifier should only use characters allowed for hostnames.

Default: (system hostname)
istore_fd_limit: Request that the file descriptor table be at least this large. The magic value 0 indicates that the system default hard limit (rlim_max, cf. setrlimit(2)) should be used.

Default: 0
istore_log_file: Target for log messages here. Special values: "-" (stderr/syslog depending on parent PID) or "syslog" are recognized.

Default: - (auto)
istore_log_level: Maximum verbosity of logging. 1=crit, 2=error, 3=warn, 4=notice, 5=info, 6=debug.

Default: 4 (notice)
istore_standalone: This directive serves as a mutual exclusion device between http(8gx) and istore(8gx) and controls which one of the two will execute the mailbox engine. If and only if this is set to yes will istore be able to startup, while http will disable the engine on its startup.

Default: no
running_identity: An unprivileged user account to switch the process to after startup. To inhibit the switch, assign the empty value.

Default: gromox