Service Directory Daemon Configuration Variables

Jump to: navigation, search


How to configure

The Service Directory Daemon can be configured by setting configuration values with the Master Control Console.

FireStorm Daemon

The Service Directory Daemon is a FireStorm Daemon, so it has those configuration values available:

Parm Name Parm Type Description Default value
MaximumNetworkSendBytes integer Maximum chunk of the communication stream given to the non-ASIO network layer in one send call 65536
FireupReconnectDelay integer Base sleep time in milliseconds to pause in between attempts to connect to the fireup daemon 1000
FireupReconnectAttemptMax integer Number of times to attempt connection to fireup daemon; after this many failed attempts, process will exit 10
LogRateInterval integer Length of time in milliseconds to accumulate counts of log messages sent 5000
LogLimitPerInterval integer Maximum number of log messages to send to fireup during any given log rate interval 250
defaultWriteTimeoutMillis integer Non-ASIO communication layer forces a disconnect if it is unable to send data after this many milliseconds 5000
defaultInactivityLimitMillis integer Non-ASIO communication layer forces a disconnect if there has been no activity after this many milliseconds 300000
defaultHeartBeatMillis integer Non-ASIO communication layer sends a heartbeat message after this many milliseconds 60000
deleteConfigFile integer Configuration file for the process is deleted after process run completes unless this is set to 0 1
SleepOnStart integer Time in milliseconds to sleep the process after reading in configurations, to allow for debuggers to attach 0
minimumCycleTime integer Time in milliseconds to schedule each application pump cycle 7
ApplicationDisplayName string Used as a display name for the process in Post Office Router and Stat Station ""
OutwardFacingIPAddress string IP address used to bind client facing listeners
ReportedOutwardFacingIPAddress string IP address that client facing listeners report to the Service Directory
InwardFacingIPAddress string IP address used to bind internal connection listeners
loggingDisabled integer Setting this to a non-zero number will disable logging to Master Control 0
StatsTimerMinimumMillis integer Minimum elapsed time measurable by stats collection 1
StatsUpdateIntervalSeconds integer Frequency in seconds of stats updates to the stat server 10
StatsUpdateMailboxName string Well known mailbox name of the stat server StatStation
StatsUppercaseAccountNames integer A non-zero value means all accounts are reported in upper case to the stat server 1
sendingBandwidth integer the rate at which data will be sent in bytes per millisecond 0
receivingBandwidth integer the rate at which data should be sent in bytes per millisecond 0
sendingDelay integer simulated sending side delay in milliseconds per packet 0
receptionDelay integer simulated receiving side delay in milliseconds per packet 0

PO Router

It also contains the configurations of the POMatrix (Post Office Matrix), so that can be configured with the following values:

Parm Name Parm Type Description Default value
poRouterProtocol string protocol to be used for the post office router connection packet:MD5
poRouterHost string (currently unused)
StatusUpdateInterval integer how often, in milliseconds, to update statistics for Master Control 60000
poRouterConnectionTimeout integer (currently unused) 60000
poRouterHeartbeat integer (currently unused) 60000
poRouterPort integer port number to be used for the post office router connection 63333
poRouterSuspendedTime integer in milliseconds (currently unused) 2000
poRouterTransport string transport level protocol to be used for the post office router listener connection tcp

Service Directory

The configuration values specific to the Service Directory are:

Parm Name Parm Type Description Default value
masterControlServiceDirectoryTransport string connect string that refers to the port master control has open for service directories to get status information on tcp:localhost:49277
ServiceDirectoryStatisticsPublishRate int How often the service directory publishes its statistics to master control 30000
ServiceDirectoryPublishedDataTimeout int when to time out the list of transports sent to the service directory from the worlds 30000
DudeManagerTransport string transport that the service directory is listening for client connections on tcp::10357
ServiceDirectoryPublishName string not used by the dude manager in the service directory
AddressForCreateProxyMailboxes string part of dude manager's internal workings BoxDude
DudeManagerProtocol string protocol used by the dudemanager for the client connections packet
LogoffMailingListName string mailbox used internally by dude manager DudeLogoffList
DudeManagerPrefix string an optional prefix for all the dude manager mailboxes
DudeManagerDomainID string internal name of the dude manager's connection domain theDudeManager
DisconnectBoxName string name of a mailbox used by the dudemanager DiscoDude
LogonMailingListName string Name of the mailing list used to notify logins internally to the dude manager DudeLogonList
DudeManagerSubscriberWatcher string name of a mailbox used by the dudemanager DudeManagerSubscriberWatcher
MaxQueuedMessagesWhileWaitingAuthentication int Messages from a client are queued until the client is authenticated, if too many come in before authentication, we drop the user 100
ServiceDirectoryPublishRate int used by processes that publish their transports to the service directory 30000
ServiceDirectoryMatrixTransports string pipe separated list of transports of the service directories used by processes publishing transports
LogonDeferTime int time to wait before forwarding logons to the dude manager 150
ServiceDirectoryMasterControlRefreshRate int how often to request the updated list of world statuses from master control 5000
ServiceDirectoryWorldFilter string described below show:.*

Service Directory World Filter

The ServiceDirectoryWorldFilter configuration variable needs a little more explanation. It is a string made of "|" separated strings that start with either a "hide:" or a "show:" prefix and end with a perl syntax regular expression. Some example filters are:


Note: If the variable is not formatted properly, all worlds will be shown. Also, the worlds are being filtered by the account's subscriptions before being filtered by these filters.

Personal tools