]>
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. | |
20 | How much gets logged by | |
7d37e1a9 | 21 | .B moirad |
5834a392 | 22 | is controlled by the variable |
23 | .I log_flags | |
24 | which is compiled into the file | |
7d37e1a9 | 25 | .I mr_srvdata.c. |
5834a392 | 26 | If critical errors are detected, they are logged to |
6e31bf9a | 27 | .B /moira/critical.log |
5834a392 | 28 | and in a zephyrgram to class |
7d37e1a9 | 29 | .B MOIRA |
5834a392 | 30 | instance |
7d37e1a9 | 31 | .B MOIRA |
5834a392 | 32 | in addition to standard output. |
33 | Also, a journal file is kept in | |
6e31bf9a | 34 | .B /moira/journal |
5834a392 | 35 | logging every successful change of the database in a format that can |
36 | be replayed by | |
7a7e796c | 37 | .I mrtest(8). |
5834a392 | 38 | For the server to be able to function properly, if must be run as root |
6e31bf9a | 39 | and root must have access to the tables in the DBMS. |
5834a392 | 40 | .PP |
00f3d199 | 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 | |
7a7e796c | 54 | file are returned as the Moira motd. |
00f3d199 | 55 | .PP |
7d37e1a9 | 56 | .B startmoira |
6e31bf9a | 57 | sets its working directory to /, disconnects from the terminal |
5834a392 | 58 | and puts itself in the background. It then starts |
6e31bf9a | 59 | .B /moira/bin/moirad, |
5834a392 | 60 | and will capture lines the server writes to standard output and log them |
61 | in | |
6e31bf9a | 62 | .B /moira/moira.log |
5834a392 | 63 | along with a timestamp. |
7d37e1a9 | 64 | .B startmoira |
5834a392 | 65 | will also log the exit status of the |
7d37e1a9 | 66 | .B moirad |
5834a392 | 67 | if it is non-zero. |
68 | .SH FILES | |
6e31bf9a | 69 | /moira/moira.log |
5834a392 | 70 | .br |
6e31bf9a | 71 | /moira/critical.log |
5834a392 | 72 | .br |
6e31bf9a | 73 | /moira/journal |
5834a392 | 74 | .br |
00f3d199 | 75 | /etc/smsdown |
76 | .br | |
6e31bf9a | 77 | /etc/athena/srvtab \- The server must be able to get Kerberos tickets for |
7a7e796c | 78 | "moira.[servername]". |
5834a392 | 79 | .SH "SEE ALSO" |
7a7e796c | 80 | The Project Athena Technical Plan section on Moira. |