![]() ![]() ![]() ![]() |
Table of Contents |
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:
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.
You can start the VolanoChat server from the Command Prompt or automatically as a Windows Service when your system starts.
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
startup.sh
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)?".
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
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
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
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.
![]() ![]() ![]() ![]() |
XHTML 1.0 | Table of Contents |