scmaster

The messaging system

Description

scmaster is the implementation of the messaging mediator.

Configuration

etc/defaults/global.cfg

etc/defaults/scmaster.cfg

etc/global.cfg

etc/scmaster.cfg

~/.seiscomp/global.cfg

~/.seiscomp/scmaster.cfg

scmaster inherits global options.

defaultGroups

Type: list:string

The default set of message groups for each queue. Only used if a queues group list is unset (note: empty is not unset). Default is AMPLITUDE, PICK, LOCATION, MAGNITUDE, FOCMECH, EVENT, QC, PUBLICATION, GUI, INVENTORY, CONFIG, LOGGING, SERVICE_REQUEST, SERVICE_PROVIDE, STATUS_GROUP.

queues

Type: list:string

Enable messaging queues defined as profile in queues. The profile names are the final queue names. Default is production, playback.

Note

interface.* Control the messaging interface. The default protocol is “scmp” but “scmps” (secure protocol) is used when valid SSL certificate and key are configured.

interface.bind

Type: ipbind

Local bind address and port of the messaging system. 0.0.0.0:18180 accepts connections from all clients, 127.0.0.1:18180 only from localhost. Default is 0.0.0.0:18180.

interface.acl

Type: list:ipmask

The IP access control list for clients which are allowed to connect to the interface.

interface.socketPortReuse

Type: boolean

SO_REUSEADDR socket option for the TCP listening socket. Default is true.

Note

interface.ssl.* SSL encryption is used if key and certificate are configured.

interface.ssl.bind

Type: ipbind

Additional local bind address and port of the messaging system in case SSL encryption is active. Default is 0.0.0.0:-1.

interface.ssl.acl

Type: list:ipmask

The IP access control list for clients which are allowed to connect to the interface.

interface.ssl.socketPortReuse

Type: boolean

SO_REUSEADDR socket option for the TCP listening socket. Default is true.

interface.ssl.key

Type: path

interface.ssl.certificate

Type: path

Note

queues.* Set the parameters for each messaging queue. The queues are used when listed in the :confval:`queues` parameter. Several queues can be used in parallel. For queues with without databases leave the processor parameters empty.

Note

queues.$name.* $name is a placeholder for the name to be used.

queues.\$name.groups

Type: list:string

Define the list of message groups added to the queue. If unset then the defaultGroups will be used. A queue will always add the default group "STATUS_GROUP". This parameter overrides defaultGroups.

queues.\$name.acl

Type: list:ipmask

The IP access control list for clients which are allowed to join the queue. Default is 0.0.0.0/0.

queues.\$name.maximumPayloadSize

Type: int

Unit: B

The maximum size in bytes of a message to be accepted. Clients which send larger messages will be disconnected. The default is 1MB. Default is 1048576.

queues.\$name.plugins

Type: list:string

List of plugins required by this queue. This is just a convenience parameter to improve configurations readability. The plugins can also be added to the global list of module plugins.

Example: dbstore

queues.\$name.processors.messages

Type: string

Interface name. For now, use "dbstore" to use a database.

Use empty for testing or playbacks without a database.

Note

queues.$name.processors.messages.dbstore.* Define the database connection parameters.

queues.\$name.processors.messages.dbstore.driver

Type: string

Selected the database driver to use. Database drivers are available through plugins. The default plugin is dbmysql which supports the MYSQL database server. It is activated with the core.plugins parameter.

queues.\$name.processors.messages.dbstore.read

Type: string

Sets the database read connection which is reported to clients that connect to this server. If a remote setup should be implemented, ensure that the hostname is reachable from the remote computer.

queues.\$name.processors.messages.dbstore.write

Type: string

Sets the database write connection which is private to scmaster. A separate write connection enables different permissions on the database level for scmaster and clients.

queues.\$name.processors.messages.dbstore.strictVersionCheck

Type: boolean

If enabled, the plugin will check the database schema version and refuse to start if the version doesn’t match the latest version. If disabled and the an object needs to be stored which is incompatible with the database schema this object is lost. Leave this option enabled unless you know exactly what are you doing and what the consequences are. Default is true.

http.filebase

Type: path

The directory served by the http server at staticPath. Default is @DATADIR@/scmaster/http/.

http.staticPath

Type: string

The URL path at which html files and assets are available. All files under filebase will be served at this URL path. Default is /.

http.brokerPath

Type: string

The URL path at which the broker websocket is available. Default is /.