[moira.git] / man / moirad.8

.TH SMSD 8 "30 Nov 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
smsd, startsms \- SMS query daemon
.SH SYNOPSIS
.B smsd
.br
.B startsms
.SH DESCRIPTION
The SMS server
must be running on the machine hosting the SMS database for any of the
SMS clients to function.  Rather than invoke
.B smsd
directly, it is started by
.B startsms,
which starts the daemon running in the proper working directory and
captures logging messages.
.PP
Logging is done to standard output.
How much gets logged by
.B smsd
is controlled by the variable
.I log_flags
which is compiled into the file
.I sms_srvdata.c.
If critical errors are detected, they are logged to
.B /u1/sms/critical.log
and in a zephyrgram to class
.B SMS
instance
.B SMS
in addition to standard output.
Also, a journal file is kept in
.B /u1/sms/journal
logging every successful change of the database in a format that can
be replayed by
.I smstest(8).
For the server to be able to function properly, if must be run as root
and root must have access to the tables through RTI Ingres.
.PP
It is possible to shutdown the database side of the server when it is
necessary to lock out clients.  In this state the server will only
respond to noop and motd requests.  When the file
.B /etc/smsdown
exists, the server will close the database the next time there are no
clients using it.  To force the server to close down the database as
soon as any active operation is finished, send it a USR1 signal.  The
first time a new client connects after the
.B /etc/smsdown
file is removed, the database will be re-opened.  To force an
immediate reopening, send the server a USR2 signal.  The contents of
the
.B /etc/smsdown
file are returned as the SMS motd.
.PP
.B startsms
sets its working directory to the root, disconnects from the terminal
and puts itself in the background.  It then starts
.B /u1/sms/bin/smsd,
and will capture lines the server writes to standard output and log them
in
.B /u1/sms/sms.log
along with a timestamp.
.B startsms
will also log the exit status of the
.B smsd
if it is non-zero.
.SH FILES
/u1/sms/sms.log
.br
/u1/sms/critical.log
.br
/u1/sms/journal
.br
/etc/smsdown
.br
/etc/srvtab \- The dcm must be able to get Kerberos tickets for "sms.sms".
.SH "SEE ALSO"
The Project Athena Technical Plan section on SMS.
Commit	Line	Data
5834a392	1	.TH SMSD 8 "30 Nov 1988" "Project Athena"
	2	\" RCSID: $Header$
	3	.SH NAME
2ba19438	4	smsd, startsms \- SMS query daemon
5834a392	5	.SH SYNOPSIS
	6	.B smsd
	7	.br
	8	.B startsms
	9	.SH DESCRIPTION
	10	The SMS server
	11	must be running on the machine hosting the SMS database for any of the
	12	SMS clients to function. Rather than invoke
	13	.B smsd
	14	directly, it is started by
	15	.B startsms,
	16	which starts the daemon running in the proper working directory and
	17	captures logging messages.
	18	.PP
	19	Logging is done to standard output.
	20	How much gets logged by
	21	.B smsd
	22	is controlled by the variable
	23	.I log_flags
	24	which is compiled into the file
	25	.I sms_srvdata.c.
	26	If critical errors are detected, they are logged to
	27	.B /u1/sms/critical.log
	28	and in a zephyrgram to class
	29	.B SMS
	30	instance
	31	.B SMS
	32	in addition to standard output.
	33	Also, a journal file is kept in
	34	.B /u1/sms/journal
	35	logging every successful change of the database in a format that can
	36	be replayed by
	37	.I smstest(8).
	38	For the server to be able to function properly, if must be run as root
	39	and root must have access to the tables through RTI Ingres.
	40	.PP
00f3d199	41	It is possible to shutdown the database side of the server when it is
	42	necessary to lock out clients. In this state the server will only
	43	respond to noop and motd requests. When the file
	44	.B /etc/smsdown
	45	exists, the server will close the database the next time there are no
	46	clients using it. To force the server to close down the database as
	47	soon as any active operation is finished, send it a USR1 signal. The
	48	first time a new client connects after the
	49	.B /etc/smsdown
	50	file is removed, the database will be re-opened. To force an
	51	immediate reopening, send the server a USR2 signal. The contents of
	52	the
	53	.B /etc/smsdown
	54	file are returned as the SMS motd.
	55	.PP
5834a392	56	.B startsms
	57	sets its working directory to the root, disconnects from the terminal
	58	and puts itself in the background. It then starts
	59	.B /u1/sms/bin/smsd,
	60	and will capture lines the server writes to standard output and log them
	61	in
	62	.B /u1/sms/sms.log
	63	along with a timestamp.
	64	.B startsms
	65	will also log the exit status of the
	66	.B smsd
	67	if it is non-zero.
	68	.SH FILES
	69	/u1/sms/sms.log
	70	.br
	71	/u1/sms/critical.log
	72	.br
	73	/u1/sms/journal
	74	.br
00f3d199	75	/etc/smsdown
00f3d199	76	.br
5834a392	77	/etc/srvtab \- The dcm must be able to get Kerberos tickets for "sms.sms".
	78	.SH "SEE ALSO"
	79	The Project Athena Technical Plan section on SMS.