.TH REG_SVR 8 "30 Nov 1988" "Project Athena"
\" RCSID: $HeadURL: svn+ssh://svn.mit.edu/moira/trunk/moira/man/reg_svr.8 $ $Id: reg_svr.8 3956 2010-01-05 20:56:56Z zacheiss $
.SH NAME
reg_svr, startreg \- Moira user account registration server
.SH SYNOPSIS
.B reg_svr
.br
.B startreg
.SH DESCRIPTION
The registration server
must be running on the machine hosting the Moira database for the 
.I userreg
program to function.  Rather than invoke
.B reg_svr
directly, it is started by
.B startreg,
which starts the daemon running in the proper working directory and
captures logging messages.
.PP
Logging is done to standard output.
If critical errors are detected, they are logged to
.B /moira/critical.log
and in a zephyrgram to class
.B MOIRA
instance
.B REG_SVR
in addition to standard output.
Also, a journal file is kept in
.B /moira/journal.reg
logging every successful change of the database in a format that can
be replayed by
.I mrtest(8).
For the server to be able to function properly, if must be run as root
and root must have access to the tables in the DBMS.  Also,
Kerberos principal "moira.[servername]" must be on the Kerberos admin
server ACL to create new principals and set their passwords.
.PP
.B startreg
sets its working directory to the root, disconnects from the terminal
and puts itself in the background.  It then starts
.B /moira/bin/reg_svr,
and will capture lines the server writes to standard output and log them
in
.B /moira/reg_svr.log
along with a timestamp.
.B startreg
will also log the exit status of the
.B reg_svr
if it is non-zero.
.SH FILES
/moira/reg_svr.log
.br
/moira/critical.log
.br
/moira/journal.reg
.br
.br
/tmp/tkt_ureg \- temporary Kerberos ticket storage.
.br
/etc/athena/srvtab \- The reg_svr must be able to get Kerberos tickets for
"moira.[hostname]".
.SH AUTHORS
Jay Berkenbilt, Bill Sommerfeld
.SH "SEE ALSO"
userreg(1), The Project Athena Technical Plan section on Moira.