source: trunk/third/moira/man/dcm.8 @ 24319

Revision 24319, 2.0 KB checked in by broder, 15 years ago (diff)
New Moira snapshot from SVN.
Line 
1.TH DCM 8 "30 Nov 1988" "Project Athena"
2\" RCSID: $HeadURL: svn+ssh://svn.mit.edu/moira/trunk/moira/man/dcm.8 $ $Id: dcm.8 3956 2010-01-05 20:56:56Z zacheiss $
3.SH NAME
4dcm, startdcm \- build config files from Moira database and update servers
5.SH SYNOPSIS
6.B dcm
7[servicename ...]
8.br
9.B startdcm
10.SH DESCRIPTION
11The
12.B dcm
13must be run periodically on the Moira server.  Rather than invoke
14.B dcm
15directly, one generally runs
16.B startdcm,
17which starts the dcm running in the proper working directory and
18captures logging messages.
19.PP
20The
21.B dcm
22may be disabled by the presence of the file
23.I /etc/nodcm
24or by setting the value of
25.I dcm_enable
26to zero in the Moira database. Logging is done to standard output.
27If critical errors are detected, they are logged to
28.B /moira/critical.log
29and in a zephyrgram to class
30.B Moira
31instance
32.B DCM
33in addition to standard output.
34.PP
35For the actual generation of config files, the
36.B dcm
37will fork off generator programs of the form
38.B /moira/bin/\fIservice\fB.gen.
39Each generator takes as an argument the name of the output file to
40produce.  Many of them also require working directories in
41.B /moira/dcm/\fIservice\fB.
42A generator exits with a status code defined in
43.I <mr_et.h>.
44In particular,
45.B MR_NO_CHANGE
46is a common exit status if the database hasn't changed since the last
47time this generator was run.
48.PP
49.B startdcm
50sets its working directory to the root, disconnects from the terminal
51and puts itself in the background.  It then starts
52.B /moira/bin/dcm,
53and will capture lines the dcm writes to standard output and log them
54in
55.B /moira/dcm.log
56along with a timestamp.
57.B startdcm
58will also log the exit status of the
59.B dcm
60if it is non-zero.
61.SH FILES
62/moira/dcm.log
63.br
64/moira/critical.log
65.br
66/moira/bin/*.gen \- service file generators will be searched for
67here.
68.br
69/tmp/tkt_dcm \- temporary Kerberos ticket storage.
70.br
71/etc/athena/srvtab \- The dcm must be able to get Kerberos tickets for "sms"
72(null instance).
73.SH "SEE ALSO"
74The Project Athena Technical Plan section on Moira.
75
Note: See TracBrowser for help on using the repository browser.