Installing CUE

CUE 2.3.1-4 requires version 6.0 of the Escenic Content Engine and version 3.7 of CCI Newsgate with the latest patch applied. Before installing CUE, ensure that the back-end systems you are going to use it with have been upgraded accordingly:

  • If CUE is to use an Escenic back-end, make sure your Escenic Content Engine is upgraded to version 6.0 or higher

  • If CUE is to use a CCI Newsgate back-end, make sure that the version is 3.7, and that the latest patch for that version has been applied

CUE also requires the use of an SSE Proxy to manage the delivery of Server-sent Events from the Escenic Content Engine to CUE clients. This means that an Escenic SSE Proxy must have been installed and configured to manage SSE for the Content Engine, and the Content Engine must have been configured to direct SSE connection requests to the SSE Proxy. For detailed information on how to do this, see the SSE Proxy documentation.

CUE is available as a standard Debian installation package, making installation on Ubuntu or other Debian-based Linux systems very straightforward. CUE is a standalone web application, not an Escenic plug-in. Although it needs to be connected to an Escenic Content Engine and/or a CCI Newsgate back end, it does not need to be co-located with either of them. It can be installed on the same server as a Content Engine instance, but it does not need to be. An application server such as Tomcat is not required to serve CUE. Since it is a pure HTML/Javascript application, a web server such as nginx or Apache is sufficient.

The instructions given here are based on the use of an nginx web server, running on Ubuntu.

To install CUE:

  1. Log in via SSH from a terminal window.

  2. Switch user to root:

    $ sudo su
  3. If necessary, add the Escenic apt repository to your list of sources:

    # curl --silent http://user:password@apt.escenic.com/repo.key | apt-key add -
    # echo "deb http://user:password@apt.escenic.com stable main non-free" >> /etc/apt/sources.list.d/escenic.list

    where user and password are your Escenic download credentials (the same ones you use to access the Escenic Maven repository). If you do not have any download credentials, please contact Escenic support.

  4. You need to install version 1.7.5 or higher of nginx. The version available in the Ubuntu 14.04 repositories is too old, so in order to ensure that you install a new enough version, you need to add a repository containing a more recent version:

    # add-apt-repository ppa:nginx/stable
  5. Update your package lists:

    # apt-get update
  6. Download and install CUE. The recommended way to do this is:

    # apt-get -o APT::Install-Suggests="true" install cue-web-2.3

    This installs CUE with all currently available base plug-ins (base plug-ins are plug-ins that provide additional basic functionality and do not depend on the installation of Escenic plug-ins). If you do not want to install all the base plug-ins, then you can instead either enter:

    # apt-get install cue-web-2.3 

    to install only the basic CUE editor, or

    # apt-get install cue-web-2.3 cue-plugins

    where cue-plugins is a list of 0 or more base plug-ins to be installed together with CUE. For a list of currently available base plug-ins plus general information about installing plug-ins, see Installing and Configuring Plug-ins.

  7. Download and install nginx

    # apt-get install nginx