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.
