Use the TestStand Deployment Utility to specify and customize the files or directories you select to include in the deployment.
When you specify the source files for a test system on the Distributed Files tab of the deployment utility, the utility prompts you to analyze the source files before displaying them in the Distributed Files list. You must manually add certain types of files to the deployment. If you modify files after adding them to the deployment, click the Analyze Source Files button to re-analyze the files.
When you specify a TestStand workspace file, the Distributed Files list includes the workspace file, its contents, and the dependencies, which include all the TestStand projects in the workspace, all the sequence files in each of the projects, any code modules sequence files call statically, and any other files in the project. By default, the Distributed Files list does not include code module dependencies. However, if you used the System Source tab to specify a directory from which to deploy files, the Distributed Files list on the Distributed Files tab includes all the files from that directory and their dependencies. If you want to use the Distributed Files tab to change the file properties of a code module dependency, add the code module dependency to a TestStand project because the Distributed Files list includes all files in a TestStand project.
If the Distributed Files list includes files you do not want to include in the deployment, remove the checkmark next to the file or directory you want to exclude from the deployable image in the Source or Destination view.
Select a file or directory in the Distributed Files list and use the options in the File Properties section on the Distributed Files tab to customize how to include each file or directory in the deployable image and how the installer you build with the deployment utility for the deployable image operates on the files.
Enable the Include Without Processing Item or Dependencies option in the File Properties section on the Distributed Files tab to copy the selected file to the deployment image directory without any additional processing during the build.
|Note You must ensure the files work correctly without modifications. The deployment utility does not attempt to find or include any dependencies of the file during analysis.|
Use this technique in the following situations:
By default, the deployment utility includes only the files steps reference. Enable the Include All VIs in LabVIEW Project option in the File Properties section on the Distributed Files tab to add all the files in the selected LabVIEW project to the deployment so you can more easily modify the test system you deploy.
The options in the Installer Properties section on the Distributed Files tab apply only when you use the deployment utility to build an installer. These options do not affect the files in the deployable image directory.
Select a new directory from the Installation Destination ring control to change the destination for a file. Use the Destination view to modify the Installation Destination Subdirectory control to change the destination for all files in the directory.
Click the LabVIEW Options button on the Distributed Files tab to launch the LabVIEW VI Options dialog box, in which you can customize how the deployment utility saves VIs in the deployable image.
|Note You must have LabVIEW 2010 or later to use LabVIEW packed project libraries in TestStand.|
Using packed project libraries instead of VIs in a deployment offers the following advantages:
Click the Options button in the LabVIEW VI Options dialog box to launch the Packed Project Library Options dialog box, in which you can configure options for how the deployment utility builds LabVIEW packed project libraries, including the name of the packed library, the version number, the product name, the legal copyright statement, the company name, the internal name, and the description. You can also use LabVIEW to build packed project libraries.
The LabVIEW Development System installs vi.lib. Instrument drivers install VIs in instr.lib. Toolkits and third-party software install VIs in user.lib. Exclude dependencies from vi.lib, instr.lib, or user.lib from deployments when you deploy VIs that you expect others to edit, such as when you deploy VIs to another development computer or to a test station computer that includes the LabVIEW Development System, the TestStand Engine, a custom user interface, and a TestStand Custom Sequence Editor License so other developers can modify and redeploy test sequences.
Including VIs from vi.lib, instr.lib, or user.lib in a deployment you install on a computer that includes the LabVIEW Development System can cause the following issues:
Enable the Remove Unused VI Components option in the LabVIEW VI Options dialog box to decrease the size of a deployment by removing unused polymorphic VIs from the distribution. When you enable this option, you cannot edit code module VIs to include calls to the removed polymorphic VIs on the test station computer.
If you call VIs in the context of multiple projects, you can enable the Consolidate Files Shared By Projects option in the LabVIEW VI Options dialog box to consolidate all files in LabVIEW projects into one project to increase build speed and decrease disk usage for multiple projects that share common subVIs by making a single source distribution for every project. This optimization is not always possible as two projects might compile the same source VI differently, which can result in slower build times. If the deployment utility cannot consolidate all projects, the utility returns a warning that explains why consolidation is not possible and builds the distribution without consolidating the projects.
|Previous: Preparing Source Components for Deployment||Next: Creating Deployments|
Chapter 7, Effectively Using LabVIEW with TestStand, of the Using LabVIEW and LabWindows/CVI with TestStand manual