Patching Deployments
- Updated2025-03-28
- 4 minute(s) read
Patching Deployments
Use the TestStand Deployment Utility and follow the same process NI recommends for creating a full deployment to create or patch deployments and to build installers for patch deployments from an existing TestStand 2013 or later deployment specification file (.tsd).
- You cannot create a patch deployment from a TestStand 2012 or earlier .tsd file because the file does not include information required to create a patch. You can recreate a new full deployment in TestStand 2013 or later based on the TestStand 2012 or earlier .tsd file. You can then create patch deployments from the TestStand 2013 version of the .tsd file.
- Once you create the full deployment, you must save the .tsd file and the installer for the deployment to create a patch deployment and installer.
For MSI-based installer deployments, you can use patch deployments to update individual files, to add features and add components to features, to return files to a known state, and to include or exclude updates to NI drivers or the TestStand Runtime in a deployed test system. You can also exclude new or modified files from a patch deployment, but you cannot remove files from a deployed system on a test station computer. Patch deployments typically are smaller in size than full deployments and might take less time to create on the development computer.
For package based deployments, you can use patches to include newly required drivers and components, and include updates to components in the deployment. Package based deployments do not support updating individual files through a patch deployment.
You can create a full deployment at any point during the patch deployment creation process. When you change to full deployment mode, options in the deployment utility might change as well. In most cases, the full deployment will be larger and take longer to download and install than a patch deployment.
Creating Cumulative Patch Deployments
By default, the deployment utility creates a cumulative patch deployment that depends on the previous full deployment and includes all the files that differ from the full deployment version of the file. If you make changes to the test system after you create and install a patch deployment on a test station computer, you can create a new patch deployment to include all the changes since the previous full deployment, including the changes in the first patch deployment you created. The newer installer for the patch deployment uses the same upgrade code but a later version number than the previous installer for the patch deployment to upgrade, or replace, the previous patch deployment on the test station computer. You can also create to control the installation order of patch deployments and to include only files modified since a previous patch deployment. The following figure illustrates the process of creating replacement or dependency patch deployments that install serially.
Creating Dependency Patch Deployments from Baseline Patch Deployments
You can create a new, dependency patch deployment from a previous, baseline patch deployment instead of from a full deployment to enforce the order in which to install patch deployments and to minimize the size of a new patch deployment by including only the files that differ from the previous baseline patch deployment version of the file, as shown in the previous figure. When you build an installer for a dependency patch deployment, the deployment utility adds installer launch conditions to enforce installing patch deployments in the correct order.
As the number of patch deployments you create grows, consider creating a new full deployment or a baseline patch deployment.
You must designate a patch deployment as a baseline patch deployment before you create a dependency patch deployment by clicking the Make Baseline Patch Deployment button on the Mode tab of the deployment utility. To create a dependency patch deployment, enable the Depend on previous Baseline Patch Deployment option on the Mode tab of the TestStand Deployment Utility.
Because the deployment utility discards old data after you create a deployment, TestStand supports only one baseline patch deployment at a time, and you can create a baseline patch deployment only from the most recent patch deployment you created. If you create another baseline patch deployment, you can no longer depend on the previous baseline patch deployment. Creating a new deployment also erases data of previous patch deployments that you do not designate as baseline patch deployments.
In This Section
Related Information
- Deployment Process Overview
- Including Modified Files in a Patch Deployment
- Adding New Files to a Patch Deployment
- Including Unmodified Files in a Patch Deployment
- Including NI Drivers or the TestStand Runtime in a Patch Deployment and Installer
- Excluding New or Modified Files from a Patch Deployment
- Upgrade Codes That Affect MSI-based Installer Behavior
- Creating Deployments
- Differences between Patch Deployments and Full Deployments
- Differences between Standard Mode and Manual Mode
- Creating Independent Patch Deployments
- Limitations of Patch Deployments