Administrator Guide

Process application download

For the installation of the Shared Canvas PlugIn, the user should be downloading the packages containing in the jWebSocket server. The user can find that in our Download area.

Installation Environment

  1. Download jWebSocketSharedCanvasPlugIn package from the address noted above.
  2. Unzip the downloaded package to a selected directory. For example you can unzip the jWebSocketSharedCanvasPlugIn package in a folder located in C:/Programs Files/jWebSocket if you use Windows OS, otherwise if you use Unix OS you can unzip the jWebSocketSharedCanvasPlugIn package in a folder located in /usr/lib/jWebSocket
  3. Create the JWEBSOCKET_HOME environment variable and assign it as value the path to the directory "jWebSocket-1.0" where was unzip the jWebSocketSharedCanvasPlugIn package.

Installation process

If the operating system is Linux, the package that contains the application client must be copied var/wwwIn addition it should be given all permits through the console. The package that contains the server can be stored in any location. Before running the client in the browser, the server must be running on an IDE.

If the operating system is Windows, you must have installed Wamp that creates the folder C://wamp/www. In this folder you must copy the packet that containing the client. The package that contains the server can be stored in any location. Before running the client in the browser, the server must be running on an IDE.

Wamp must be configured if the user prefers to access the application from an external workstation. For this the user must to change the attribute Listen of the httpd.conf configuration file as follows: Change this to listen on specific IP addresses as shown below to prevent Apache from glomming onto all bound IP addresses (0.0.0.0).

Listen: Allows you to bind Apache to specific IP addresses and/or ports, instead of the default.

Configuration Options

For the application execution, the user needs to include the following configuration of Shared Canvas PlugIn in the plug-in section in the jWebSocket.xml.

<!-- Shared Canvas PlugIn Configuration -->
<plugin>
	<name>org.jwebsocket.sharedcanvas.SharedCanvasPlugIn</name>
	<ns>org.jwebsocket.plugins.sharedcanvas</ns>
	<id>SharedCanvasPlugIn</id>
	<jar>jWebSocketSharedCanvasPlugIn-1.0.jar</jar>
	<server-assignments>
		<server-assignment>ts0</server-assignment>
	</server-assignments>
</plugin>

Putting into operation

To run Shared Canvas PlugIn should start with the jWebSocketSharedCanvasPlugIn file in the server. For this the user opens and starts the jWebSocketSharedCanvasPlugIn server on an IDE. The package contains the server is in the folder where it was downloaded and unzipped earlier.

The user must open the Shared Canvas Demo using any of the browsers that support the WebSocket protocol or older browsers that use a flash plug-in as fallback mechanism as well as a long/polling comet fallback. To run Shared Canvas Demo in the browser you must enter the following URL: http://localhost/ and then select the application folder. Then the user can start interacting with the application.

Publications

Learn more about WebSockets in general, get background information and gain deeper insight!

Join jWebSocket

Wether developer, designer or translator – join the jWebSocket team and grow together with our success!

Copyright © 2013 Innotrade GmbH. All rights reserved.