source: trunk/third/moira/man/moirad.8 @ 24250

Revision 24250, 2.3 KB checked in by broder, 15 years ago (diff)
New Moira snapshot from subversion. Sorry for the large diff - looks like all of the keywords changed in the SVN import process.
Line 
1.TH MOIRAD 8 "30 Nov 1988" "Project Athena"
2\" RCSID: $Header: /afs/.athena.mit.edu/astaff/project/moiradev/repository/moira/man/moirad.8,v 1.7 1998-05-26 18:14:12 danw Exp $
3.SH NAME
4moirad, startmoira \- Moira query daemon
5.SH SYNOPSIS
6.B moirad
7.br
8.B startmoira
9.SH DESCRIPTION
10The Moira server
11must be running on the machine hosting the Moira database for any of the
12Moira clients to function.  Rather than invoke
13.B moirad
14directly, it is started by
15.B startmoira,
16which starts the daemon running in the proper working directory and
17captures logging messages.
18.PP
19Logging is done to standard output.
20If critical errors are detected, they are logged to
21.B /moira/critical.log
22and in a zephyrgram to class
23.B MOIRA
24instance
25.B MOIRA
26in addition to standard output.
27Also, a journal file is kept in
28.B /moira/journal
29logging every successful change of the database in a format that can
30be replayed by
31.I mrtest(8).
32For the server to be able to function properly, it must be run as root
33and root must have access to the tables in the DBMS.
34.PP
35It is possible to shut down the database side of the server when it is
36necessary to lock out clients.  In this state the server will only
37respond to noop and motd requests.  When the file
38.B /etc/smsdown
39exists, the server will close the database the next time there are no
40clients using it.  To force the server to close down the database as
41soon as any active operation is finished, send it a USR1 signal.  The
42first time a new client connects after the
43.B /etc/smsdown
44file is removed, the database will be re-opened.  To force an
45immediate reopening, send the server a USR2 signal.  The contents of
46the
47.B /etc/smsdown
48file are returned as the Moira motd.
49.PP
50.B startmoira
51sets its working directory to /, disconnects from the terminal
52and puts itself in the background.  It then starts
53.B /moira/bin/moirad,
54and will capture lines the server writes to standard output and log them
55in
56.B /moira/moira.log
57along with a timestamp.
58.B startmoira
59will also log the exit status of the
60.B moirad
61if 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"
74The Project Athena Technical Plan section on Moira.
Note: See TracBrowser for help on using the repository browser.