Installing CUE

CUE requires the use of an SSE Proxy to manage the delivery of Server-sent Events from the CUE Content Store to CUE clients. This means that an CUE SSE Proxy must have been installed and configured to manage SSE for the Content Store, and the Content Store must have been configured to direct SSE connection requests to the SSE Proxy. For general information on how to install and configure an SSE Proxy, see the SSE Proxy documentation. For specific guidance on how to configure the Content Store and the SSE Proxy to work together with CUE, see Configure an SSE Proxy Connection for CUE .

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. Although it needs to be connected to an CUE Content Store 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 Store 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.

A note about version code names

CUE and all related applications (CUE Content Store, CUE Print, Content Store plug-ins and so on) are released on a synchronized schedule where all product versions in a given release are known to work well together. Only these approved version combinations are supported. Each set of compatible product versions is identified by a code name, and during installation you can use this code name instead of the individual product's version number, thereby simplifying the installation process.

In the case of CUE and other Linux applications installed on Ubuntu using apt, the code name is actually the name of a repository containing compatible versions of all products. This means that in order to ensure version compatibility, all you need to do is add the name of the required repository to your /etc/apt/sources.list.d/escenic.list file. Once you have done this you do not need to specify any version numbers when installing individual packages - apt will just install the latest maintenance release from that repository.

Note that code names cannot be used in this way on Red Hat installations, where the application packages to be installed must still be identified by their version numbers. This is also the case for CUE Print.

The code name for CUE 3.12.24-2 is lithium. To find the correct CUE Print version to install for the lithium release, check the CUE Print release notes.

Installation procedure

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, download and set the Escenic apt repository key:

    # curl --silent | apt-key add -

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

  4. Add the current version repository name to your list of sources.

    # echo "deb lithium main non-free" >> /etc/apt/sources.list.d/escenic.list
  5. 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
  6. Update your package lists:

    # apt-get update
  7. Download and install CUE:

    # apt-get install cue-web
  8. Download and install nginx

    # apt-get install nginx