The Berkeley Service Discovery Service
Configuration Options
[Homepage] [System overview] [Clients] [Services] [Servers] [Config options]

This page contains a listing of all the configuration options used in the SDS system. To learn how to use the Ninja configuration files, see the configuration file tutorial.

For each option, a little explanation is given, along with some sample values. Also, we indicate what parts of the SDS system read the parameters from the configuration file. For example, the parameter sds.Server.Signer defines which certificate should be used for the SDS server. However, setting this option only matters when your iSpace is running the SDS server. All other components, such as the clients and the services, ignore the value of sds.Server.Signer and get the name of the SDS server certificate through the SDS server announcements. This is the case with most of the options: the iSpace running the SDS server gets the values from its configuration file, and publishes them for all other components to use through the SDS server announcements.

Below is the table of configuration options that can be set through the configuration file mechanism:

Option name Description Who reads it? Example values
sds.server.Signer The name of the certicate to be used as the principal running the SDS server. SDS server "sds-admin@cs.berkeley.edu."
sds.server.SignerPrivateKey The file name of the private key associated with principal's certificate. SDS server /var/home/sds-admin/private-key
sds.server.ServerCoverage A list (comma separated) of network areas to be covered by this SDS server. Each "extent" is described by listing a base IP address and a mask to give which address should be used. SDS server 128.32.45.0/255.255.255.0, 128.64.56.0/255.255.255.0
sds.CapabilitySigner The certificate representing the valid capability signer SDS server capability@cs.berkeley.edu.
sds.server.ServiceAnnounceChannel The multicast address on which this SDS server will listen for service announcements. SDS server 226.125.6.85
sds.server.ServiceAnnouncePort The port on which the SDS server will listen for service announcements. SDS server 6778
sds.ispaceforwarder.ServiceAnnounceTTL The TTL to use when sending the service descriptions to the SDS servers. Services 10
sds.ServerAnnounceChannel The global multicast channel on which SDS servers will announce their existence. Change this to create independent SDS areas. This parameter is used by both the SDS server and SDS clients, services. SDS server, clients, services 226.125.6.87
sds.ServerAnnouncePort The port on which SDS servers will announce their existence. SDS server, clients, services 6687
sds.ServerAnnounceTTL The TTL used to send SDS server announcements. SDS server 10
sds.server.CertificateAuthority The URL of certificate registry for the SDS server to use. SDS server ninjarmi://localhost/ninja.ispace.auth.CertificateRegistry
sds.server.CapabilityDistributor The URL of the capability distributor for the SDS server to use. SDS server ninjarmi://localhost/ninja.sds.CapabilityDistributor
sds.server.ServiceAnnounceRate The number of milliseconds between service announcements. Changing this option won't affect services, since services only use the value that's in the SDS server announcement. SDS server 20000
sds.server.ServerAnnounceRate The number of milliseconds between server announcements. SDS server 60000