IPSMon Readme

IPSMon early alpha (22/12/1998)
(c) 1998 Harald Eilertsen


Introduction:
-------------------------------------------

IPSMon is a monitor utility for the IPS (Inet Power Server) FTP
module. It's not yet feature complete, but is included here as 
a preview of what is to come.

IPSMon will show you a list of all the users logged onto your IPS
based FTP server, and some info about what each is doing. For the 
future more features like the ability to kill individual users or
do server maintainance will be added.

IPSMon is written in 100% pure Java, and should run on any Java 1.1
enabled platform with Swing installed. It should also work on the
newly released Java 2 platform, but has not yet been tested on it.


Installation:
-------------------------------------------

Unzip the archive in a directory of your choice, including subdirectories.
Install the Swing toolkit from SunSoft. You'll find it at:
http://www.javasoft.com/products/jfc/index.html#download-swing

You need at least Java version 1.1 installed to run this program.

Before running the program you need to edit the IPSMon.ini file.
This is a plain text file, and can be edited with your favourite
text editor. Se the file for format and instructions.


Running IPSMon:
-------------------------------------------

To run IPSMon, go to the directory where you installed IPSMon and
type:

jre -cp ".;%SWING_HOME%\swing.jar" IPSMon

This assumes an OS/2 or Windows runtime environment with the 
SWING_HOME variable set to the directory where Swing is installed. 
For other platforms the the docs that come with the Java Runtime 
Environment.

You can also specify an alternative ini file, like this:

jre -cp ".;%SWING_HOME%\swing.jar" IPSMon Mysetup.ini

This enables you to monitor several different sites at the same 
time.


Features:
-------------------------------------------

For now IPSMon will show a list of connected users, and some 
status for each user. The status that is shown is:

  Sock:     the control socket the user is connected to.

  User:     the user name the user is logged in with.

  Status:   The current status of the user. If the user is uploading 
            or downloading av file, extra information will be shown 
            in this field. This is: Percentage of file uploaded or
            downloaded, the byterate of the transfer, and the estimated 
            time before arrival.

  Idle:     The time the user has bin idling

  RemoteIP: The remote IP address of the user

  Dur:      The total time the user has been connected

  FileName: The name of the last file the user uploaded or downloaded.


As an extra bonus of using Swing tables for the display, columns can be
reordered to provide the view you actually like the best. The column order 
or other window status is not stored between sessions at this time. This
will be done for a future release.


In future releases IPSMon will be able to kill selected users that are
connected, and do other maintainance tasks, like restarting the server
aso. directly from the IPSMon window.


Known issues:
-------------------------------------------

- The time displays will wrap at 24 hours. That is, someone
  connected for two days and five minutes will be shown as if
  they'd been connected only five minutes.

- IPSMon may at random times suddenly stop updating and terminate
  with a NullPointerException in the kasper.net.NumericResponse
  class. This seems to be a problem with the underlying class 
  library of detecting end of response messages. It is being worked
  on.


Contact:
-------------------------------------------

IPSMon is written by Harald Eilertsen.
(c) 1998 Harald Eilertsen

The Kasper FTP classes are written by Casper
http://www.cs.albany.edu/~casper/

For bugs, suggestions or comments, contact
Harald Eilertsen at haraldei@ifbt.ntnu.no

The latest version of IPSMon should always 
be found on ftp://ftp.iq.to/pub/ips/utilities/

