Upgrade Guide

This guide describes how to upgrade Continuuity Loom from 0.9.6 to the 0.9.7 Beta Release.

Checklist

  • 1 - Login to the Loom UI as admin and click “Export” to export a JSON file containing:

    • Hardware Types
    • Image Types
    • Providers
    • Services
    • Cluster Templates
  • 2 - Stop Loom services

    $ sudo /etc/init.d/loom-provisioner stop
    $ sudo /etc/init.d/loom-ui stop
    $ sudo /etc/init.d/loom-server stop
    
  • 3 - Stop Database and take a backup

    • The embedded Derby database and ZooKeeper server are stopped when Loom Server is stopped

    • If you are using another database, such as MySQL, follow your standard procedures for backing up the Loom database

    • If you are using the embedded Derby database or ZooKeeper, perform the following
      • Replace /var/loom/data below with the location from loom.local.data.dir in /etc/loom/conf/loom-site.xml if you have modified it from default
    $ sudo cp -R /var/loom/data /var/loom/data.backup
    
  • 4 - Verify configuration path

    • Double check that /etc/loom/conf.loom is the active configuration
    $ update-alternatives --display loom-conf
    
    • If not, run the following to update it
    $ update-alternatives --install /etc/loom/conf loom-conf /etc/loom/conf.loom 20
    
  • 5 - Upgrade Loom packages

  • 6 - Start Database and import schema (Optional)

    • If you are using MySQL, start the service and update the schema
    $ mysql -u loom -p loom < /opt/loom/server/config/sql/loom-create-tables-mysql.sql
    
    • If you are using another external database, you will need to perform the table changes, manually
  • 7 - Update JSON with new layout

    • Continuuity Loom 0.9.7 Beta modified the JSON layout for Automator and Provider plugins, this updates them
    $ /opt/loom/server/bin/loom-0.9.7-upgrade.rb -f export.json -o upload.json
    
  • 8 - Start Loom Server

    $ sudo /etc/init.d/loom-server start
    
  • 9 - Register Loom Provisioner plugins

    • The Loom Provisioner plugins registration informs the Loom Server how to interact with the plugin
    $ sudo /etc/init.d/loom-provisioner register
    
  • 10 - Start Loom UI

    $ sudo /etc/init.d/loom-ui start
    
  • 11 - Import new JSON

    • Login to the Loom UI as admin and click “Import” and select upload.json from your local machine
  • 12 - Start Loom Provisioners

    $ sudo /etc/init.d/loom-provisioner start
    

Table Of Contents

Previous topic

Release Notes

Next topic

Glossary