|
|
Table of Contents |
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:
Make sure to read our Server Support pages for important information on configuring your operating system and Java virtual machine environments for running the VolanoChat server.
The installation and test can be performed in three steps:
Download the VolanoChat installation program to your system from the following link:
VolanoChat 2.1
Important note! You cannot use a VolanoChat 2.0 license key with VolanoChat 2.1. If you're upgrading from Version 2.0, please write to support@volano.com in order to purchase an upgraded license key.
To start the installation program, change to the directory where you saved it and enter one of the following commands:
java vchat2_1_10_2
java vchat2_1_10_2 -o directory
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.
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. The easiest way to make the directory publicly available is to
create a Web server virtual directory for it. For information on
creating a virtual directory using the Apache Web server, for example,
see Apache's documentation on the
Alias
directive.
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.1.x Copyright (C) 1996-1999 Volano LLC. All rights reserved. Loading server properties from C:\vchat2.1.x\properties.txt. blue.volano.com (192.168.0.2) VolanoChatPro - 5 connection limit.
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.
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
created a virtual Web directory called vcclient directly
under your Web server's root 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 created a different virtual Web directory for the actual
vcclient directory, you'll need to specify the correct Web
address 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.
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 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.1.x server.properties = C:\vchat2.1.x\properties.txt server.license = VolanoChatPro - 5 connection limit server.expiration = null 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
connection level based on the IP address (from server.host)
and port number (from server.port) of your VolanoChat
server. The license key can be ordered at our Web site from the
Pricing and Ordering page.
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.
To uninstall VolanoChat, open a command prompt, change to the VolanoChat installation directory, and enter one of the following commands:
java uninstall
java uninstall -console
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.
|
|
Check HTML | Table of Contents |