DialD Monitor for Linux/Win31/Win95 - Installation
--------------------------------------------------

If you are upgrading to dialmon-0.6, please have a quick
look at the CHANGES file, _especially_ if you use multiple
configurations or shadow passwords.

A: Installation on Linux
------------------------

(1) Allocate a port on which dialmon listens for clients.
Either put en entry into /etc/services (dialmon uses the
service name "dialmon" by default), or just pick a port
(I use 7002 for no particularly good reason).

(2) If you intend to use dialm, the Linux/X client, then
edit the Makefile in the linux sub-directory and set
DEFAULT_HOST and DEFAULT_PORT appropriately to your system.
This client does not support multiple configuration control.

(3) Edit the sample dialmon.conf and dialmon.users files
in the linux sub-directory. There are hopefully enough
comments to explain what is going on without recourse to
the manual page.

(4) Check the header file dialmon.h in case you need to
alter the default settings, like the name of the diald
control fifo. These is also a define here for shadow
passwords.

(5) Compile the Linux dialmon daemon: in the linux sub-
directory:

	make

If you have trouble with stuff like FD_SET or -lcrypt,
please see the FAQ.

(6) Install the various components (you will need to be
root for this). There are three parts:

	make install_dialmon
		installs the dialmon daemon (in /usr/sbin)
		and the configuration file (in /etc)

	make install_client
		installs the dialm linux client (in /usr/bin)

	make install_man
		installs the manual page (in /usr/man/man8)


(7) Start dialmon. On my machine, I start it from the same
script in /etc/rc.d/... which starts diald itself. The script I
use is included as diald.init; this gets all configuration from
/etc/dialmon.conf. Dialmon should detect shadow password usage
automatically; if there are problems check the system log file,
and see the -P and -S options in the manual page.

(8) Test it. The easiest way is to use "telnet localhost 7002"
(or similar). Dialmon should respond to the command 'U' to bring
the link up, 'D' to take it down (if allowed) and 'Q' to
disconnect from telnet. User login can be tested as well, eg.,
"Lmike:mypassed". You need to hit return after each command
character. Errors should be logged in /var/log/messages.

B: Installation on Windows
--------------------------

If you have obtained the .tgz distribution, there are three windows-related
directories:

(1) windows: This contains the sources, icons, etc. There is also a
             Help file (plus the source for use with the HelpCard
             help authoring program).
(2) win31  : This contains links into windows, plus MSVC1.5 make file.
             An executable is stored in dialm16.exe 
(3) win95  : This contains links into windows, plus MSVC4.0 make and
             project files. An executable is stored in release/dialm32.exe.

In the case of the .zip distribution, there is no windows directory, and
the win31 and win95 directories contain duplicate copies of the sources,
help file, etc.

The appropriate executable, plus the help file, should be copied to
somewhere appropriate; note that the name (dialm16 or dialm32) is not
significant; you can copy it as dialmon.exe (or anything else ...)

The first time it starts, it will pop up a dialog box for the host and
port/service, etc. This information is saved in c:\windows\dialmon.ini;
the Win95 registry is _not_ used! See the help for most details.

Briefly, the system menu has most options, so you can drive it without
opening the window. STATE items from diald are converted to messages (I
think I have these right:-) and are displayed in the State field and in
the window title bar. MESSAGE items are displayed in the Message field.

If it looses the connection to the Linux dialmon daemon, then <Config><OK>
acts as reconnect, however it tries to reconnect every 15 seconds.

