ATTENTION: BREAKING CHANGES
Stay informed before upgrading. Review the release notes for the desired version to identify potential breaking changes.
Breaking changes can also be viewed by using the Upgrade Validator Accelerator. It is recommended to use the scanner before upgrading. The scanner only shows breaking changes for v9.0 and above.
Breaking changes can also be viewed by using the Upgrade Validator Accelerator. It is recommended to use the scanner before upgrading. The scanner only shows breaking changes for v9.0 and above.
Back Up Before Proceeding
Before continuing with any update, the following should be backed up to avoid potential errors during the process:
- Database and File System - make a note of the DB Server and DB Name
- Settings.xml - found at C:\Program Files\Decisions\Decisions Server
- Keys.dat - found at C:\Program Files\Decisions\FileStorage\Primary\Settings
- FileStorage Folder - found at C:\Program Files\Decisions\
- FileStorage Settings (for Containerized Environments) - /opt/decisions/data
Overview
Throughout a major version release (for example, v9), additional minor releases (such as v10.2 or v10.1.3) are periodically released to address new features, bug fixes, and security and stability issues within the platform.
In such instances, Decisions Installations of a matching major version can be updated using DecisionsServerInstaller.exe.
Upgrading a Clustered Environment:
- IIS-hosted: Turn OFF the Decisions Services on all the Nodes. To do so, run
iisreset/stopfrom the Command Prompt/PowerShell as Administrator. - Self-hosted: Turn OFF the Decisions Services on all the Nodes. To do so, Stop the Decisions Services from the Windows Services.
- For more information on upgrading a containerized environment, please see: Decisions Container.
- Follow the given steps and upgrade the nodes one after another. Ensure you upgrade the second node only after the first node's upgrade is completed and the service is running.
Prerequisites
- Pre-existing major version installation.
- When running a Self-Hosted environment, IIS (Internet Information Systems) must be stopped via the Stop action; this prevents potential Port conflicts in the update process.

Example
- From the local file system, right-click DecisionsServerInstaller.exe and select Run as administrator.

- From the Decisions Installer, click UPDATE. If desired, check the Change Settings on the Update box.

- Read and agree to the License Agreement by checking the I accept terms of the License Agreement box, then click Next.
- Overwrite the configurations from the Settings window to the File Storage screen as desired (per Installation Guide), or leave the previously utilized configurations and click through each window via the Next button.
Note that these screens will only appear if Change Settings on Update was previously enabled.
- Review and correct any System Requirements before proceeding with Next.

- Review the settings and summary on Review Install Options. Then, click Next.

- The Installer will download and install the most recent Minor Version of the currently installed major version; click Show Details to view the progress of the update process.
To stop the upgrade, click Cancel, then exit the Installer. - Once the minor version update concludes, click Finish to exit the Installer.
If desired, enable Launch Decisions Portal to open the login screen after clicking Finish..png)