Previous Next Up FAQ Table of Contents

1.0 Preface

This document describes how to install, configure, run, and monitor your VolanoChat server. It is intended to be used by the VolanoChat server administrator.


Use the following link if you would like to download a copy of the guide for use on your local computer:


This guide is updated frequently. Please check the online version for the latest updates and corrections.

Organization of this guide

The chapters of this guide are divided into several main sections as follows.

Getting started

gives a general overview of how the client applets and server application work together to provide chat rooms on Web sites.
Release Notes
helps you plan for your chat service by providing the system requirements, the new features in the latest release of VolanoChat, and the known issues and problems.
provides step-by-step instructions for installing and starting the VolanoChat server on your computer.

Server side

describes the parts of the VolanoChat server and describes all of its properties, configuration files, and log files.
describes the Java servlets that are provided with VolanoChat and shows you how to add other Java servlets to the VolanoChat server.

Client side

VolanoChat Applet
describes the parameters and properties of the VolanoChat applet and how to modify its interface for monitors, administrators, and members.
WebVolanoChat Applet
describes the parameters of the WebVolanoChat applet used for accessing public rooms embedded on the Web page.
MyVolanoChat Applet
describes the parameters of the MyVolanoChat applet used for accessing hidden personal chat rooms or normal public chat rooms.
BannerPlayer Applet
describes the BannerPlayer applet that is provided with VolanoChat for displaying banner images from your server or from remote advertisement servers.
Adding Other Applets
shows you how to add other Java applets to the chat rooms.


Translating VolanoChat
explains how to translate the VolanoChat user interface into languages which use non-Western character coding.
Flood Control
explains how to administer the flood control features of VolanoChat.
Advertising Control
shows examples of using the BannerPlayer applet with remote ad servers such as DoubleClick.
DNS Blacklisting
describes how to set up DNS-based blacklist support.
explains how to define the font and color themes.
Moderated Events
explains how to set up your VolanoChatPro server for moderated events.


Command Reference
gives a synopsis of the Java console applications provided with VolanoChat and other Volano products, such as VolanoMark.


Error Messages
lists the most common error messages reported by the server or client.
Server Tools
shows some helpful system administration commands.
provides information for setting up VolanoChat to work through NAT, firewall, or proxy servers
explains how the VolanoChat product is licensed.
Frequently Asked Questions
lists common questions about VolanoChat, along with answers.
Multiple Windows Service Install
explains how to install multiple VolanoChat servers as Windows NT, 2000, or XP Services.

VolanoChat users

Hosted VolanoChatPro Chat Rooms
provides information for those using a MyVolanoChat Personal Chat Room through a Web hosting provider.
VolanoChat End User FAQ
answers the most common questions asked by those using VolanoChat applets.
Browser Info
lists detailed version information about your Web browser and Java support.

Conventions used in this guide

Each page in this guide has a header and footer containing navigational icons which link to other pages. In addition, each page contains a link to the Table of Contents.

Previous takes you to the previous page in the guide.
Next takes you to the next page in the guide.
Up takes you up one level in the guide's hierarchy.
FAQ takes you to a page containing the frequently asked questions and their answers.

A monospace type is used for code samples, computer commands, file names and Java property names. For example:


When showing the format of computer commands with parameters, the parameters are shown in italic monospace type. For example:

java vchat2_6_1 -o directory

When showing HTML code, the parts that you may modify are shown in bold monospace type. For example:

<applet codebase=""
        width="500" height="100">
<param name="cabbase" value="COM/volano/" />
<param name="color"   value="#FFFFFF" />
<param name="group"   value="Welcome to Volano!" />
<param name="text"    value="english.txt" />

When showing sample computer commands along with their output, the part that you type is shown in bold monospace type. For example:

$ ./
java version "1.4.2_03"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)
Java HotSpot(TM) Server VM (build 1.4.2_03-b02, mixed mode)
VolanoChat(TM) Server Version 2.6.1
Copyright (c) 1996-2004 Volano Software.  All rights reserved.
Loading server properties from "/home/volano/vchat2.6.1/conf/properties.txt". ( VolanoChatPro - 5 connection limit.
This evaluation copy expires on Tue Mar 02 00:00:00 PST 2004.
Apache Tomcat/4.1.29


We welcome your feedback about this guide, especially if you spot errors or omissions. You can write us at Volano Support <>.


Volano, VolanoChat, VolanoChatPro, and VolanoMark are trademarks of Volano Software. Java is a trademark of Sun Microsystems, Inc., and refers to Sun's Java programming language.

HTML version

The VolanoChat Administrator Guide is written using valid XHTML 1.0 Transitional and Cascading Style Sheets Level 2.

Valid XHTML 1.0! Valid CSS!

Previous Next Up FAQ XHTML 1.0 Table of Contents

2014-07-11 — An updated version of the VOLANO chat server that supports the latest Java 8 Plug-in is now available. More…

The VOLANO® chat software for the Java™ platform lets you build on-line communities and add real-time social networking to your Web site. More…

John Neffenger <>