Install Newsgate

Installing Newsgate involves the following steps:

Log in as escenic on your assembly-host.
Download the Newsgate distribution from the Escenic Technet web site (http://technet.escenic.com). 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@tmaven.escenic.com/com/escenic/plugins/newsgate/newsgate/3.1.3-2/newsgate-3.1.3-2.zip
```
Otherwise, download it to some temporary location of your choice.
If the folder /opt/escenic/plugins does not already exist, create it:
```
$ mkdir /opt/escenic/plugins
```
Unpack the Newsgate distribution file:
```
$ cd /opt/escenic/plugins
$ unzip /mnt/download/newsgate-3.1.3-2.zip
```
This will result in the creation of an /opt/escenic/plugins/newsgate folder.

Copy newsgate-webservice.war to the assembly tool's publications folder:

$ cp /opt/escenic/plugins/newsgate/wars/newsgate-webservice.war /opt/escenic/assemblytool/publications/

Create a text file called newsgate-webservice.properties in the /opt/escenic/assemblytool/publications/ folder, with the following contents:
```
name:          newsgate-webservice
source-war:    newsgate-webservice.war
context-root:  /newsgate-webservice
```
If you have a multi-host installation, then repeat this two steps on each engine-host .
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 your engine-hosts.
If you have a single-host installation, then skip this step.

On each engine-host, 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, deploy the EAR file and restart the Content Engine by entering:
```
$ ece deploy
  $ ece restart
```