From HEWIKI
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 |
127.0.0.1 |
ReportedOutwardFacingIPAddress |
string |
IP address that client facing listeners report to the Service Directory |
127.0.0.1 |
InwardFacingIPAddress |
string |
IP address used to bind internal connection listeners |
127.0.0.1 |
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:
show:HETraining|hide:.*
hide:HETraining|:show:HE.*|hide:.*
show:.*
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.