From a51132c282bbe9f89ef35a4b867e9b4c502272f7 Mon Sep 17 00:00:00 2001 From: Jon Bartels Date: Tue, 7 Apr 2026 19:41:28 -0400 Subject: [PATCH 1/3] Release HOWTO Signed-off-by: Jon Bartels Signed-off-by: Jon Bartels <--global> --- RELEASE-HOWTO.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 RELEASE-HOWTO.md diff --git a/RELEASE-HOWTO.md b/RELEASE-HOWTO.md new file mode 100644 index 000000000..77d12a865 --- /dev/null +++ b/RELEASE-HOWTO.md @@ -0,0 +1,63 @@ +# HOWTO Release Open Integration Engine + +## Audience + +This document is primarily meant to be referenced by OIE maintainers. This document is meant to help maintainers perform releases with a consistent process. This document may be useful to forks who want to release in a similar way. This document should also be updated with PRs that improve or change the release process. + +## Task Overview + +These are the tasks to perform a release: +1. Update version numbers +2. Build the installer +3. Sign the installer +4. Release the installer and artifacts as RC +5. Fix showstopping bugs. Log all others. +5. Release the installer and artifacts as a final release + +These tasks are ordered. They support the direction of the maintainers and steering committee to release regularly. + +## Task Details + +### Update Version Numbers + +Edit the version number in [mirth-build.properties](server/mirth-build.properties) to indicate the release version. + +Execute an automated build and verify that the version is correctly populated. It will appear in various properties and XML files for the application. The old version should be replaced. + +### Build The Installer + +You will need Install4J installed. OIE has an Install4J license available for maintainers. Forks or independent builds will need to acquire their own license. + +Review the [Install4J specific readme.](tools/install4j/readme.html) + +Run Install4J and load the [Install4J configuration for OIE](tools/install4j/oie-installer-config.install4j) + +### Sign The Installer + +You will need a code-signing certificate. OIE has sponsors with these certificates who sign our builds. + +After signing the installer and artifacts ensure that OIE executables, services, and JARs have the expected signature and that it is valid. + +### Publish Installer and Artifacts for Release Candidate + +The installer and artifacts should be published to the [OIE Engine github Releases Section](https://github.com/OpenIntegrationEngine/engine/releases). + +### Bug Report Period + +Elicit feedback from the maintainers and the greater OIE community. Listen to feedback and document it. + +Showstopping bugs should be recorded as issues in the current release milestone and worked on promptly. + +Bug reports that are not showstoppers should be recorded and planned following our typical processes. + +### Publish Installer and Artifacts for Final Release + +Generate the installer and build artifacts for the final release following the same version update, build, and signing process. + +Review the artifacts with the maintainers. + +Collaborate with the OIE steering committee for social media announcements, website updates, etc. + +Publish the releases to the [OIE Engine github Releases Section](https://github.com/OpenIntegrationEngine/engine/releases). + + From 2b5fa499a7b27bf56d9acaf7435703d254f9fa40 Mon Sep 17 00:00:00 2001 From: Jon Bartels Date: Thu, 23 Apr 2026 10:26:10 -0400 Subject: [PATCH 2/3] Update RELEASE-HOWTO.md Improve version number cange with a link to a reference PR Signed-off-by: Jon Bartels --- RELEASE-HOWTO.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASE-HOWTO.md b/RELEASE-HOWTO.md index 77d12a865..7eaa42fb2 100644 --- a/RELEASE-HOWTO.md +++ b/RELEASE-HOWTO.md @@ -20,7 +20,7 @@ These tasks are ordered. They support the direction of the maintainers and steer ### Update Version Numbers -Edit the version number in [mirth-build.properties](server/mirth-build.properties) to indicate the release version. +Edit the version number in several files to indicate the release version. Follow (this PR)[https://github.com/OpenIntegrationEngine/engine/pull/301] as a guide. Execute an automated build and verify that the version is correctly populated. It will appear in various properties and XML files for the application. The old version should be replaced. From 18253fab05777fa30f125e7bf4182721d0db6880 Mon Sep 17 00:00:00 2001 From: Jon Bartels Date: Fri, 1 May 2026 13:52:51 -0400 Subject: [PATCH 3/3] Update RELEASE-HOWTO.md Add tables showing release testing matricies Signed-off-by: Jon Bartels --- RELEASE-HOWTO.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/RELEASE-HOWTO.md b/RELEASE-HOWTO.md index 7eaa42fb2..0a1172971 100644 --- a/RELEASE-HOWTO.md +++ b/RELEASE-HOWTO.md @@ -50,6 +50,45 @@ Showstopping bugs should be recorded as issues in the current release milestone Bug reports that are not showstoppers should be recorded and planned following our typical processes. +Ask for volunteers to test some common paths and combinations for OIE. + +OS and DB combinations: + +|OS|DB| +|---|---| +|Windows|Postgres| +|Windows|MS SQL| +|Windows|Oracle| +|Windows|MySQL/Maria| +|Windows|Derby| +|Mac|Postgres| +|Mac|MS SQL| +|Mac|Oracle| +|Mac|MySQL/Maria| +|Mac|Derby| +|Linux|Postgres| +|Linux|MS SQL| +|Linux|Oracle| +|Linux|MySQL/Maria| +|Linux|Derby| + +Install and Upgrade paths: + +|OS|Installer|New Install or Upgrade| +|---|---|---| +|Windows|EXE|New| +|Windows|EXE|Upgrade| +|Windows|TAR|New| +|Windows|TAR|Upgrade| +|Mac|EXE|New| +|Mac|EXE|Upgrade| +|Mac|TAR|New| +|Mac|TAR|Upgrade| +|Linux|EXE|New| +|Linux|EXE|Upgrade| +|Linux|TAR|New| +|Linux|TAR|Upgrade| + ### Publish Installer and Artifacts for Final Release Generate the installer and build artifacts for the final release following the same version update, build, and signing process.