Coopr Upgrade

This guide describes how to upgrade Cask Coopr from 0.9.8 to the 0.9.9 Release.

Overview

This upgrade involves three key steps:
  • A database upgrade
  • Changing the provisioner server URI port
  • Running the upgrade script

Compatibility Notes

Provisioner plugins must now extend from Coopr::Plugin::Automator or Coopr::Plugin::Provider. Any existing custom plugins need to be updated accordingly.

Upgrade Steps

On the Coopr servers:

  1. Stop all processes
$ sudo /etc/init.d/coopr-provisioner stop
$ sudo /etc/init.d/coopr-ui stop
$ sudo /etc/init.d/coopr-server stop
  1. Back up your database
  • It is recommended to backup your database. Consult your database vendor’s documentation for instructions.
  1. Upgrade Database Schema (if using an external database)
  • You have to update the schema for any external database. However, we only provide example SQL files for MySQL. The changes need to be made to any external database. To update MySQL:
$ mysql -p coopr < /opt/coopr/server/sql/upgrade-tables-pre0.9.9-to-0.9.9.sql
  1. Change the provisioner.server.uri port
  • Edit the provisioner.server.uri property in /etc/coopr/conf/provisioner-site.xml and change the port from 55054 to 55055 unless you have changed the port with server.tasks.uri, in which case you should match the port below to that one. Here is an example (changing your server to the correct host/FQDN):
<property>
  <name>provisioner.server.uri</name>
  <value>http://myserver.mydomain.com:55055</value>
  <description>URI of server to connect to</description>
</property>
  1. Run the upgrade script
$ sudo /etc/init.d/coopr-server upgrade
  1. Start Coopr Server, UI and Provisioner services
$ sudo /etc/init.d/coopr-server start
$ sudo /etc/init.d/coopr-ui start
$ sudo /etc/init.d/coopr-provisioner start