-
Release
-
Resolution: Done
-
High
-
None
-
None
== Release guide 3.3.0 ==
Letter in [ ] means who is responsible for such step:
[J] Jozef
[L] Libor
[D] Dmytro
[R] Rysiek
=== Backup steps ===
1. [D] backup DB (both author & public)
2. [D] backup author instance WAR directory
3. [D] backup public instance WAR directory
4. [D] backup Clearspace /services/clearspace/jiveHome
=== Pre-Release steps ===
1. [R] Do svn merge of CS theme from QA to PROD (https://svn.jboss.org/repos/cms/qa/cs-theme/ to https://svn.jboss.org/repos/cms/prod/cs-theme/)
2. [R] Do svn merge of theme from QA to PROD (https://svn.jboss.org/repos/cms/qa/theme/ to https://svn.jboss.org/repos/cms/prod/theme/)
3. [R] Do svn merge of magnolia templates repository from QA to PROD (https://svn.jboss.org/repos/cms/qa/magnolia/ to https://svn.jboss.org/repos/cms/prod/magnolia/)
=== Release steps ===
1.1. [J] in author instance's admin interface, delete /modules/jbossorg-downloads tree (in Configuration)
1.2. [J] in public instance's admin interface, delete /modules/jbossorg-downloads tree (in Configuration)
2.1. [D] On Apache Web Server VM, edit /etc/httpd/conf/vhosts/www.jboss.org-common/www.jboss.org-proxy.conf and delete '|jbossforums' string from line no. 58
2.2. [D] Turn on maintenance page.
2.3. [D] stop Magnolia's EAP
2.4. [D] On Apache Web Server - svn up /services/web/www.jboss.org/htdocs/theme
3.1 [D] svn up in /services/magnoliaAuthor/deploy/magnoliaAuthor.war/templates/jbossorg
3.2. [D] svn up in /services/magnoliaAuthor/deploy/magnoliaAuthor.war/docroot/jbossorg
4.1. [D] remove jbossorg-downloads-1.0.0.jar from WEB-INF/lib directory of author instance
4.2. [D] remove /templates/jbossorg/paragraphs/jbossorg-downloads directory with all its content
5.1. [D] copy jbossorg-cs-paragraphs-1.0.1.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of author instance
5.2. [D] copy jbossorg-downloads-1.0.1.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of author instance
5.3. [D] copy jbossorg-wiki-1.0.0.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of author instance
5.4. [D] copy mgnl-paragraphs-1.0.0.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of author instance
6.1. [D] svn up in /services/magnoliaPublic/deploy/magnoliaPublic.war/templates/jbossorg
6.2. [D] svn up in /services/magnoliaPublic/deploy/magnoliaPublic.war/docroot/jbossorg
7.1. [D] remove jbossorg-downloads-1.0.0.jar from WEB-INF/lib directory of public instance
7.2. [D] remove /templates/jbossorg/paragraphs/jbossorg-downloads directory with all its content
8.1. [D] copy jbossorg-cs-paragraphs-1.0.1.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of public instance
8.2. [D] copy jbossorg-downloads-1.0.1.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of public instance
8.3. [D] copy jbossorg-wiki-1.0.0.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of public instance
8.4. [D] copy mgnl-paragraphs-1.0.0.jar from koopa.qa.atl.jboss.com/home/jchochol/release-3.3.0 to WEB-INF/lib directory of public instance
9. [D] start EAP
10.1. [J] go to the https://www.jboss.org/author/.magnolia/pages/adminCentral.html - you'll be redirected to the "Magnolia needs to be updated" page, then click the link
10.2. [J] you should see 3 modules to be installed, click "Start install/update" and wait for result
10.3. [J] if you see "Start up Magnolia", click it; otherwise check for errors and rollback;
11.1. [J] go to the https://www.jboss.org/author/.magnolia/pages/adminCentral.html page again, log in and configure csLogin and csPassword properties with Clearspace admin credentials under /modules/jbossorg-cs-paragraphs/config path in Configuration
11.2. [J] check other configuration properties of the jbossorg-cs-paragraphs module - see "Configuration" section in https://docspace.corp.redhat.com/clearspace/docs/DOC-22601
12.1. [J] go to the https://www.jboss.org/.magnolia/pages/adminCentral.html - you'll be redirected to the "Magnolia needs to be updated" page, then click the link
12.2. [J] you should see 3 modules to be installed, click "Start install/update" and wait for result
12.3. [J] if you see "Start up Magnolia", click it; otherwise check for errors and rollback;
13.1. [J] go to the https://www.jboss.org/.magnolia/pages/adminCentral.html page again, log in and configure csLogin and csPassword properties with Clearspace admin credentials under /modules/jbossorg-cs-paragraphs/config path in Configuration
13.2. [J] check other configuration properties of the jbossorg-cs-paragraphs module - see "Configuration" section in https://docspace.corp.redhat.com/clearspace/docs/DOC-22601
14.1. [J] login to author instance Admin Console with superuser account
14.2. [J] switch to Tools -> JCR Browser view and delete '/jbossorg' node
14.3. [J] right click, click Import from xml and import website.jbossorg.xml file attached to this task. /jbossorg node should recreate. Activate it with subnodes.
14.4. [J] switch to Configuration view
14.5. [J] at node /modules/siteDesigner import config.modules.siteDesigner.controls.xml file. /modules/siteDesigner/controls node should appear. Activate it with subnodes.
14.6. [J] at node /modules/siteDesigner/dialogs/jbossorg/pageProperties import file config.modules.siteDesigner.dialogs.jbossorg.pageProperties.tabTheme.xml file. /modules/siteDesigner/dialogs/jbossorg/pageProperties/tabTheme node should appear. Activate it with subnodes.
14.7. [J] delete node /modules/siteDesigner/dialogs/jbossorg/template.
14.8. [J] at node /modules/siteDesigner/dialogs/jbossorg import config.modules.siteDesigner.dialogs.jbossorg.template.xml file. /modules/siteDesigner/dialogs/jbossorg/template node should recreate. Activate it with subnodes.
==== Clearspace theme update ====
1. [D] 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
2. [L] Refresh CS theme in Clearspace:
Login as Administrator to http://www.jboss.org/community/admin and in System->Settings->Theme click on the 'Change Global Theme' link and then hit the 'Set Global Theme' button to reload the theme from the files.
=== Test steps ===
1. [J] Log in to auhtor instance admin interface
2. [J] Create and open web page
3. [J] Insert following paragraphs to the page: Member spotlight, JBoss Downloads, JBoss Wiki
4. [J] Activate the page
5. [J] Check if page is visible at http://www.jboss.org/ and all paragraphs display proper information
6. [L] Clearspace: Check if no javascript error occur, check if main menu has effects, check if design of page is OK.
=== Maintenance Page Should Be Turned Off ===
=== Rollback steps ===
1. [D] Stop both instances
2. [D] Restore both WAR directories
3. [D] Restore both databases
4. [D] Start both instances
5. [J] Check functionality
6. [D] Restore Clearspace /services/clearspace/jiveHome
=== Post release steps ===
1. [R] Create a tag of https://svn.jboss.org/repos/cms/prod/cs-theme repository
2. [R] Create a tag of https://svn.jboss.org/repos/cms/prod/theme repository
3. [R] Create a tag of https://svn.jboss.org/repos/cms/prod/magnolia repository
4. [R] Create a tag of https://svn.jboss.org/repos/cms/prod/forge/portal-content/feeds/view repository
5. [R] Create a tag of https://svn.jboss.org/repos/cms/prod/forge/portal-content/default/theme/jsp/org repository