How use

From XtremWebCH Wiki

Jump to: navigation, search

Contents

[edit]

Downloading, installing and using XWCH

[edit]

Worker installation

An installation program for all operating systems. [1]

Please note that you'll need Java to run the installer (and the worker). On most systems (Windows, Linux desktop, OSX) you just need to click on the installer, and a guided installation will start. If your computer does not show graphics, you can run the installer by "java -jar XWCH-Installer.jar". By default, the worker starts reporting to our coordinator. You can change this in the installation program.


[edit]

How to make the worker run all the time when the computer is on (even when no user is logged in)

With Windows XP, this can be done by making a scheduled task with Windows Control Panel, as shown in the following image Media:wincron.jpg.

Please note the circled "On computer startup" option in the startup time. The startup directory should be the same where the program is located (C:\Program Files\XWCHworker in our case).


With Linux, automated tasks can be started by adding the startup command in /etc/rc.local, for instance like this: 

cd /home/youruserid
su -c "sh startxw.sh &" youruserid
[edit]

Coordinator installation

The coordinator is an "EAR" web application that can be deployed under a web server like GlassFish3.

The simplest way is to use our "all in one" package for linux. Download : [2].

This package contains :

  • glassfish v3.1.1 [3]
  • the glassfish mysql connector [4] (optional)
  • the ear coordinator [5].
  • an installation script (and a README with some additionnal informations)

Extract the package where you want to install Glassfish, fix the parameters as you want in the begining of the script and run it. If you want to use a MySql database, please make sure to have MySql up and running before running the script.

The script will does the following :

  • Create a MySql database (unless using Derby)
  • Run Glassfish installation
  • Copy the glassfish mysql connector in the right directory
  • Create a database connection called "xwchtestlocal", connecting to this database
  • Deploy the EAR file


When the coordinator is installed, point your browser to http://yourhost:yourport/XWCHWeb (default port : 8080) and fill the simple form shown below.

Image:xwch-coord.png

[edit]

Warehouse installation

Download: [6]

To run the warehouse, unzip the file and enter the following command:

java -Xrs -classpath . -jar javanode.jar config.properties

By editing the config.properties file in the warehouse's directory you can configure which coordinator the warehouse reports to and where files are stored. Here is an example: 

xwserver=http://mycoordinatorserver.com:8080/WorkerServiceService/WorkerService
nodeport=8105
nodefolder=path_to_your_home/.xw_repository


[edit]

Downloading the source code

If you are a programmer, you can find resources from Techical Documentation and Developer's Guide

[edit]

Running a Hello world application

Please see the example in Developer's Guide.

Retrieved from "http://www.xtremwebch.net/mediawiki/index.php/How_use"
Views
Personal tools