Build Status Tab

Use the Build Status tab to monitor progress and log information when analyzing files to include in a full or patch deployment and when building a full or patch deployment image and installer . The utility does not save the status log file until you click the Save Log button. National Instruments recommends that you save build status log files, especially for deployments that you might patch, so you can compare changes between different versions of the deployment.

The Build Status tab contains the following options:

• Abort —Stops the deployment build process. This button is dimmed when the deployment utility is not performing a build.
• Build State —Displays the current state of the deployment build or displays information about the previous deployment build.
• Save Log —Exports an XML file that contains all the information you need to rebuild the log or a text file that contains most of the information the Status Log displays. Select Technical Support Report from the Save Log button pull-down menu to create a file that you can send to National Instruments to help diagnose issues related to the deployment and installer creation process.
• Clear Log —Removes the data from the Status Log control.
• Status Log —Contains real-time information about the deployment process, such as when analysis starts and completes, when the utility processes files, and when the deployment build starts and completes. When the deployment build completes, review the status log for the following types of warning or error messages the utility returns:
  • Information —Issues that might be a warning or error that you cannot resolve before creating the deployment and must verify in the final deployment, such as steps that contain expressions the utility was unable to resolve.
  • Warning —Issues that do not break the deployment creation process but might cause incorrect behavior in the final deployment, such as configuring a step with an absolute path.
  • Error —Issues that you must resolve before the deployment creation process can complete successfully.
  Click the + icon to expand a message for additional information, such as system information, source path to destination path transformations, build summary, and installer details. Click the Status Log and press <Ctrl+F> to launch the Find option, in which you can enter text you want to search for. You can use the arrow pull-down menus in the Severity, Code, Message, and Additional Details column headings of the Status Log or the Status Log context menu to display only messages that match a certain filter criteria. Click the arrow pull-down menu in the column headings to filter the Status Log to display only the items you select from the pull-down menu. Select (Custom) to launch the Custom AutoFilter dialog box, in which you can customize the information to display. You can also use the Severity, Code, Message, and Additional Details column headings of the Status Log to change the display order of the data. Click the column heading to order the data in that column in descending order. Click the column heading a second time to order the data in ascending order. Click the column heading a third time to restore the original order by time. The Additional Details column includes an icon for messages that display more information in the Additional Details tab in the lower right corner of the Build Status tab. Use the Status Log context menu to group and display messages by category in expandable rows. For messages that reference a file, you can also use the context menu to navigate to the file in Windows Explorer or on the Distributed Files tab or to open the file in the application associated with the file extension. Right-click the Status Log to launch the context menu, which contains the following options:
  • Group by —Contains the following options:
    • Severity —Groups messages by severity level, such as process, warning, and error. Grouping messages by severity level might display the same message multiple times because the issue occurs in different phases during deployment or the Status Log includes information for multiple deployments.
    • Code —Groups messages by numeric code value.
    • Message —Groups messages by the text the message contains. Grouping messages this way might display the same message multiple times because the issue occurs in different phases during deployment or the Status Log includes information for multiple deployments.
    • Phase —Groups messages by the deployment creation phase, such as setup, analysis, and cleanup.
    • Deployment Version —Groups messages by the value of the Deployment Version option on the Mode tab of the utility.
    • Remove Grouping —Displays all messages in default order.
  • Go To Location —Contains the following options for messages that include a path or file:
    • Open in <application> —Opens the file using the application associated with the file extension.
    • Open in Explorer —Locates the file in Windows Explorer.
    • Select in the Files View —Selects the file on the Distributed Files tab of the utility.
  • Copy as XML —Copies the full content of the message in XML format.
  • Copy —Copies most of the content of the message in text format.
  • Expand all —Expands all messages that include additional information.
  • Collapse all —Collapses all messages that include additional information.
• Help Tab —Provides information about the most common errors and warnings, such as why the error or message occurred and guidance to help you resolve the issue.
• Additional Details —When the Additional Details column of the Status Log includes an icon, this tab displays the calling hierarchy of VIs for relevant messages.

See Also

Deploying TestStand Systems

TestStand Deployment Utility Error Codes