source: trunk/third/moira/man/reg_svr.8 @ 23740

Revision 23740, 1.9 KB checked in by broder, 16 years ago (diff)
In moira: * New CVS snapshot (Trac: #195) * Drop patches that have been incorporated upstream. * Update to build without krb4 on systems that no longer have it. This doesn't build yet on squeeze, which lacks a krb4 library, but I'm committing now before I start hacking away at a patch to fix that.
Line 
1.TH REG_SVR 8 "30 Nov 1988" "Project Athena"
2\" RCSID: $Header: /afs/athena.mit.edu/astaff/project/moiradev/repository/moira/man/reg_svr.8,v 1.7 1998-05-26 18:14:14 danw Exp $
3.SH NAME
4reg_svr, startreg \- Moira user account registration server
5.SH SYNOPSIS
6.B reg_svr
7.br
8.B startreg
9.SH DESCRIPTION
10The registration server
11must be running on the machine hosting the Moira database for the
12.I userreg
13program to function.  Rather than invoke
14.B reg_svr
15directly, it is started by
16.B startreg,
17which starts the daemon running in the proper working directory and
18captures logging messages.
19.PP
20Logging is done to standard output.
21If critical errors are detected, they are logged to
22.B /moira/critical.log
23and in a zephyrgram to class
24.B MOIRA
25instance
26.B REG_SVR
27in addition to standard output.
28Also, a journal file is kept in
29.B /moira/journal.reg
30logging every successful change of the database in a format that can
31be replayed by
32.I mrtest(8).
33For the server to be able to function properly, if must be run as root
34and root must have access to the tables in the DBMS.  Also,
35Kerberos principal "moira.[servername]" must be on the Kerberos admin
36server ACL to create new principals and set their passwords.
37.PP
38.B startreg
39sets its working directory to the root, disconnects from the terminal
40and puts itself in the background.  It then starts
41.B /moira/bin/reg_svr,
42and will capture lines the server writes to standard output and log them
43in
44.B /moira/reg_svr.log
45along with a timestamp.
46.B startreg
47will also log the exit status of the
48.B reg_svr
49if it is non-zero.
50.SH FILES
51/moira/reg_svr.log
52.br
53/moira/critical.log
54.br
55/moira/journal.reg
56.br
57.br
58/tmp/tkt_ureg \- temporary Kerberos ticket storage.
59.br
60/etc/athena/srvtab \- The reg_svr must be able to get Kerberos tickets for
61"moira.[hostname]".
62.SH AUTHORS
63Jay Berkenbilt, Bill Sommerfeld
64.SH "SEE ALSO"
65userreg(1), The Project Athena Technical Plan section on Moira.
Note: See TracBrowser for help on using the repository browser.