Previous Next Up FAQ Table of Contents

4.5 Installing on Windows

Please read the VolanoChat server software requirements in the [3.1] Requirements section before installing VolanoChat on your system. The installation instructions below assume you are using one of the recommended Java platforms for Windows listed in Table 1.

This section consists of the following five parts:

Installing VolanoChat

Download the Windows version of the installation program from the VolanoChat Download page and run the installation program by double-clicking the Windows executable file. We recommend that you install each VolanoChat version into its own directory under the home directory of a new user account on your system, such as volano. For example, if you're installing VolanoChat version 2.6.1, you would create a new user account called volano, login to that account, and install VolanoChat into the following location:

C:\Documents and Settings\volano\vchat2.6.1

If you're unable to create a new account, you can simply install into a location under your own home directory. The examples that follow use the installation directory C:\Documents and Settings\volano\vchat2.6.1, but your location may be different if you installed into a different directory or under a different account name.

If you receive a message like the following during installation:

No suitable Java virtual machines were found.  Please choose one
of the following options:

choose the option which states:

Run the installation with the VM from this location:

and browse to the location of the Java 2 SDK exectuable file on your system. For example, the default location of the Sun Java 2 SDK version 1.4.2_03 virtual machine is:

C:\j2sdk1.4.2_03\bin\java.exe

Press OK to continue with the installation using the Java virtual machine you've chosen.

Download a trial license key from the VolanoChatPro Trial Licenses page and save the generated file as a plain text file. The easiest way to save the trial key is to select Save As... or Save Page As... from the Web browser File menu. Put the key.txt file in the conf subdirectory of your VolanoChat installation. For example, if you installed VolanoChat in the location C:\Documents and Settings\volano\vchat2.6.1, you would put the trial license key in:

C:\Documents and Settings\volano\vchat2.6.1\conf\key.txt

Write to Volano Support <service@volano.com> if you are moving or upgrading servers and need to exchange your purchased non-trial license for a new one with a different address.

Starting the server

You can start the VolanoChat server from the Command Prompt or automatically as a Windows Service when your system starts.

From the Command Prompt

VolanoChat includes two sample startup scripts for use on Windows. To run them, open the Command Prompt and change directories (using the cd command) to make the VolanoChat installation directory your current working directory.

startup.bat
sample startup batch file for Windows 2000, Windows XP, or Windows Server 2003.
startup.sh
sample startup shell script for Windows systems with Cygwin installed.

For example, to run the Windows batch file enter the command:

startup

You should then see messages like the following:

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
  "C:\Documents and Settings\volano\vchat2.6.1\conf\properties.txt".
guest:8000 (192.168.0.3:8000) VolanoChatPro - 5 connection limit.
This evaluation copy expires on Wed Mar 03 00:00:00 PST 2004.
Apache Tomcat/4.1.29

If you get an error message like the following:

Java virtual machine not found: "C:\jdk1.3.1_09\bin\java.exe"

just modify the line in the startup batch file which specifies the Java installation directory and version number on your system:

rem **************************************************************************
rem Modify the JAVA variable if you're not using Java version 1.3.1_09.
rem **************************************************************************
set JAVA="C:\jdk1.3.1_09\bin\java.exe"

For example, if you installed the Sun Java 2 SDK, Standard Edition, version 1.4.2_03 instead of version 1.3.1_09, you would modify the line to specify:

set JAVA="C:\j2sdk1.4.2_03\bin\java.exe"

You may minimize the Command Prompt window, but you must leave it running for the VolanoChat server to remain active. To stop the VolanoChat server, enter the Ctrl-C keyboard shortcut and answer "y" when asked, "Terminate batch job (Y/N)?".

As a Windows Service

Note: You must be logged in with Administrator privileges to install a Windows Service.

You can also install VolanoChat as a Windows Service which will start automatically when you start your computer. To install VolanoChat as a service, open the Command Prompt and change to the VolanoChat installation directory. Enter the command:

service install

You should then see messages like the following:

Java VM = "C:\j2sdk1.4.2_03\jre\bin\server\jvm.dll"
Options = -Xmx256m -Xss128k -Dinstall.root=. -Dcatalina.home=.
  -Djava.class.path=.;lib\bootstrap.jar;lib\catalina.jar;lib\commons-beanutils.jar;
  lib\commons-collections.jar;lib\commons-digester.jar;lib\commons-logging-api.jar;
  lib\jakarta-regexp-1.3.jar;lib\mx4j-jmx.jar;lib\naming-common.jar;
  lib\naming-resources.jar;lib\servlet.jar;lib\servlets-common.jar;
  lib\servlets-default.jar;lib\tomcat-coyote.jar;lib\tomcat-http11.jar;
  lib\tomcat-util.jar;lib\volanochat-server.jar;lib\xercesImpl.jar;lib\xmlParserAPIs.jar
Installing the VolanoChat service ...
The service was successfully installed.

You can then start and stop the VolanoChat service using Services under Start, Settings, Control Panel, Administrative Tools. You can also start and stop the VolanoChat service directly from the Command Prompt by using the net command:

net start VolanoChat
net stop VolanoChat

Check the content of the output.log and error.log files to make sure the VolanoChat service started successfully with no errors. The error log file should be empty, while the output log file should contain messages like the following:

VolanoChat(TM) Server Version 2.6.1
Copyright (c) 1996-2004 Volano Software.  All rights reserved.
Loading server properties from
  "C:\Documents and Settings\volano\vchat2.6.1\conf\properties.txt".
guest:8000 (192.168.0.3:8000) VolanoChatPro - 5 connection limit.
This evaluation copy expires on Wed Mar 03 00:00:00 PST 2004.
Apache Tomcat/4.1.29

If you get an error message like the following:

Java virtual machine not found: "C:\jdk1.3.1_09\jre\bin\server\jvm.dll"

just modify the line in the service batch file which specifies the Java installation directory and version number on your system:

rem **************************************************************************
rem Modify the JVM_DLL variable if you're not using Java version 1.3.1_09.
rem **************************************************************************
set JVM_DLL="C:\jdk1.3.1_09\jre\bin\server\jvm.dll"

For example, if you installed the Sun Java 2 SDK, Standard Edition, version 1.4.2_03 instead of version 1.3.1_09, you would modify the line to specify:

set JVM_DLL="C:\j2sdk1.4.2_03\jre\bin\server\jvm.dll"

To stop the VolanoChat service, use the Service Control Panel or enter the following command from the Command Prompt:

net stop VolanoChat

You can remove the VolanoChat service with the command:

service remove

Starting the applets

If you're using a Web browser on the same machine that is running the VolanoChat server, you can load the applet from the following link:

http://localhost:8080/vcclient/index.html

If the server is on some other machine, change localhost in the address shown above to the actual host name of the machine running the VolanoChat server. After your browser loads the page, push the button to connect to your VolanoChat server using the VolanoChat applet.

Although the applets and their resources can be delivered through the built-in Apache Tomcat servlet container as shown above, you should use a Web server like the Apache HTTP Server or Microsoft IIS for delivering the VolanoChat applets and files on a production system. These files must be publicly available through your Web server so that the applet can be loaded onto Web pages. Do not move or copy the vcclient subdirectory, but rather set up an alias (with Apache) or a virtual directory (with IIS) for the applet class files and resources.

For example, to publish your vcclient directory using Apache on Windows, you would add an Alias directive like the following to your Apache configuration file:

Alias /vcclient/ "C:/Documents and Settings/volano/vchat2.6.1/webapps/ROOT/vcclient/"

With Microsoft IIS, you can use the Internet Services Manager or the Personal Web Manager to create a new virtual directory, called vcclient, which points to the real webapps/ROOT/vcclient directory. With the Internet Services Manager, right-click the Default Web Site under your machine name on the left and select New, Virtual Directory in the pop-up menu. Then follow the instructions in the Virtual Directory Creation Wizard.

With that change, you can drop the 8080 port number from the address and pull the applet through your normal Web server:

http://localhost/vcclient/index.html

Purchasing a license

You can purchase a license key from Volano through our online store to increase the trial license connection limit and remove its expiration date. You will need the support.log file that is generated by the VolanoChat server each time you start it, found under the logs subdirectory. We'll use the server.host IP address and server.port port number to generate the new license. The contents of the support log file look like the following:

server.version     = Version 2.6.1
server.properties  = C:\Documents and Settings\volano\vchat2.6.1\conf\properties.txt
server.license     = VolanoChatPro - 5 connection limit
server.expiration  = Wed Mar 03 00:00:00 PST 2004
server.host        = guest (192.168.0.3)
server.port        = 8000
java.vendor        = Sun Microsystems Inc.
java.vendor.url    = http://java.sun.com/
java.version       = 1.4.2_03
java.class.version = 48.0
java.compiler      =
os.name            = Windows 2003
os.version         = 5.2
os.arch            = x86
user.language      = en
user.region        =
file.encoding      = Cp1252
file.encoding.pkg  = sun.io

Removing VolanoChat

To remove VolanoChat open the Command Prompt, change to the VolanoChat installation directory, and enter the following commands. First, remove any VolanoChat service that may have been installed by entering:

service remove

Then remove VolanoChat with:

java uninstall

The uninstall program will remove all files except for those you have modified or created after installation, such as the modified configuration files or new log files. Simply delete these files if you don't want to keep them.


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 <john@status6.com>
More…

A PROJECT OF STATUS:6®