]>
Commit | Line | Data |
---|---|---|
7d37e1a9 | 1 | .TH MOIRAD 8 "30 Nov 1988" "Project Athena" |
5834a392 | 2 | \" RCSID: $Header$ |
3 | .SH NAME | |
7d37e1a9 | 4 | moirad, startmoira \- Moira query daemon |
5834a392 | 5 | .SH SYNOPSIS |
7d37e1a9 | 6 | .B moirad |
5834a392 | 7 | .br |
7d37e1a9 | 8 | .B startmoira |
5834a392 | 9 | .SH DESCRIPTION |
7a7e796c | 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 | |
7d37e1a9 | 13 | .B moirad |
5834a392 | 14 | directly, it is started by |
7d37e1a9 | 15 | .B startmoira, |
5834a392 | 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. | |
5834a392 | 20 | If critical errors are detected, they are logged to |
6e31bf9a | 21 | .B /moira/critical.log |
5834a392 | 22 | and in a zephyrgram to class |
7d37e1a9 | 23 | .B MOIRA |
5834a392 | 24 | instance |
7d37e1a9 | 25 | .B MOIRA |
5834a392 | 26 | in addition to standard output. |
27 | Also, a journal file is kept in | |
6e31bf9a | 28 | .B /moira/journal |
5834a392 | 29 | logging every successful change of the database in a format that can |
30 | be replayed by | |
7a7e796c | 31 | .I mrtest(8). |
ea0caf4a | 32 | For the server to be able to function properly, it must be run as root |
6e31bf9a | 33 | and root must have access to the tables in the DBMS. |
5834a392 | 34 | .PP |
ea0caf4a | 35 | It is possible to shut down the database side of the server when it is |
00f3d199 | 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 | |
7a7e796c | 48 | file are returned as the Moira motd. |
00f3d199 | 49 | .PP |
7d37e1a9 | 50 | .B startmoira |
6e31bf9a | 51 | sets its working directory to /, disconnects from the terminal |
5834a392 | 52 | and puts itself in the background. It then starts |
6e31bf9a | 53 | .B /moira/bin/moirad, |
5834a392 | 54 | and will capture lines the server writes to standard output and log them |
55 | in | |
6e31bf9a | 56 | .B /moira/moira.log |
5834a392 | 57 | along with a timestamp. |
7d37e1a9 | 58 | .B startmoira |
5834a392 | 59 | will also log the exit status of the |
7d37e1a9 | 60 | .B moirad |
5834a392 | 61 | if it is non-zero. |
62 | .SH FILES | |
6e31bf9a | 63 | /moira/moira.log |
5834a392 | 64 | .br |
6e31bf9a | 65 | /moira/critical.log |
5834a392 | 66 | .br |
6e31bf9a | 67 | /moira/journal |
5834a392 | 68 | .br |
00f3d199 | 69 | /etc/smsdown |
70 | .br | |
6e31bf9a | 71 | /etc/athena/srvtab \- The server must be able to get Kerberos tickets for |
7a7e796c | 72 | "moira.[servername]". |
5834a392 | 73 | .SH "SEE ALSO" |
7a7e796c | 74 | The Project Athena Technical Plan section on Moira. |