Other details are available on the documents repository.

How to install eZFusion ?

eZFusion is a java application hosted on an OSGi framework. To install eZFusion, first install one of the OSGi frameworks the compatibility of wich has tested:

• Knopflerfish 2.0.4
  
• Knopflerfish 2.0.5
• Knopflerfish 2.1.0
• Knopflerfish 2.1.1
• Knopflerfish 2.2
• Knopflerfish 2.3
• Knopflerfish 2.3.1
• Knopflerfish 2.3.2
  

Then check the additional services needed to run eZFusion:

• HTTP-Server (usually installed by default)
• Remote OSGi (bundle here)
  

Finally, install eZFusion's bundle:

• ezfusion_all_in_one.jar (or at the bottom of this page)
  

Network restrictions

• eZFusion needs a network connection in order to transfer the information in the fusion process (currently in RMI) and the control commands (currently in HTTP),
• some of the eZFusion components need an Internet connection in order to be fully activated.

How to run eZFusion ?

We assume that one of the compatible OSGi framework is installed and is running with the additional bundles needed to run eZFusion. As soon as the eZFusion's bundle is installed and started onto the OSGi framework, eZFusion registers an HTTP servlet at the following address :

• localhost has to be changed to the host name or IP address of the computer that runs the OSGi framework,
• the port 8080 may be updated according to the configuration of the HTTP-Server.

The Graphical User Interface (GUI) is actually based on a html pages. It is divided in two parts :

The current version of eZFusion is controled by http request sent by the GUI. Due to technical choices during the developpement, an action is performed in two steps : the writing of the request, and its sending.
To write a request, select one of the pannels in the commands part of the GUI, fill in the field and click on "write request". A form with the details of the request is generated and some values may be corrected if necessary. To send the request, click on the top left button.

Note : the eZFusion control system may be available only on part of the network interfaces. If a request seams to be without effect, please check the list "Node IP" and select another interface.

The effects of a request (if any) can be visualised in the informations part of the GUI. Several pannels are possible and their contents are described in the GUI dedicated page.

How to deploy a configuration of a fusion process ?

Note : a toy example is available on eZFusion's sourceforge pages :

• the jar file that contains the fusion functions, (the source files are included)
  
• the xml files for example1, example2, example3. (addresses are ready to use)
• results are written in the console of the OSGi framework.
  

A configuration is currently described by XML files. Each computer used to execute the fusion process reads its part of the configuration and deploys it. The current version of eZFusion needs the manual deployement of each part of the configuration on the corresponding computers. To do so, open the GUI of each computers where to deploy the configuration and follow these steps :

1. open the configuration panel in the commands part of the GUI,
2. tick off "set xml file" and write where to read the configuration file from (either on local file system or a URL over the network, be carefull to the correctly write the protocol http:// of file://),
3. write and send the request,
   
4. the panel "configuration manager" in the right side of the GUI should be updated according to the content of the xml file,
   if it doesn't, click on the panel title,
   
5. if the informations in the configuration manager are right, tick off "start execution" in the configuration panel of the left side of the GUI,
6. write and send the request.
   
7. tick off "stop execution" and redo step 6. to stop the execution of the configuration.

Redo the same steps on each computer, from the PC at the "end" of the fusion process (the actuators) to the PC at the "begin" of the process (the information sources).