| 1 | .TH REG_SVR 8 "30 Nov 1988" "Project Athena" |
|---|
| 2 | \" 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 $ |
|---|
| 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. |
|---|
