Installation Procedure

Installing the Widget Framework involves the steps listed below

Log in as escenic on your assembly-host.
Download the required distribution file. If you have a multi-host installation with shared folders as described in the Escenic Content Engine Installation Guide, then it is a good idea to download the distribution to your shared /mnt/download folder:
```
$ cd /mnt/download
$ wget https://user:password@maven.escenic.com/com/escenic/widget-framework/widget-framework/4.0.3-1/widget-framework-4.0.3-1.zip
```
Otherwise, download it to some temporary location of your choice.
If the folder /opt/escenic/engine/plugins does not already exist, create it:
```
$ mkdir /opt/escenic/engine/plugins
```
Unpack the distribution file:
```
$ cd /opt/escenic/engine/plugins
$ unzip /mnt/download/widget-framework-4.0.3-1.zip
```
This will result in the creation of an /opt/escenic/engine/plugins/widget-framework-4.0.3-1 folder.
Log in as escenic on your assembly-host.
Run the ece script to re-assemble your Content Engine applications.
```
$ ece assemble
```
This generates an EAR file (/var/cache/escenic/engine.ear) that you can deploy on all yourengine-hosts.
If you have a single-host installation, then skip this step.

On each engine-host where you wish to run the plug-in, copy /var/cache/escenic/engine.ear from the assembly-host. If you have installed an SSH server on the assembly-host and SSH clients on your engine-hosts, then you can do this as follows:
```
$ scp -r escenic@assembly-host-ip-address:/var/cache/escenic/engine.ear /var/cache/escenic/
```
where assembly-host-ip-address is the host name or IP address of your assembly-host.
On each engine-host where you wish to run the plug-in, deploy the EAR file and restart the Content Engine by entering:
```
$ ece deploy
$ ece restart
```