-.TH SMSD 8 "30 Nov 1988" "Project Athena"
+.TH MOIRAD 8 "30 Nov 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
-smsd \- SMS query daemon
-.br
-startsms \- start the SMS daemon running, capturing log files
+moirad, startmoira \- Moira query daemon
.SH SYNOPSIS
-.B smsd
+.B moirad
.br
-.B startsms
+.B startmoira
.SH DESCRIPTION
-The SMS server
-must be running on the machine hosting the SMS database for any of the
-SMS clients to function. Rather than invoke
-.B smsd
+The Moira server
+must be running on the machine hosting the Moira database for any of the
+Moira clients to function. Rather than invoke
+.B moirad
directly, it is started by
-.B startsms,
+.B startmoira,
which starts the daemon running in the proper working directory and
captures logging messages.
.PP
Logging is done to standard output.
-How much gets logged by
-.B smsd
-is controlled by the variable
-.I log_flags
-which is compiled into the file
-.I sms_srvdata.c.
If critical errors are detected, they are logged to
-.B /u1/sms/critical.log
+.B /moira/critical.log
and in a zephyrgram to class
-.B SMS
+.B MOIRA
instance
-.B SMS
+.B MOIRA
in addition to standard output.
Also, a journal file is kept in
-.B /u1/sms/journal
+.B /moira/journal
logging every successful change of the database in a format that can
be replayed by
-.I smstest(8).
-For the server to be able to function properly, if must be run as root
-and root must have access to the tables through RTI Ingres.
+.I mrtest(8).
+For the server to be able to function properly, it must be run as root
+and root must have access to the tables in the DBMS.
+.PP
+It is possible to shut down the database side of the server when it is
+necessary to lock out clients. In this state the server will only
+respond to noop and motd requests. When the file
+.B /etc/smsdown
+exists, the server will close the database the next time there are no
+clients using it. To force the server to close down the database as
+soon as any active operation is finished, send it a USR1 signal. The
+first time a new client connects after the
+.B /etc/smsdown
+file is removed, the database will be re-opened. To force an
+immediate reopening, send the server a USR2 signal. The contents of
+the
+.B /etc/smsdown
+file are returned as the Moira motd.
.PP
-.B startsms
-sets its working directory to the root, disconnects from the terminal
+.B startmoira
+sets its working directory to /, disconnects from the terminal
and puts itself in the background. It then starts
-.B /u1/sms/bin/smsd,
+.B /moira/bin/moirad,
and will capture lines the server writes to standard output and log them
in
-.B /u1/sms/sms.log
+.B /moira/moira.log
along with a timestamp.
-.B startsms
+.B startmoira
will also log the exit status of the
-.B smsd
+.B moirad
if it is non-zero.
.SH FILES
-/u1/sms/sms.log
-.br
-/u1/sms/critical.log
+/moira/moira.log
.br
-/u1/sms/journal
+/moira/critical.log
.br
+/moira/journal
.br
-/tmp/tkt_dcm \- temporary Kerberos ticket storage.
+/etc/smsdown
.br
-/etc/srvtab \- The dcm must be able to get Kerberos tickets for "sms.sms".
+/etc/athena/srvtab \- The server must be able to get Kerberos tickets for
+"moira.[servername]".
.SH "SEE ALSO"
-The Project Athena Technical Plan section on SMS.
+The Project Athena Technical Plan section on Moira.
andersk / moira.git / blobdiff