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 |
---|
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. |
---|