These are general instructions for installing the Java 1.1 Chat Client/Server jar file and using it. This file also is in the jar file. First, unjar the exe file (yes, the files have an 'exe' extension but are actually 'jar' files so a browser will ask you if you want to download the file instead of trying to execute it). This can be done using 'jar', which comes with Sun's Java 1.1.x or 2.x JDK, which can downloaded from the Javasoft web site. Using 'jar', the command line command to use would be 'jar -xvf chatserv.exe', where 'filename' is the name of the file to unjar.
Included are this readme file, sample html files that can be used to run the client or the server admin program as applets, sample scripts that can be used to run the client or the server admin program as applications on Windows and the server as a Windows application, and a 'ready-to-use' jar file which contains all of the class files required to run the server and the client and admin programs as applications or applets.
The html files included are chatclient.html and chatadminclient.html, which are sample html files that can be used to start the Chat Client and the Chat Admin Client from a web browser. They contain the location of the jar file, a host name on which the Chat Server runs, and the port number on that host to use. If the hostname is left at '127.0.0.1', then the applet will first check the host from which it was downloaded from before checking the local machine. The initial password for the admin client is 'admin'.
For browser access from a web server, the jar file should remain in the same directory as the html files. If the jar file is placed in a different directory, then the html files should be modified accordingly to reflect the location of the jar file.
To run the client programs locally as applications, just run the appropriate script; chatclient.bat for the standalone chat client, share.bat for the file sharing client, and chatadminclient.bat for the admin client. The jar file can also be put directly into the CLASSPATH environment variable, e.g. c:\directory\chat.jar. Sun's Java runtime virtual machine (VM), version 1.1.8, is the best choice to run the applications, however, a later version should also work fine. Either one can be downloaded from the Sun web site or the Javasoft web site.
The Chat Server, of course, is always run as an application. Using Sun's runtime VM, it is invoked by entering 'chatserver arg1 arg2' on the command line in the directory containing chat.jar. It takes two command line arguments, the port number and the maximum number of clients, in that order. The default port number is 9876, which means that chat clients connect on that port, the admin client connects on port 9875, and port 9877 is used internally. The html files use these values as defaults and should be changed if Chat Server is executed with a different port number. The default number of clients is unlimited.
The application version of the Chat Client also supports peer file sharing either with names via a the Chat Server or with a true peer connection by directly connecting to an IP address. See the readme file for the File Share Client for more information about the file sharing features of the Chat Client and the standalone File Share Client.
I know these instructions seem vague if you are not an experienced Java user, but the process is really much easier than it seems. I am sure that I can easily answer any questions you may have via the e-mail address listed below.
If you have any questions, please direct them to
software@lpsci.com