This document describes the procedure which QA uses to perform a release of JBossAS.

Pre-Release procedure

1. At least two weeks before a release, create a task for the release in the JBQA JIRA project.

1. Add a task in DOCS for updating the ejb3 trailblazers, linked to the above JBQA task.

2. At least two weeks before release, make sure there is a testsuite/src/etc/serialVersionUID/.ser file for the previous release.  See org.jboss.test.compatibility.test.SerialVersionUIDUnitTestCase for more information.

Release Procedure for jboss-4.0.x

1. Checkout build/build-release.xml file

1. example: svn export https://svn.jboss.org/repos/jbossas/tags/JBoss_4_0_5_CR1/build/build-release.xml

2. Copy build-release.xml to top level directory for release

3. Create a release.properties file and in it define

1. release.version.major

2. release.version.minor

3. release.version.revision

4. release.version.tag

4. Ensure that the release version info is updated in the following files: tools/etc/buildmagic/buildmagic.ent & tools/etc/buildmagic/version-info.xml

5. Checkout the source for this release

1. ant -f build-release.xml cvs-co (deprecated since subversion move)

2. instead checkout by hand https://svn.jboss.org/repos/jbossas/tags/yourtag into the structure releasenumber/jboss-4.0.x 

3. mkdir 4.0.5.CR1; cd 4.0.5.CR1

4. svn co https://svn.jboss.org/repos/jbossas/tags/JBoss_4_0_5_CR1 jboss-4.0.x

6. Build the distr with JDK1.4

1. ant -f build-release.xml build-dist

7. Ensure that the the target verson-release was completed without errors

1. You may need to pipe its output to a file to do this

8. Before running the testsuite, you will want to make a copy of the source tree and put it in the top level so that testsuite build is not included in final distribution

9. Run the testsuite

10. Resolve any testsuite issues

11. As of 4.0.4.GA, the html results are no longer included as part of the distribution.

1. copy the testsuite/output/reports/text/TESTS-testsuites.txt to the main source tree /VERSION/jboss-x/build/output/serverversion/docs/tests

12. build the release

1. files to release are the zip, the installer.jar and for the sources, release .zip and .tar.gz

2. ant -f build-release.xml release

3. outputs will be:

• /VERSION/dist - the base server release to upload to sourceforge

• /VERSION/repository - a canonical dist of the server and jars for reuse by other projects

1. cd into the VERSION/dist directory to upload the sourceforge contents

2. Refer link for uploading options: http://alexandria.wiki.sourceforge.net/FileReleaseSystem-OfferingFilesfor+Download

1. Update the jbossbuild (maven2 is a todo) repository.

1. The /VERSRION/repository dir contains a jbossas-repo-x.y.z.zip and a jbossas-jars-x.y.z.zip for the canonical binary jbossas dist and the core server jars respectively. These need to be added to the jbossbuild binary repository in order to build the JEMSInstaller. The jbossas-repo-x.y.z.zip and component-info.xml are the sole contents of the repository.jboss.com/jbossas/x.y.z component. The zip should be placed under repository.jboss.com/jbossas/x.y.z/lib. The jbossas-jars-x.y.z.zip are the content for the repository.jboss.com/jbossas/core-libs/x.y.z component. The associated component-info.xml descriptor is bundled in the jbossas-jars-x.y.z.zip archive. The archive jars should be added under repository.jboss.com/jbossas/core-libs/x.y.z/lib.

2. Build the ejb3.deployer repository contents. Currently the ejb3 deployer repository contents are bootstrapped from the jboss-4.0.x/ejb3 module. This is built after the release by running the jbossas build using JDK5.

1. Run the jbossas build using JDK5. This can be a clean build or just a rebuild over the existing dist build.

2. cd into jboss-4.0.x/ejb3 and run the repository-zip target. The resulting output/lib/jboss-ejb3-repo.zip is the complete contents of the repository.jboss.com/jboss/ejb3 component for the release.

3. Unzip the jboss-ejb3-repo.zip archive into the repository.jboss.com/jboss/ejb3 directory to create the component subtree for this version of the ejb3 deployer.

4. Add the component subtree to cvs to make it available to the installer.

3. build the installer using JDK14 (4.0.4.GA and latter) see the JEMSInstallerReleaseGuide. For building and intstaller for earlier releases, see the "Legacy (Pre-4.0.4.GA) Installer Build Instructions" section at JEMSInstallerReleaseGuide.