Installation notes for Telejet Web Resetter demo Software w/
Telejet Keyboard Simulator
Version 1.0, 11/2002

I. INTRODUCTION

This is the readme file for the Telejet Web Resetter software that
is available free of charge for use with the Telejet Keyboard
Simulator products. The software can be used without any
modifications of program code, but you are strongly encouraged
to write your own software. Of course, you may use this package
as a starting point, as a reference or as an example for
developing your program. You may also alter this software to
suit your specific needs.

After all, this is meant as a sample application to help you get
started.
Despite being a sample, the source code in it's current state is
hard to read. A major clean-up is being worked on.

II. REQUIREMENTS

This Software requires a http server capable of executing perl scripts.
As it has been tested with Apache, some version of Apache and the
perl module is recommended, although other web server software may
also work. You mileage may vary greatly when using server programs
other than Apache.
Apache is available at http://www.apache.org/ .

This software assumes that the Telejet Web Resetter Hub is connected
to the first serial port on a linux box, i.e. /dev/ttyS0. To make it
work with different flavours of operating systems please edit the file
resetter-worker.pl and change it accordingly.

III. INSTALLATION

The installation archive should contain at least these files:
	- resetter.pl
	- resetter-worker.pl
	- resetter.conf
	- resetter.jobs
	- resetter-libs.pl
An empty directory named "data" should also exist after extracting
alle the files. If not, create it.

Extract these files into a directory within the web server's
DocumentRoot and make sure the web server will execute .pl files.
"resetter.jobs" and "data/" have to be writable by the user the
web server runs as. Also, the "/tmp" directory has to be writeable.

Edit "resetter.conf" to suit your needs. As this software offers
support for .htpasswd authentication, you should not change
$auth_method without adding appropriate auth methods yourself.
After editing "resetter.conf", move it out of the web server's
document tree for security reasons. Enter the new path and filename
in line 9 of "resetter-libs.pl".
You may also want to move "resetter.jobs". In that case, do not
forget to alter the path information stored in "resetter.conf".

"resetter-worker.pl" is a background task that can be started on
system startup. That step is completely optional. It will be
started automatically as soon as it is needed.

User authentication now uses the webserver's authentication
mechanism. That means that the admin user has to create the
Web Resetter users manually or via a script. Consult the 
htpasswd man page for details.
In turn, this allows the administrator to easily adapt the
software to the already installed configuration website including
authentication schemes based on LDAP, SQL or other methods
as long as they are supported by the web server.

IV. HELP

You may contact aweber@ico.de for assistance. There is also an
on-site and remote installation service available. Even tailored
builds and new developments of the Telejet Web Resetter software
are available on request. Please contact your sales contact for
details.

