]>
Commit | Line | Data |
---|---|---|
5834a392 | 1 | .TH DCM 8 "30 Nov 1988" "Project Athena" |
2 | \" RCSID: $Header$ | |
3 | .SH NAME | |
7014af98 | 4 | dcm, startdcm \- build config files from Moira database and update servers |
5834a392 | 5 | .SH SYNOPSIS |
6 | .B dcm | |
7 | [-d level] | |
8 | .br | |
9 | .B startdcm | |
10 | .SH DESCRIPTION | |
11 | The | |
12 | .B dcm | |
6e31bf9a | 13 | must be run periodically on the Moira server. Rather than invoke |
5834a392 | 14 | .B dcm |
6e31bf9a | 15 | directly, one generally runs |
5834a392 | 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 | |
6e31bf9a | 26 | to zero in the Moira database. Logging is done to standard output. |
5834a392 | 27 | If critical errors are detected, they are logged to |
6e31bf9a | 28 | .B /moira/critical.log |
5834a392 | 29 | and in a zephyrgram to class |
7014af98 | 30 | .B Moira |
5834a392 | 31 | instance |
32 | .B DCM | |
33 | in addition to standard output. | |
8d655ac7 | 34 | .PP |
5834a392 | 35 | For the actual generation of config files, the |
36 | .B dcm | |
7014af98 | 37 | will fork off generator programs of the form |
6e31bf9a | 38 | .B /moira/bin/\fIservice\fB.gen. |
5834a392 | 39 | Each generator takes as an argument the name of the output file to |
40 | produce. Many of them also require working directories in | |
6e31bf9a | 41 | .B /moira/dcm/\fIservice\fB. |
5834a392 | 42 | A generator exits with a status code defined in |
7d37e1a9 | 43 | .I <mr_et.h>. |
5834a392 | 44 | In particular, |
7d37e1a9 | 45 | .B MR_NO_CHANGE |
5834a392 | 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 | |
6e31bf9a | 52 | .B /moira/bin/dcm, |
5834a392 | 53 | and will capture lines the dcm writes to standard output and log them |
54 | in | |
6e31bf9a | 55 | .B /moira/dcm.log |
5834a392 | 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 | |
6e31bf9a | 62 | /moira/dcm.log |
5834a392 | 63 | .br |
6e31bf9a | 64 | /moira/critical.log |
5834a392 | 65 | .br |
6e31bf9a | 66 | /moira/dcm/locks/* \- empty files will be created here for advisory locks. |
5834a392 | 67 | .br |
6e31bf9a | 68 | /moira/bin/*.gen \- service file generators will be searched for |
5834a392 | 69 | here. |
70 | .br | |
34e7a903 | 71 | /tmp/tkt_dcm \- temporary Kerberos ticket storage. |
72 | .br | |
6e31bf9a | 73 | /etc/athena/srvtab \- The dcm must be able to get Kerberos tickets for "sms" |
34e7a903 | 74 | (null instance). |
5834a392 | 75 | .SH "SEE ALSO" |
7014af98 | 76 | The Project Athena Technical Plan section on Moira. |