dcs(1M) (man pages section 1M: System Administration Commands)

man pages section 1M: System Administration Commands

dcs(1M)

NAME

dcs– domain configuration server

SYNOPSIS

/usr/lib/dcs

-s

sessions

DESCRIPTION

The Domain Configuration Server (DCS) is a daemon process that runs on Sun servers that support remote Dynamic Reconfiguration (DR) clients. It is started by inetd(1M) when the first DR request is received from a client connecting to the network service sun-dr. After the DCS accepts a DR request, it uses the libcfgadm(3LIB) interface to execute the DR operation. After the operation is performed, the results are returned to the client.

The DCS listens on the network service labeled sun-dr. Its underlying protocol is TCP, and it is invoked as an inetd server using the TCP transport. The entries for the DCS in the /etc/inet/inetd.conf file are as follows:

sun-dr stream tcp wait root /usr/lib/dcs dcs
sun-dr stream tcp6 wait root /usr/lib/dcs dcs

These entries enable remote DR operations. If you remove the entries, DR operations initiated from a remote host fail. There is no negative impact on the server. If you are using a Sun Fire high-end system and IPSec is configured on the sun-dr port (port 665), you must also remove the policies in /etc/inet/ipsecinit.conf that reference the sun-dr port, then use the ipsecconf(1M) command with appropriate options to flush the policies.

If you remove the sun-dr entries from /etc/inet/inetd.conf without deleting and flushing the corresponding entries from /etc/inet/ipsecinit.conf, any process that attempts to use the sun-dr port will hang. This is because the IPSec policy is still in effect for that port.

OPTIONS

The following options are supported:

-s sessions: Set the number of active sessions that the DCS allows at any one time. When the limit is reached, the DCS stops accepting connections until active sessions complete the execution of their DR operation. If this option is not specified, a default value of 128 is used.

ERRORS

The DCS uses syslog(3C) to report status and error messages. All of the messages are logged with the LOG_DAEMON facility. Error messages are logged with the LOG_ERR and LOG_NOTICE priorities, and informational messages are logged with the LOG_INFO priority. The default entries in the /etc/syslog.conf file log all of the DCS error messages to the /var/adm/messages log.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdcsu, SUNWdcsr