trove/install-guide/source/install-ubuntu.rst

Install and configure for Ubuntu

This section describes how to install and configure the Orchestration service for Ubuntu 14.04 (LTS).

This section assumes that you already have a working OpenStack environment with at least the following components installed: Compute, Image Service, Identity.

• If you want to do backup and restore, you also need Object Storage.
• If you want to provision datastores on block-storage volumes, you also need Block Storage.

Install and configure components

1. Install the packages:

   # apt-get update
   
   # apt-get install python-trove python-troveclient \
     python-glanceclient trove-common trove-api trove-taskmanager \
     trove-conductor

Finalize installation

1. Due to a bug in the Ubuntu packages, edit the service definition files to use the correct configuration settings.

   To do this, navigate to /etc/init and edit the following files as described below:

   trove-taskmanager.conf

   trove-conductor.conf

   (Note that, although they have the same names, these files are in a different location and have different content than the similarly named files you edited earlier in this procedure.)

   In each file, find this line:

   exec start-stop-daemon --start --chdir /var/lib/trove \
      --chuid trove:trove --make-pidfile \
      --pidfile /var/run/trove/trove-conductor.pid \
      --exec /usr/bin/trove-conductor -- \
      --config-file=/etc/trove/trove.conf ${DAEMON_ARGS}

   Note that --config-file incorrectly points to trove.conf.

   In trove-taskmanager.conf, edit config-file to point to /etc/trove/trove-taskmanager.conf.

   In trove-conductor.conf, edit config-file to point to /etc/trove/trove-conductor.conf.

2. Restart the Database services:

   # service trove-api restart
   # service trove-taskmanager restart
   # service trove-conductor restart