Skip to content

Versaa Release Process & Version Management

Release Packaging (Versaa 1.1, Update 44+)

From Update 44 onward the Versaa 1.1 release mechanism changed significantly:

Before Update 44 From Update 44
Package contained a base image + all prior updates applied sequentially Package is a flat snapshot — the installer goes directly to the target update level
Customers could opt out of individual updates (if no dependency) No selective update opt-out — download the exact version you want
Update 43 download ~2 GB Update 44+ download <100 MB (compression improvement)

Workflow step plugins are now released separately from the core product. Plugin update numbers are independent of product update numbers (e.g. a plugin could be at update 55 while the product is at update 48 — you are still considered to be on Versaa 1.1 Update 48).

Practical implication: To roll back to a prior update, download that specific update package from Aareon — you cannot apply update 44+ packages in reverse-incremental fashion.

Identity Token Service (ITS) — Versaa 1.1

The Identity Token Service replaces Versaa's proprietary authentication system with OAuth2 / industry-standard auth.

What it provides

  • Modern security — OAuth2 protocol, replaces the old Versaa-proprietary auth
  • Single Sign-On (SSO) — a user logged into the Information Portal does not need to re-authenticate in Management Studio
  • Third-party SSO extensibility — the OAuth2 architecture allows integration with Azure AD and other OAuth2 identity providers

Deployment requirement

ITS must be publicly accessible (internet-facing). Two options: 1. Aareon API Gateway in use → install ITS on the API Gateway server; ITS needs access to the Versaa database 2. No API Gateway → amend your firewall to allow external traffic through to ITS

Both options require a technical conversation with Aareon Technical Team before upgrade.

Full technical guide: Versaa 1.1 Technical Guide.pdf — available from Aareon Atlassian Wiki page 4850376

Environment Audit Tool

A standalone tool for auditing Versaa environments (forms + workflows). Download from the Aareon downloads page.

Key capabilities:

Feature Detail
Environment connection Connects to Dev/Test/Live environments and extracts data
Forms data Form name, active version, last modified by/when, supported platforms, sub-task items
Workflow data Workflow name, active version, last modified, steps, triggers, dependencies
Issue detection Highlights anomalies — obsolete steps, configuration errors
PDF reports Customisable PDF reports for forms and/or workflows (shareable)

Useful for: auditing what's deployed to each environment, spotting stale workflows, generating documentation for sign-off.

Release Notes