]>
Commit | Line | Data |
---|---|---|
5834a392 | 1 | .TH REG_SVR 8 "30 Nov 1988" "Project Athena" |
2 | \" RCSID: $Header$ | |
3 | .SH NAME | |
9b34a940 | 4 | reg_svr, startreg \- Moira user account registration server |
5834a392 | 5 | .SH SYNOPSIS |
6 | .B reg_svr | |
7 | .br | |
8 | .B startreg | |
9 | .SH DESCRIPTION | |
10 | The registration server | |
9b34a940 | 11 | must be running on the machine hosting the Moira database for the |
5834a392 | 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 | |
6e31bf9a | 22 | .B /moira/critical.log |
5834a392 | 23 | and in a zephyrgram to class |
7d37e1a9 | 24 | .B MOIRA |
5834a392 | 25 | instance |
26 | .B REG_SVR | |
27 | in addition to standard output. | |
28 | Also, a journal file is kept in | |
6e31bf9a | 29 | .B /moira/journal.reg |
5834a392 | 30 | logging every successful change of the database in a format that can |
31 | be replayed by | |
9b34a940 | 32 | .I mrtest(8). |
5834a392 | 33 | For the server to be able to function properly, if must be run as root |
6e31bf9a | 34 | and root must have access to the tables in the DBMS. Also, |
9b34a940 | 35 | Kerberos principal "moira.[servername]" must be on the Kerberos admin |
36 | server ACL to create new principals and set their passwords. | |
5834a392 | 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 | |
6e31bf9a | 41 | .B /moira/bin/reg_svr, |
5834a392 | 42 | and will capture lines the server writes to standard output and log them |
43 | in | |
6e31bf9a | 44 | .B /moira/reg_svr.log |
5834a392 | 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 | |
6e31bf9a | 51 | /moira/reg_svr.log |
5834a392 | 52 | .br |
6e31bf9a | 53 | /moira/critical.log |
5834a392 | 54 | .br |
6e31bf9a | 55 | /moira/journal.reg |
5834a392 | 56 | .br |
57 | .br | |
58 | /tmp/tkt_ureg \- temporary Kerberos ticket storage. | |
59 | .br | |
ea0caf4a | 60 | /etc/athena/srvtab \- The reg_svr must be able to get Kerberos tickets for |
9b34a940 | 61 | "moira.[hostname]". |
8eeef30a | 62 | .SH AUTHORS |
63 | Jay Berkenbilt, Bill Sommerfeld | |
5834a392 | 64 | .SH "SEE ALSO" |
9b34a940 | 65 | userreg(1), The Project Athena Technical Plan section on Moira. |