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 |
---|
4 | dcm, 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 |
---|
11 | The |
---|
12 | .B dcm |
---|
13 | must be run periodically on the Moira server. Rather than invoke |
---|
14 | .B dcm |
---|
15 | directly, one generally runs |
---|
16 | .B startdcm, |
---|
17 | which starts the dcm running in the proper working directory and |
---|
18 | captures logging messages. |
---|
19 | .PP |
---|
20 | The |
---|
21 | .B dcm |
---|
22 | may be disabled by the presence of the file |
---|
23 | .I /etc/nodcm |
---|
24 | or by setting the value of |
---|
25 | .I dcm_enable |
---|
26 | to zero in the Moira database. Logging is done to standard output. |
---|
27 | If critical errors are detected, they are logged to |
---|
28 | .B /moira/critical.log |
---|
29 | and in a zephyrgram to class |
---|
30 | .B Moira |
---|
31 | instance |
---|
32 | .B DCM |
---|
33 | in addition to standard output. |
---|
34 | .PP |
---|
35 | For the actual generation of config files, the |
---|
36 | .B dcm |
---|
37 | will fork off generator programs of the form |
---|
38 | .B /moira/bin/\fIservice\fB.gen. |
---|
39 | Each generator takes as an argument the name of the output file to |
---|
40 | produce. Many of them also require working directories in |
---|
41 | .B /moira/dcm/\fIservice\fB. |
---|
42 | A generator exits with a status code defined in |
---|
43 | .I <mr_et.h>. |
---|
44 | In particular, |
---|
45 | .B MR_NO_CHANGE |
---|
46 | is a common exit status if the database hasn't changed since the last |
---|
47 | time this generator was run. |
---|
48 | .PP |
---|
49 | .B startdcm |
---|
50 | sets its working directory to the root, disconnects from the terminal |
---|
51 | and puts itself in the background. It then starts |
---|
52 | .B /moira/bin/dcm, |
---|
53 | and will capture lines the dcm writes to standard output and log them |
---|
54 | in |
---|
55 | .B /moira/dcm.log |
---|
56 | along with a timestamp. |
---|
57 | .B startdcm |
---|
58 | will also log the exit status of the |
---|
59 | .B dcm |
---|
60 | if 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 |
---|
67 | here. |
---|
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" |
---|
74 | The Project Athena Technical Plan section on Moira. |
---|
75 | |
---|