Version 2.12

Changes to Your HTML

You must make the following changes to all of your HTML pages containing a VOLANO chat applet, such as the VolanoChat, MyVolanoChat, or WebVolanoChat applet.

Changes in Version 2.12

Version 2.12 includes the following changes:

Downloadable Packages

Download version 2.12 of the VOLANO chat software from the list below. The contents of the .zip and .tar.gz archives are identical except for the newline characters of the text files. The .zip archives contain text files with end-of-line markers for Windows systems (CR+LF), while the .tar.gz archives contain text files with end-of-line markers for Unix-like systems (LF).

Full version

volano-2.12.0.zip
the full version 2.12 package for Microsoft Windows operating systems.
volano-2.12.0.tar.gz
the full version 2.12 package for Unix-like operating systems such as FreeBSD, Linux, Mac OS X, or Solaris.

Upgrade

volano-upgrade-2.12.0.zip
the upgrade to version 2.12 from version 2.11 for Microsoft Windows operating systems.
volano-upgrade-2.12.0.tar.gz
the upgrade to version 2.12 from version 2.11 for Unix-like operating systems such as FreeBSD, Linux, Mac OS X, or Solaris.

MD5 message digests

md5sum-2.12.0.txt
the MD5 message digests for verifying the downloaded files using md5sum.

Installing the Full Version

Installing and running the full version of the VOLANO chat software involves four steps:

  1. Download and unpack the archive file.
  2. Get a trial license key for your server.
  3. Start the VOLANO chat server.
  4. Connect with the applet.

Follow the steps below depending on whether you are installing the VOLANO chat server on a Unix-like system or a Windows system.

Unix-like systems

To install the VOLANO chat software on a Unix-like system such as FreeBSD, Linux, Mac OS X, or Solaris:

  1. Download the volano-2.12.0.tar.gz file and unpack it with the command:

    tar -xf volano-2.12.0.tar.gz
    
  2. Generate a trial license for the IP address of your server and replace the volano-2.12.0/conf/key.txt file with your generated license key.

  3. Change to the VOLANO chat server directory and start the server with the commands:

    cd volano-2.12.0
    ./startup.sh
    
  4. Go to the address http://localhost:8080/vcclient/ to connect with the applet on the same machine running the server. If you are connecting from another machine, replace localhost with the host name of the machine running the server.

Windows systems

To install the VOLANO chat software on a Windows system:

  1. Download the volano-2.12.0.zip file. Right-click the file and select Extract All... from the context menu. Follow the instructions and select the folder where you want the volano-2.12.0 directory to be placed, such as the home folder shown below for the user john:

    Extraction Wizard

  2. Generate a trial license for the IP address of your server and replace the volano-2.12.0\conf\key.txt file with your generated license key.

  3. Open the Command Prompt. Change to the VOLANO chat server directory and start the server with the commands:

    cd volano-2.12.0
    startup32
    

    The startup32 command starts the VOLANO chat server using the 32-bit Java 7 HotSpot Client VM. The startup64 command starts the VOLANO chat server using the 64-bit Java 7 HotSpot Server VM.

    See the documentation for details about starting the VOLANO chat server as a Windows Service to avoid the Command Prompt altogether.

  4. Go to the address http://localhost:8080/vcclient/ to connect with the applet on the same machine running the server. If you are connecting from another machine, replace localhost with the host name of the machine running the server.

Applying the Upgrade

Applying the upgrade to an existing VOLANO chat server version 2.11 installation involves five steps:

  1. Stop the VOLANO chat server.
  2. Save a backup copy of the version 2.11 code.
  3. Download and unpack the archive file.
  4. Start the VOLANO chat server.
  5. Connect with the applet.

Follow the steps below depending on whether you are applying the upgrade on a Unix-like system or a Windows system.

Unix-like systems

To apply the upgrade to VOLANO chat server version 2.11 on a Unix-like system such as FreeBSD, Linux, Mac OS X, or Solaris:

  1. Stop the VOLANO chat server.

  2. Save a backup copy of the version 2.11 code for recovery purposes by renaming the following two JAR files and directory:

    Server JAR file:
        volano-2.11.0/lib/volano-chat-server.jar
            ==> volano-chat-server.jar.old
    Servlet JAR file:
        volano-2.11.0/webapps/ROOT/WEB-INF/lib/volano-chat-servlets.jar
            ==> volano-chat-servlets.jar.old
    Applet directory:
        volano-2.11.0/webapps/ROOT/vcclient/COM/volano
            ==> volano.old
    
  3. Download the volano-upgrade-2.12.0.tar.gz file and unpack it into the existing VOLANO chat server version 2.11 installation directory.

    cd volano-2.11.0
    tar -xmf volano-upgrade-2.12.0.tar.gz
    

    The -m option updates the modification times of the extracted files to the current time so Web site visitors will be sure to pick up the new applet files instead of using copies of the old ones in their cache.

    The upgrade archive installs the following files into the current directory where you unpack it:

    lib/volano-chat-server.jar
    webapps/ROOT/WEB-INF/lib/volano-chat-servlets.jar
    webapps/ROOT/vcclient/COM/volano/Agent.jar
    webapps/ROOT/vcclient/COM/volano/Agent.jar.gz
    webapps/ROOT/vcclient/COM/volano/Agent.jar.pack.gz
    webapps/ROOT/vcclient/COM/volano/MyVolanoChat.jar
    webapps/ROOT/vcclient/COM/volano/MyVolanoChat.jar.gz
    webapps/ROOT/vcclient/COM/volano/MyVolanoChat.jar.pack.gz
    webapps/ROOT/vcclient/COM/volano/VolanoChat.jar
    webapps/ROOT/vcclient/COM/volano/VolanoChat.jar.gz
    webapps/ROOT/vcclient/COM/volano/VolanoChat.jar.pack.gz
    webapps/ROOT/vcclient/COM/volano/WebVolanoChat.jar
    webapps/ROOT/vcclient/COM/volano/WebVolanoChat.jar.gz
    webapps/ROOT/vcclient/COM/volano/WebVolanoChat.jar.pack.gz
    

    Note: If you moved the public vcclient directory to your Web server root directory, you'll need to copy the new applet files there.

  4. Change to the VOLANO chat server directory and start the server with the commands:

    cd volano-2.12.0
    ./startup.sh
    

    You should see messages like the following:

    java version "1.7.0_25"
    OpenJDK Runtime Environment (IcedTea 2.3.12) (7u25-2.3.12-4ubuntu3)
    OpenJDK 64-Bit Server VM (build 23.7-b01, mixed mode)
    VOLANO® Chat Server Version 2.12.0
    Copyright © 1996-2014 Status Six Communications
    Loading server properties from "/home/volano/volano-2.12.0/conf/properties.txt".
    www.example.com:8000 (192.168.1.1:8000) VolanoChatPro - unlimited connections.
    Apache Tomcat/4.1.40
    

    Note the updated version number (2.12.0) and copyright date (2014).

  5. Go to the address http://localhost:8080/vcclient/ to connect with the applet on the same machine running the server. If you are connecting from another machine, replace localhost with the host name of the machine running the server.

    Note: You'll have to make the changes described at the top of this page to all of the HTML pages containing VOLANO applets before any of them will run on the latest Java 7 Plug-in.

Windows systems

To apply the upgrade to VOLANO chat server version 2.11 on a Windows system:

  1. Stop the VOLANO chat server.

  2. Save a backup copy of the version 2.11 code for recovery purposes by renaming the following two JAR files and directory:

    Server JAR file:
        volano-2.11.0\lib\volano-chat-server.jar
            ==> volano-chat-server.jar.old
    Servlet JAR file:
        volano-2.11.0\webapps\ROOT\WEB-INF\lib\volano-chat-servlets.jar
            ==> volano-chat-servlets.jar.old
    Applet directory:
        volano-2.11.0\webapps\ROOT\vcclient\COM\volano
            ==> volano.old
    
  3. Download the volano-upgrade-2.12.0.zip file. Right-click the file and select Extract All... from the context menu. Follow the instructions and select the VOLANO chat server version 2.11 folder where you want the upgrade applied, as shown in the example below.

    Extraction Wizard

    If you use a command-line unzip program to extract the files instead of the Windows Extraction Wizard, add the -DD command option. The -DD option of many unzip programs suppresses the timestamp restoration for all extracted files and directories, setting the timestamps to the current time. With current timestamps, your Web site visitors will be sure to pick up the new applet files instead of using copies of the old ones in their cache.

    The upgrade archive installs the following files into the folder where you unpack it:

    lib\volano-chat-server.jar
    webapps\ROOT\WEB-INF\lib\volano-chat-servlets.jar
    webapps\ROOT\vcclient\COM\volano\Agent.jar
    webapps\ROOT\vcclient\COM\volano\Agent.jar.gz
    webapps\ROOT\vcclient\COM\volano\Agent.jar.pack.gz
    webapps\ROOT\vcclient\COM\volano\MyVolanoChat.jar
    webapps\ROOT\vcclient\COM\volano\MyVolanoChat.jar.gz
    webapps\ROOT\vcclient\COM\volano\MyVolanoChat.jar.pack.gz
    webapps\ROOT\vcclient\COM\volano\VolanoChat.jar
    webapps\ROOT\vcclient\COM\volano\VolanoChat.jar.gz
    webapps\ROOT\vcclient\COM\volano\VolanoChat.jar.pack.gz
    webapps\ROOT\vcclient\COM\volano\WebVolanoChat.jar
    webapps\ROOT\vcclient\COM\volano\WebVolanoChat.jar.gz
    webapps\ROOT\vcclient\COM\volano\WebVolanoChat.jar.pack.gz
    

    Note: If you moved the public vcclient directory to your Web server root directory, you'll need to copy the new applet files there.

  4. Open the Command Prompt. Change to the VOLANO chat server directory and start the server with the commands:

    cd volano-2.12.0
    startup32
    

    You should see messages like the following:

    java version "1.7.0_45"
    Java(TM) SE Runtime Environment (build 1.7.0_45-b18)
    Java HotSpot(TM) Client VM (build 24.45-b08, mixed mode, sharing)
    VOLANO® Chat Server Version 2.12.0
    Copyright © 1996-2014 Status Six Communications
    Loading server properties from "C:\Users\volano\volano-2.12.0\conf\properties.txt".
    www.example.com:8000 (192.168.1.1:8000) VolanoChatPro - unlimited connections.
    Apache Tomcat/4.1.40
    

    Note the updated version number (2.12.0) and copyright date (2014).

  5. Go to the address http://localhost:8080/vcclient/ to connect with the applet on the same machine running the server. If you are connecting from another machine, replace localhost with the host name of the machine running the server.

    Note: You'll have to make the changes described at the top of this page to all of the HTML pages containing VOLANO applets before any of them will run on the latest Java 7 Plug-in.

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®