scmaster¶
scmaster
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
The enabled messaging queues. The profile names are the final queue names. Default is
production, playback
.
-
interface.bind
¶ Type: ipbind
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
.
-
interface.ssl.bind
¶ Type: ipbind
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
/
.