man/dcm.8

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