Creating a maintenance branch

The most up-to-date Narayana upstream releases are issued from the main branch.

But Narayana provides some maintenance branches as well (e.g. 7.1, …​). This wiki documents steps which are needed when a new maintenance branch is created.

New maintenance branches should be named <MAJOR>.<MINOR>

Changes when a maintanance branch is created

• Only narayana and quickstart repository should be tagged. Remove documentation and performance repositories from the release plan. See the PR at https://github.com/jbosstm/narayana/commit/bac79b25ec013f6d19e476323bdbe3ccf0ca5418

• change the scripts/pre-release-vars.sh script for the BRANCH contains the name of the maintenance branch which is created

• Remove generating of the web pages for the maintenance branch. The ant command should avoid the web target. See how the script may be adjusted here https://github.com/jbosstm/narayana/commit/a155fa429ab8db18f555048be65bd73b9dfca6fa

• Change the scripts/hudson/narayana-rebase.sh script to define the environmental variable BRANCHPOINT with value of the branch.

• Change the scripts/branch-names.sh script to refer to WildFly maintenance branches in jbossts/jboss-as repository.

• Change the scripts/hudson/narayana.sh script (function build_as or clone_as) which clones the WildFly maintenance repository to point to correct branch in context of the Narayana maintenance branch (e.g. 7_BRANCH) and change the git rebase to work against appropriate WildFly branch (e.g. 35.x).

• Verify the content of the build-release-pkgs.xml to contain the correct value of the tag property.

• Create the maintenance branch (of the same version) for jbosstm quickstarts (https://github.com/jbosstm/quickstart/) as well.

• Make sure autoReleaseAfterClose is set to false in root pom.xml. In fact maintenance branches are not supposed to be released to Maven Central, but only tagged and pushed to GitHub.

• If not already existing, please create a <MAJOR>.<MINOR>.next version in JIRA to use to target fixes for the new maintenance branch