Server Configuration

Server Configuration

The dbis-cachemgr daemon reads a configuration file at start-up, which is usually /etc/dbis-cachemgr.conf. When first installed, it contains some example settings. Those settings that are commented out (the line starts with a hash # character) represent the server's default settings and could be removed from the file with no effect.

Settings are organised by section, where a section begins:

[section]
parameter=value

The configuration settings that most commonly need to be changed in a new installation are described below. For a full list of settings, see the [DBIS Reference Manual] or run man dbis-cachemgr on a host where DBIS is installed.

Section	Parameter	Value
ldap	server_uri	A space-separated list of LDAP URIs representing all the LDAP servers that you wish dbis-cachemgr to use, in the format ldap://<hostname>:<port>, e.g. ldap://myldapserver:389.
	domain_dn	The base DN in the LDAP directory tree that marks the dbisDomainObject above the configuration map objects, e.g. sales.corp,ou=domain-mappings,o=infra.
	auth_method	By default simple authentication is used when binding with the LDAP servers, and in this version it is the only supported authentication method.
	auth_dn	DN of authentication principle for simple authentication. By default, anonymous authentication is used.
	auth_passwd	Password for the authentication principle.
balancer	policy	If multiple LDAP servers were provided in the server_uri parameter, the default behaviour is to use the first LDAP server all the time unless it is unavailable. This is failover policy. The policy can optionally be set to roundrobin instead, which sends each subsequent session to the next LDAP server in the list, in effect sharing the load between all available servers.

Once /etc/dbis-cachemgr.conf is configured, return to [Configuring DBIS] for the next steps in setting up a new installation.