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 If critical errors are detected, they are logged to
  21 .B /moira/critical.log
  22 and in a zephyrgram to class
  23 .B MOIRA
  24 instance
  25 .B MOIRA
  26 in addition to standard output.
  27 Also, a journal file is kept in
  28 .B /moira/journal
  29 logging every successful change of the database in a format that can
  30 be replayed by
  31 .I mrtest(8).
  32 For the server to be able to function properly, it must be run as root
  33 and root must have access to the tables in the DBMS.
  34 .PP
  35 It is possible to shut down the database side of the server when it is
  36 necessary to lock out clients.  In this state the server will only
  37 respond to noop and motd requests.  When the file
  38 .B /etc/smsdown
  39 exists, the server will close the database the next time there are no
  40 clients using it.  To force the server to close down the database as
  41 soon as any active operation is finished, send it a USR1 signal.  The
  42 first time a new client connects after the
  43 .B /etc/smsdown
  44 file is removed, the database will be re-opened.  To force an
  45 immediate reopening, send the server a USR2 signal.  The contents of
  46 the
  47 .B /etc/smsdown
  48 file are returned as the Moira motd.
  49 .PP
  50 .B startmoira
  51 sets its working directory to /, disconnects from the terminal
  52 and puts itself in the background.  It then starts
  53 .B /moira/bin/moirad,
  54 and will capture lines the server writes to standard output and log them
  55 in
  56 .B /moira/moira.log
  57 along with a timestamp.
  58 .B startmoira
  59 will also log the exit status of the
  60 .B moirad
  61 if it is non-zero.
  62 .SH FILES
  63 /moira/moira.log
  64 .br
  65 /moira/critical.log
  66 .br
  67 /moira/journal
  68 .br
  69 /etc/smsdown
  70 .br
  71 /etc/athena/srvtab \- The server must be able to get Kerberos tickets for
  72 "moira.[servername]".
  73 .SH "SEE ALSO"
  74 The Project Athena Technical Plan section on Moira.