man/dcm.8

   1 .TH DCM 8 "30 Nov 1988" "Project Athena"
   2 \" RCSID: $Header$
   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