PreviousNextUpFAQ Table of Contents

Installing on Other Systems

Please read the System Requirements to make sure you have the necessary hardware and software in place before installing VolanoChat. This section tells you how to:

Installing VolanoChat

The installation and test can be performed in three steps:

  1. Unpack the archive.
  2. Start the server.
  3. Start the applet.

Step 1. Unpack the archive.

Download the archive

Download the VolanoChat installation program for your system from the following link: 

VolanoChat 2.0

Run the installation program

To start the installation program, change to the directory where you saved it and enter one of the following commands:

java vchat200
when connected with a graphical window environment.
java vchat200 -o directory
when connected with a character based telnet environment, where directory is the name of the directory where you want VolanoChat to be installed.

Substitute java with the name of the Java interpreter for your operating system. If you don't yet have a Java virtual machine for your platform, you can download one from the list in the System Requirements.

Publish the applet files

A directory called vcclient is created under the installation directory. It contains the client applet code files and their associated resource files. These files must be publicly available through your Web server so that the applet can be retrieved onto its Web pages.

Move this vcclient directory to your Web server public access directory.

Step 2. Start the server.

To start the VolanoChat server, open a command prompt and change to the directory in which you installed VolanoChat. Start the VolanoChat server by entering the following command: 

java COM.volano.Main

Make sure to type the Java class name exactly as shown, with capital letters for COM and a capital M in Main. After starting the server, you should see the copyright notice: 

> java COM.volano.Main
VolanoChat(TM) Server Version 2.0.0 Build 103
Copyright (C) 1996-1998 Volano LLC.  All rights reserved.
blue.volano.com (192.168.0.3) VolanoChatPro - 5 connection limit.
This evaluation copy expires on Mon Jun 01 00:00:00 PDT 1998.

If the license has expired, simply download the latest evaluation license key from one of the links below: 

HTTP:  http://www.volano.com/license.key - 381 bytes
FTP:   ftp://ftp.volano.com/license.key  - 381 bytes

Place the file license.key in the VolanoChat server installation directory, replacing the older file with the same name.

You can minimize the window or simply start the server as a background process, but you must leave it running for it to remain active. See the section below called Purchasing a license key for information on how to increase the server connection limit and remove its expiration date.

Step 3. Start the applet.

With the server running, point your browser to the index.html file in the vcclient directory. You should pull the Web page through your Web server using an http:// address instead of using your browser's File, Open Page menu item. Some browsers will fail to connect when loading the applet with a file:// address.

If your browser and Web server are on the same machine, and you moved the vcclient directory directly under your Web server's public access directory, you can load the VolanoChat applet Web page with the following link: 

http://localhost/vcclient/index.html

If the server is on a different machine, you will need to replace localhost with the actual host name where the server is running. If you moved the vcclient directory somewhere other than directly under your Web server's public access directory, you'll need to specify the correct path to the vcclient/index.html test Web page.

Connect to the VolanoChat server by clicking the applet button with the Volano logo on the test Web page.

Purchasing a license key

You can purchase a license key from Volano to increase the VolanoChat server connection limit and remove its expiration date. All we need is the host name and port number on which you plan to run the VolanoChat server. The default port number is 8000, but you can choose any other valid port number as well.

If you don't know your server host name, just send us the support.log file that is generated by the VolanoChat server each time you start it. Its contents look like the following: 

server.version     = Version 2.0.0 Build 103
server.license     = VolanoChatPro - 5 connection limit
server.expiration  = Mon Jun 01 00:00:00 PDT 1998
server.host        = blue.volano.com (192.168.0.3)
server.port        = 8000
java.vendor        = IBM Corporation
java.vendor.url    = http://www.ibm.com/
java.version       = 1.1.4
java.class.version = 45.3
java.compiler      = javax
os.name            = OS/2
os.version         = 20.40
os.arch            = x86
user.language      = en
user.region        = US
file.encoding      = ibm-437
file.encoding.pkg  = sun.io

From this file, we can generated a valid license key for any level of VolanoChat you purchase. The license key can be ordered at our Web site from the Pricing and Ordering page.

Stopping VolanoChat

To stop the server, you can usually press Ctrl-C in the command prompt window where you started it. Once you have defined an administrator password, you can shutdown the VolanoChat server by entering the command: 

java COM.volano.Shutdown

See the VolanoChat server properties section for information on defining an administrator password.

Removing VolanoChat

To uninstall VolanoChat, simply open a command prompt and change to the VolanoChat installation directory. When connected with a graphical window environment, enter one of the following commands:

java uninstall
when connected with a graphical window environment.
java uninstall -console
when connected with a character based telnet environment.

The uninstall program will remove the installation files while leaving any new or modified files, such as your modified configuration files and new log files. If you don't want these files, you may simply delete them.

PreviousNextUpFAQ Check HTML Table of Contents