man/moirad.8

   1 .TH MOIRAD 8 "30 Nov 1988" "Project Athena"
   2 \" RCSID: $Header$
   3 .SH NAME
   4 moirad, startmoira \- Moira query daemon
   5 .SH SYNOPSIS
   6 .B moirad
   7 .br
   8 .B startmoira
   9 .SH DESCRIPTION
  10 The Moira server
  11 must be running on the machine hosting the Moira database for any of the
  12 Moira clients to function.  Rather than invoke
  13 .B moirad
  14 directly, it is started by
  15 .B startmoira,
  16 which starts the daemon running in the proper working directory and
  17 captures logging messages.
  18 .PP
  19 Logging is done to standard output.
  20 How much gets logged by
  21 .B moirad
  22 is controlled by the variable
  23 .I log_flags
  24 which is compiled into the file
  25 .I mr_srvdata.c.
  26 If critical errors are detected, they are logged to
  27 .B /u1/sms/critical.log
  28 and in a zephyrgram to class
  29 .B MOIRA
  30 instance
  31 .B MOIRA
  32 in addition to standard output.
  33 Also, a journal file is kept in
  34 .B /u1/sms/journal
  35 logging every successful change of the database in a format that can
  36 be replayed by
  37 .I mrtest(8).
  38 For the server to be able to function properly, if must be run as root
  39 and root must have access to the tables through RTI Ingres.
  40 .PP
  41 It is possible to shutdown the database side of the server when it is
  42 necessary to lock out clients.  In this state the server will only
  43 respond to noop and motd requests.  When the file
  44 .B /etc/smsdown
  45 exists, the server will close the database the next time there are no
  46 clients using it.  To force the server to close down the database as
  47 soon as any active operation is finished, send it a USR1 signal.  The
  48 first time a new client connects after the
  49 .B /etc/smsdown
  50 file is removed, the database will be re-opened.  To force an
  51 immediate reopening, send the server a USR2 signal.  The contents of
  52 the
  53 .B /etc/smsdown
  54 file are returned as the Moira motd.
  55 .PP
  56 .B startmoira
  57 sets its working directory to the root, disconnects from the terminal
  58 and puts itself in the background.  It then starts
  59 .B /u1/sms/bin/moirad,
  60 and will capture lines the server writes to standard output and log them
  61 in
  62 .B /u1/sms/moira.log
  63 along with a timestamp.
  64 .B startmoira
  65 will also log the exit status of the
  66 .B moirad
  67 if it is non-zero.
  68 .SH FILES
  69 /u1/sms/moira.log
  70 .br
  71 /u1/sms/critical.log
  72 .br
  73 /u1/sms/journal
  74 .br
  75 /etc/smsdown
  76 .br
  77 /etc/srvtab \- The server must be able to get Kerberos tickets for
  78 "moira.[servername]".
  79 .SH "SEE ALSO"
  80 The Project Athena Technical Plan section on Moira.