Install the ece Script

The ece shell script provides a set of commands for easily stopping, starting and assembling the Content Engine.

The ece shell script is not the same as the daemon script (also called ece) which you installed earlier (see Install a Daemon Script). The daemon script manages running the Content Engine to run as a service by automatically calling this script on system startup and shutdown.

To install the ece shell script:

On your assembly-host, while logged in as escenic:

Make /opt/escenic/engine/bin/ece executable:
```
$ chmod +x /opt/escenic/engine/bin/ece
```
Open /home/escenic/.bashrc for editing, and add the following line to it in order to add /opt/escenic/engine/bin to your PATH:
```
export PATH=/opt/escenic/engine/bin:$PATH
```
Then enter the following command to apply the change you have made in your current shell:
```
$ source ~/.bashrc
```
Copy the script's configuration file to /etc/escenic/engine:
```
$ cp /opt/escenic/engine/etc/ece.conf /etc/escenic/engine/
```
This is the configuration file that will be read when ece is executed on the assembly-host.
If you are installing everything on one host, then skip this step.

Copy the script's configuration file to each of the host configuration folders you have made. For example:
```
$ cp /opt/escenic/engine/etc/ece.conf /etc/escenic/engine/host/editorial1/
$ cp /opt/escenic/engine/etc/ece.conf /etc/escenic/engine/host/presentation1/
```
These are the configuration files that will be read when ece is executed on the various engine-hosts. (If your assembly-host is also an engine-host, then you do not need a copy in /etc/escenic/engine, the host-specific copy will be used.)
Open the copies of ece.conf that you created in steps 4 (and possibly 5), and make sure that the parameters listed below are set correctly for your installation, and for the specific host they correspond to. If you have followed all the instructions in this guide exactly, then the following settings should work:

java_home

Make sure that this is set to the path of the Java virtual machine included in the JDK you installed (see Install Java SE Development Kit (JDK)).

ece_home

Set this to /opt/escenic/engine.

ece_server_hostname

Set this to the host name or IP address of the RMI hub to be used at this installation (not relevant for single-host installations).

ece_security_configuration

Set this to /etc/escenic/engine/common/security.

appserver

Currently, the only valid setting for this is tomcat.

tomcat_home

Set this to /opt/tomcat.

solr_home

Set this to /var/lib/escenic/solr/default. This is the location to which you have copied the Solr configuration data (see Copy Solr Configuration).

assemblytool_home

Set this to /opt/escenic/assemblytool.

Then, on each of your engine-hosts, while logged in as root:

Copy the ece script 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 escenic@assembly-host-ip-address:/opt/escenic/engine/bin/ece /usr/local/bin/
```
where assembly-host-ip-address is the host name or IP address of your assembly-host.
Make /usr/local/bin/ece executable:
```
# chmod +x /usr/local/bin/ece
```

Verify that the script is correctly installed by entering the following while logged in as escenic:

$ ece

This should give the following output:

Usage: /opt/escenic/engine/bin/ece <command>
where command is one of:
   start      starts the ECE
   stop       stops the ECE
   kill       uses force to stop ECE
   restart    restarts the ECE
   status     ECE status
   log        the ece-messages.log
   outlog     the [ece] script log (system out log)
   applog     the app server log
   threaddump write a thread dump to standard out (system out log)
   assemble   runs the Assembly Tool
   deploy     deploys the assembled EAR