Rolling out an internal release in a staged mode

If you want a minimal disruption to the production environment and perform a strategic upgrade, you can roll out an internal release through a staged rollout upgrade approach.

Before you begin

  • While rolling out an internal release in a staged environment, follow the Development guidelines to ensure that the Sterling Order Management System Software supports multiple versions running on the same database.
  • In release 9.5 (and later), a new properties file called versioninfo.properties_<module-prefix>_ext is defined at the JVM level to store the version information. For example, for Sterling Order Management System Software its would be versioninfo.properties_ysc_ext. During an internal release, ensure that you add an appropriate version number to the <Install>/properties/versioninfo.properties_ysc_ext> file to indicate the correct version number. That is, for all the internal releases, a fifth digit version number must be added to identify the version level.

    For example, for the development release 10.0, the fix pack release would be 10.0.x.y.z. Then, set the internal release number as 10.0.x.y.z.p. Here, p acts as a fifth digit version identifier and indicates that it is an internal release.

About this task

Perform the following steps to roll an internal release in a staged mode:


  1. Make a copy of the older version which serves as the base for the new version roll out. Once the copy is successful, there would be two identical versions present on the same database.
  2. Install the internal release.
    Note: Ensure that you do not update the version table.
  3. Add the new feature configuration.
    Note: Ensure that the new configuration does not modify the existing data.
  4. Build the EAR and deploy.
    Note: When the internal release has been rolled out and you are comfortable with the functioning of the new updates, you can choose to phase out the older version by executing the following script {runtime}/bin/ fullRollOutDataMigration.cmd/sh. from the version that is set as the base.