Redeploy UAT deployment on Existing Database

The following sections outline redeploying UAT Deployments on top of the existing database.

Determine the Innovator Deployment Name

The following steps outline the process of determining the Aras Innovator Release Name for the deployed Aras Innovator Instance that the user wants to update:

  1. On Azure DevOps, click Wiki.

  1. Under the Environment Information section, select UAT.

Copy the release name under the Name Tab in UAT section.

Copy the name; it will be useful during Deploy Pipeline.

Determine Deployment Package

Determine the Deployment Package Version with the customization the user wants to deploy to the previously deployed Aras Innovator. This can be done in the following two ways:

  • Obtain the Build Number of the CI Pipeline corresponding to the version of the customization the user wants to deploy:
    1. In Azure DevOps, go to Pipelines.

  1. Select ContinuousIntegration and select the necessary CI Pipeline.

Copy the Build Number; it will be useful during Deploy Pipeline.

  • Obtain the Name and Version of the Deployment Package Name:

Find a stable version of the Deployment Package Name and Deployment Package Version.

It can be found in ContinuousIntegration Pipeline logs. Open the Publish Nuget Package to {ProjectName}-Artifacts feed and find the line similar to the following screenshot:

For example:

Publishing package: custom_deployment_package_name, version: 1.0.202502263-b-17641

Run Deploy Pipeline with Update strategy

The following steps outline the process of running the Deploy Pipeline with Update Strategy:

  1. Navigate to the Deploy Innovator Pipeline.
  2. Select Run Pipeline.
  3. Select the appropriate Branch/Tag.
  4. Choose Deployment type.

  1. To choose the required Deployment Package, use one of the options below:
  • Click Resources in Advanced options. Search for the correct CI Pipeline with the code changes that need to be applied to Aras Innovator, which is obtained in the section Determine Deployment Package, and then click the Use selected to run button to apply.

  • Click Variables in Advanced Options and specify deployment_package_name and deployment_package_version with the values obtained in the section Determine Deployment Package.

  1. Click Variables in Advanced options.

  1. Add the following Variables:
NameValue

personal_access_token

Enter the PAT token in case of deployment to UAT, Staging, or PROD.

innovator_release_name

Enter the Release Name of the currently deployed Aras Innovator that needs to be updated.

setup_instance_strategy

Enter Update.

cluster_index

Enter a cluster identification value for deployment. This is especially helpful when deploying multiple Vaults across different geographical clusters. Typically, 01 suffices as the default value.

install_conversion_server

The default value is true.

The setup_instance_strategy can have the following values:

  • Deploy: Enables the creation of a new Deployment. This is the default value of this Variable for Deployments to SIT environment.
  • Update: Enables updating an existing Deployment. This is the default value of this Variable for Deployments to UAT, Staging, and PROD environments.
  • RollingUpdate: This update type should be used when only Сode Tree changes should be applied. The Pipeline will fail if there are any changes in AML Packages.
  1. Click the Run button.

The outcome of this operation will deploy the new changes onto the existing database and Aras Innovator instance, matching the innovator_release_name with setup_instance_strategy set to Update.