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 SMS database and update servers
   5 .SH SYNOPSIS
   6 .B dcm
   7 [-d level]
   8 .br
   9 .B startdcm
  10 .SH DESCRIPTION
  11 The
  12 .B dcm
  13 must be run periodically on the SMS server.  It is usually run every
  14 15 minutes by the
  15 .I cron
  16 daemon.  Rather than invoke
  17 .B dcm
  18 directly, cron runs
  19 .B startdcm,
  20 which starts the dcm running in the proper working directory and
  21 captures logging messages.
  22 .PP
  23 The
  24 .B dcm
  25 may be disabled by the presence of the file
  26 .I /etc/nodcm
  27 or by setting the value of
  28 .I dcm_enable
  29 to zero in the SMS database.  Debug mode may be enabled in the dcm by
  30 specifying an integer on the command line or by setting the
  31 environment variable
  32 .B DEBUG.
  33 The command line value will override the environment variable.  Three
  34 bits are currently defined in the debug value: DBG_PLAIN = 01,
  35 DBG_VERBOSE = 02, DBG_TRACE = 04.  Logging is done to standard output.
  36 If critical errors are detected, they are logged to
  37 .B /u1/sms/critical.log
  38 and in a zephyrgram to class
  39 .B SMS
  40 instance
  41 .B DCM
  42 in addition to standard output.
  43 For the
  44 .B dcm
  45 to function properly,
  46 .I root
  47 must both be authorized to access each of the tables by RTI Ingres,
  48 and on the query acls for each of the queries the
  49 .B dcm
  50 will execute.
  51 .PP
  52 For the actual generation of config files, the
  53 .B dcm
  54 will for off generator programs of the form
  55 .B /u1/sms/bin/\fIservice\fB.gen.
  56 Each generator takes as an argument the name of the output file to
  57 produce.  Many of them also require working directories in
  58 .B /u1/sms/dcm/\fIservice\fB.
  59 A generator exits with a status code defined in
  60 .I <sms_et.h>.
  61 In particular,
  62 .B SMS_NO_CHANGE
  63 is a common exit status if the database hasn't changed since the last
  64 time this generator was run.
  65 .PP
  66 .B startdcm
  67 sets its working directory to the root, disconnects from the terminal
  68 and puts itself in the background.  It then starts
  69 .B /u1/sms/bin/dcm,
  70 and will capture lines the dcm writes to standard output and log them
  71 in
  72 .B /u1/sms/dcm.log
  73 along with a timestamp.
  74 .B startdcm
  75 will also log the exit status of the
  76 .B dcm
  77 if it is non-zero.
  78 .SH FILES
  79 /u1/sms/dcm.log
  80 .br
  81 /u1/sms/critical.log
  82 .br
  83 /u1/sms/dcm/locks/* \- empty files will be created here for advisory locks.
  84 .br
  85 /u1/sms/bin/*.gen \- service file generators will be searched for
  86 here.
  87 .br
  88 /tmp/tkt_dcm \- temporary Kerberos ticket storage.
  89 .br
  90 /etc/srvtab \- The dcm must be able to get Kerberos tickets for "sms"
  91 (null instance).
  92 .SH "SEE ALSO"
  93 The Project Athena Technical Plan section on SMS.