man/reg_svr.8

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