How to activate syslogd?
		========= Jean_Marc == 25/03/97 ===


1> What is syslogd used for on the device?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The daemon "syslogd" which is found on the device enables reception
of system messages and sending of them to a machine supporting
the true syslogd server. This intermediary avoids the system being
blocked during transmission of the message, and therefore helps
performance. The daemon is also responsible for opening
communication with the server and, if required, reopening this
channel if the target machine closes it following a reinitialisation,
for example.

2> How to activate syslogd?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You simply need to add the following line to the "inittab" file:
	syslogd -f&
and the following to the "hosts" file:
	nnn.nnn.nnn.nnn loghost
where "nnn.nnn.nnn.nnn" is the IP address of the target machine
There is an alternative to this syntax. To simplify things, you can
add the following line to the "inittab" file:
	syslogd -f mmmmmm&
where "mmmmmm" is either the name of the target machine, on condition
that this machine has previously been described in the "hosts" file,
or an IP address in "dot notation" format.
Caution, in all cases, do not forget to end the line with the
character '&' so that the daemon moves to the background and
does not prevent the execution sequences programmed in "inittab".

You are strongly advised not to give a machine on a remote
network as the target machine. This is because if you want to record
the log, for example, closing a channel will trigger
opening of a link to a remote site, which
is bound to have a catastrophic effect on communication costs.

From this moment onwards, the various routines which transmit
messages to syslogd will see their messages sent to the server.
The date in the message will either be the date known by
the device (see variable SERVER), or the date of the target
machine. The name specifying the machine originating the message will be placed
by the target machine (watch out for problems that may result from
use of a DNS on the target machine, such as unexpected connections
to another DNS server because the originating machine is not found on the
LAN, etc...).

To check that all parameters are correctly set, after
reinitialising the device and verifying the target machine,
the command line "syslogd -t test" should send a syslog message
to the target machine in syslog/debug (see below). If the
message is not received, there is a problem with the device or
with the target machine. See the manual for further details.
The first time you use the device, it is recommended that you use
a console directly connected to the device console port
in order to obtain information on any problems that syslogd
may have detected on startup.

3> What programs/commands use syslogd?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
(see the manual for explanations of the options used)

++ option "-l" is detailed in the manual for the various commands.


4> Syslogd on real systems :-)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

On real systems (Unix for example :-), there is a syslogd daemon
as part of the standard delivery. The aim of this daemon, depending on the function
of the machine users, is to route system messages to the
administrator's machine, or, on the administrator's machine,
to record these messages, or trigger certain actions depending
on the importance of the message (send an e-mail,
call a pager, etc...).
The configuration of the "syslogd" is found in the file "syslog.conf"
(generally in directory "/etc"), and the command "man" on the
Unix machine will give all specifications required for filling in
this file (man syslogd and man syslog.conf). Caution, after modifying
this file, you need to ask the daemon to restart or to
re-read the configuration (see the machine manual).
Startup of this daemon is usually carried out in file "/etc/rc",
in a file "/etc/rc.sthing" or in one of the files in
directory "/etc/rc.d".

COMMAND

FILES

   Please let us know if you find any errors in this description,
your assistance will be of service to others who require this information.