]>
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 |
27 | .B /u1/sms/critical.log | |
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 | |
34 | .B /u1/sms/journal | |
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 |
39 | and root must have access to the tables through RTI Ingres. | |
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 |
5834a392 | 57 | sets its working directory to the root, disconnects from the terminal |
58 | and puts itself in the background. It then starts | |
7d37e1a9 | 59 | .B /u1/sms/bin/moirad, |
5834a392 | 60 | and will capture lines the server writes to standard output and log them |
61 | in | |
7d37e1a9 | 62 | .B /u1/sms/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 | |
7d37e1a9 | 69 | /u1/sms/moira.log |
5834a392 | 70 | .br |
71 | /u1/sms/critical.log | |
72 | .br | |
73 | /u1/sms/journal | |
74 | .br | |
00f3d199 | 75 | /etc/smsdown |
76 | .br | |
7a7e796c | 77 | /etc/srvtab \- The server must be able to get Kerberos tickets for |
78 | "moira.[servername]". | |
5834a392 | 79 | .SH "SEE ALSO" |
7a7e796c | 80 | The Project Athena Technical Plan section on Moira. |