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 |
---|
4 | reg_svr, startreg \- Moira user account registration server |
---|
5 | .SH SYNOPSIS |
---|
6 | .B reg_svr |
---|
7 | .br |
---|
8 | .B startreg |
---|
9 | .SH DESCRIPTION |
---|
10 | The registration server |
---|
11 | must be running on the machine hosting the Moira database for the |
---|
12 | .I userreg |
---|
13 | program to function. Rather than invoke |
---|
14 | .B reg_svr |
---|
15 | directly, it is started by |
---|
16 | .B startreg, |
---|
17 | which starts the daemon running in the proper working directory and |
---|
18 | captures logging messages. |
---|
19 | .PP |
---|
20 | Logging is done to standard output. |
---|
21 | If critical errors are detected, they are logged to |
---|
22 | .B /moira/critical.log |
---|
23 | and in a zephyrgram to class |
---|
24 | .B MOIRA |
---|
25 | instance |
---|
26 | .B REG_SVR |
---|
27 | in addition to standard output. |
---|
28 | Also, a journal file is kept in |
---|
29 | .B /moira/journal.reg |
---|
30 | logging every successful change of the database in a format that can |
---|
31 | be replayed by |
---|
32 | .I mrtest(8). |
---|
33 | For the server to be able to function properly, if must be run as root |
---|
34 | and root must have access to the tables in the DBMS. Also, |
---|
35 | Kerberos principal "moira.[servername]" must be on the Kerberos admin |
---|
36 | server ACL to create new principals and set their passwords. |
---|
37 | .PP |
---|
38 | .B startreg |
---|
39 | sets its working directory to the root, disconnects from the terminal |
---|
40 | and puts itself in the background. It then starts |
---|
41 | .B /moira/bin/reg_svr, |
---|
42 | and will capture lines the server writes to standard output and log them |
---|
43 | in |
---|
44 | .B /moira/reg_svr.log |
---|
45 | along with a timestamp. |
---|
46 | .B startreg |
---|
47 | will also log the exit status of the |
---|
48 | .B reg_svr |
---|
49 | if 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 |
---|
63 | Jay Berkenbilt, Bill Sommerfeld |
---|
64 | .SH "SEE ALSO" |
---|
65 | userreg(1), The Project Athena Technical Plan section on Moira. |
---|