Essential part of upgrading is comparison what has been changed in FTL that we customize in jboss theme.

Backup steps (do that when EAP is stopped):

• Backup DB
• Backup Jive home
• Backup whole community.war

Preparation steps:

• Unpack new jive_clearspace_war.tar.gz to community.war directory
• Put plugin customization (WEB-INF/templates.xml)
• Put jive_init.xml to WEB-INF/classes
• Put our jars to WEB-INF/lib (cs-migration.jar, cs-nukes-login-1.0-SNAPSHOT.jar)
• Put HF Links classes to WEB-INF/classes (WEB-INF/classes/org)
• Take prepared ui-components.xml file from goomba (/services/jbossorg/clearspace251GA/clearspace-customizations/WEB-INF/classes/ui-components.xml) and put to the WEB-INF/classes

Release steps:

• Stop EAP
• Delete community.war
• Copy prepared community.war to deploy directory
• Update CS themes from SVN:
  svn up /services/clearspace/jiveHome/themes/jbossorg-custom-css/common_header/theme
  svn up /services/clearspace/jiveHome/themes/jbossorg-custom-css

If svn update not works svn checkout can be performed by these commands:
cd /services/clearspace/jiveHome/themes/
svn checkout https://svn.jboss.org/repos/cms/prod/cs-theme
rm jbossorg-custom-css/ -rf
mv cs-theme jbossorg-custom-css
cd /services/clearspace/jiveHome/themes/jbossorg-custom-css/common_header
svn checkout https://svn.jboss.org/repos/cms/prod/theme
chown jboss:jboss /services/clearspace/jiveHome/themes -R

• Update common theme from SVN:
  svn up /services/web/www.jboss.org/htdocs/theme
• Start EAP

• Go to the CS homepage and follows upgrade steps
• Restart EAP

• Go to CS administration and check if indexes are rebuilded (/admin/settings-search.jsp)
• Remove plugin jboss-settings (/admin/settings-plugin.jspa)
• Wait till indexes are rebuilded
• Check article statistics. If disappear then follow these steps:
• run on Clearspace this repair sql: UPDATE jiveDocument SET creationDate = 1003661246000 WHERE creationDate = 0; (8 rows should be affected)
• Follow these steps: (taken from http://www.jivesoftware.com/jivespace/docs/DOC-5560)
• DELETE FROM jiveStat WHERE statdate < 1250049600000; (around 1.9 mil. rows should be affected)
• Set the CS system property stats.historical.enabled = true
• Restart EAP
• Check log. In 10 minutes task will start (in log is message: "Historical Statistics Task: Starting to circle")
• Delete the CS system property stats.historical.enabled
• Task will take some hours (in migration env. 37 hours) and is finished with message "Historical Stats Task took ["
• Clearspace can be promoted

Magnolia:

• svn up /services/magnoliaAuthor/deploy/magnoliaAuthor.war/templates/jbossorg/
• svn up /services/magnoliaPublic/deploy/magnoliaPublic.war/templates/jbossorg/

Rollback steps:

• Stop EAP
• Revert clearspace DB
• Revert jiveHome
• Revert community.war
• Start EAP

Test steps:
Clearspace:

• test jboss.org/community
• jboss.org/community/wiki/SandBox - Action widget should have links Permanent link and View full screen - test those linkes
• try to login into jboss.org/community/admin and jboss.org/community/login.jspa