Univiewer Console Web Start Installation, Configuration and Upgrade

This section details:

• UVC Web Start Installation for Linux Web Servers
• UVC Web Start Installation for Windows Web Servers
• Configuring the JNLP File
• UVC Web Start Upgrade

UVC Web Start Installation for Linux Web Servers

Copy the univiewer_console_webstart_6.<m.bb>_all_unix.taz file to the default website root directory.

For example: "TOMCAT_ROOT/webapps"

tar –xvzf univiewer_console_webstart_6.<m.bb>_all_unix.taz

Continue with paragraph: “Configuring the JNLP File”

UVC Web Start Installation for Windows Web Servers

Copy the univiewer_console_webstart_6.<m.bb>_windows.exe file to the default website root directory.

For example: "TOMCAT_ROOT/webapps"

Double click the file to extract contents into a univiewer_console_webstart_6.<m.bb>_windows sub-directory.

Configuring the JNLP File

Edit the uvc.jnlp file located in the root directory of the application. This file, called from index.html, triggers the download of the Java Web start client to the end user’s workstation.

The second line of this file contains:

<jnlp spec="1.0+" codebase="http://<server>:<port>/univiewer_console_webstart_<v.m.bb>" >

• Replace <server> with the fully qualified server name of the Web (for example, myserver.domain.com) or "localhost" if the server is local.
• Replace <port> with the port number used by the Web or application server, generally 8080 for http/Web server

For example:

<jnlp spec="1.0+" codebase="http://serveur.domaine.com:8080/univiewer_console_webstart_<v.m.bb>" >

On certain older operating system versions, jnlp files may not be associated with the javaws application, leading to error messages of the type “access denied”. If this problem is encountered, make sure that the extension “jnlp” is mapped to the mime type “application/x-java-jnlp-file” in the Web server configuration.

UVC Web Start Upgrade

To upgrade Univiewer Console Web Start on the Web server side:

• Save the existing uvc.jnlp file to a safe directory

• Install the new Univiewer Console Web Start

  Refer to section: UVC Web Start Installation for Linux Web Servers or UVC Web Start Installation for Windows Web Servers.

• Configure the new uvc.jnlp file using the saved parameters (refer to section: Configuring the JNLP File).

If you upgraded to a new version of Univiewer Web Start, deploy it with the same name as the previous version. You will not have to communicate a new URL to your end users and they will get the new version automatically when they launch Univiewer Console.

The client-side upgrade will be performed automatically when the user loads the Univiewer Console Web Start.