[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 |