Description of problem: As of CloudForms 1.0.1, customers with an existing CloudForms System Engine 1.0 installation will be required to upgrade their system. A script 'katello-upgrade' is provided to migrate the customers data. We should document for customers ... 1) How they determine whether they need to run 'katello-upgrade' 2) How to update their systems from 1.0 to 1.0.1 (yum update?) 3) How to run 'katello-upgrade' NOTE, the release notes indicate that upgrades are not supported [1]. This will need to be adjusted [1] https://docs.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/chap-Release_Notes-Cloud_Engine.html#sect-Release_Notes-Cloud_Engine-known_issue_01
1. I think the main way customers will determine whether they need to run 'katello-upgrade' is via identifying core changes from the errata advisory RHBA-2012:13272-01: http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Technical_Notes/sect-Technical_Notes-System_Engine-RHBA-2012_13272-01.html 2 and 3. I've placed a procedure in the release notes: http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/chap-Release_Notes-Updates.html As for the note regarding upgrades not being supported, I'll modify this to link to the upgrade procedure in the same book.
Package: CloudForms-Release_Notes-1.0-web-en-US-1-3.el6eng Errata details basic procedure to upgrade to 1.0.1 plus BZs affected: * System Engine - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Technical_Notes/sect-Technical_Notes-System_Engine-RHBA-2012_13272-01.html * Cloud Engine - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Technical_Notes/sect-Technical_Notes-Cloud_Engine-RHBA-2012_13263-01.html Full procedure outlined in Release Notes: * System Engine - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/chap-Release_Notes-Updates.html#chap-Release_Notes-Updates-System_Engine * Cloud Engine - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/chap-Release_Notes-Updates-Cloud_Engine.html Modified Release Note considerations: * System Engine - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/chap-Release_Notes-Cloud_Engine.html#sect-Release_Notes-Cloud_Engine-known_issue_01 * Cloud Engine - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/chap-Release_Notes-System_Engine.html#sect-Release_Notes-System_Engine-System_Engine_Considerations-known_issues_02