How to release openHAB

Follow these steps if you want to release a new version of openHAB. Later we plan to leverage the Maven Release Plugin to facilitate these steps.

1. Pull the latest state from the repository into a fresh and empty directory

    git clone [email protected]:openhab/openhab.git
   

2. Open a command-line and go to the openhab directory

3. Set project version to release version with the Tycho Versions plugin

    export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=1024m"; mvn -P prepare-release initialize -DnewVersion=1.x.0
   

4. Execute a Maven build

    mvn -P deploy clean deploy -Drepo.id=cloudbees-public-release-repo -Drepo.url=dav:https://repository-openhab.forge.cloudbees.com/release/1.x.0 -Dp2.repo.dir=p2 -Dapt.repo.dir=apt-repo
   

5. Install and extensively test the created binaries

6. Commit the changed files

    git commit -a -m "prepare for 1.x.0 release"
   

7. Create a release tag with pattern v<version>

    git tag v1.x.0
   

8. Increment to next development version

    mvn -P prepare-next-snapshot initialize -DnewVersion=1.y.0.qualifier
   

9. Execute a Maven build with goals clean verify to assure that everything builds

    mvn clean verify
   

10. Commit the changes

     git commit -a -m "increment to next development version 1.y.0"
    

11. Push the changes including the tag to the server

     git push origin master --tags
    

12. Switch to the root directoy of openHAB

Manual Steps to walk through after the Release-Build

• check if start.sh and start_debug.sh has been unpacked with correct file permissions (0755)
• Issue a rough Smoke-Test (unpack runtime and demo, start runtime, access Classic-UI)
• check if Designer (for at least xxx and Windows) works
• upload deb and p2 Repository
• add new bindings to http://www.openhab.org/features-tech.html

Upload the deb Repository to bintray

• open a web browser go to the bintray openHAB organisation, step into the apt-repo repository, add a new Version to the openhab package: e.g. 1.7.0.RC2
• open a command-line and go to the local apt-repo directory
• execute the /distribution/src/deb/bintray-upload-debs.sh script from the repository
• the first argument is your bintray username
• the second argument is your bintray api key
• the third argument is the openHAB version
• the fourth argument is the distribution name. Use:
  • "stable" for releases
  • "testing" for release canditates
  • "unstable" for snapshots
• Examples

sh bintray-upload-debs.sh theoweiss 9999999999999999 1.7.0-RC2 testing

sh bintray-upload-debs.sh theoweiss 9999999999999999 1.7.0 stable

• open a web browser go to the bintray openHAB organisation, step into the apt-repo and publih the files

Channels to inform about the new Release

1. News-Section on index.html
2. Google-Group
3. Twitter
4. Google+ Page
5. Google Community
6. KNX-User-Forum

to be continued …