Create a Test Deployment
Complete the following steps to create a test package deployment:
|
|
You can create a test package deployment for both, file-based packages and instruction-based packages.
|
1. From the left pane in ThingWorx Software Content Management, under the Packages section, navigate to > .
The Create Test Deployment page appears.
2. Ensure that the package that you want to test deployment for is displayed in the Selected Package field.
This field displays the last package that was created or the last package that was selected. If you want to test deployment for a different package, click
, and select the correct package from the
Find Packages page.
3. In the Deployment Name field, enter a name for the test deployment.
4. In the Deployment Description field, enter a brief description of the test deployment.
5. Under the
Optional Script Parameters section, click
to add
.lua script parameters. If you choose to modify the sample script that you used when you created the package, you need to add the appropriate parameters and values here. For more information about parameters of sample scripts, see
Sample Scripts for File-based Packages.
a. In the Parameter Name field, enter the name of the parameter.
b. In the Value field, enter the appropriate parameter value.
c. Click
to add the additional script parameter to the
Script Parameters list.
You can click
to delete the script parameter from the
Script Parameters list.
6. Click Next.
The Specify Target Assets for Testing page appears.
7. You can search for and select an asset by using one of the following options:
◦ Select individual assets:
1. Under the Select Individual Assets section, click Select Assets.
2. Use the available filters and click Search to display all the assets that match the filter criteria that you have set. Alternatively, click Clear to clear the asset search results.
3. If you want, click Save to save the search. In the Name field, enter an appropriate name for the search.
4. Click the check box next to the asset that you want to deploy the package to, and click Add Selected.
The asset is displayed in the Select Individual Assets table.
5. If you do not want to deploy the package to this asset, click
to delete the asset from the table.
◦ Select assets from a saved search:
1. Under the Select Assets from Saved Search section, select a saved asset search available in the Included Assets or Excluded Assets list.
By default, the All My Assets search is available.
| The Included Assets search allows you to select the assets that must receive the package and the Excluded Assets search allows you to select the assets that should not receive the package. |
2. Click
to add the assets from the selected search to the
Included Assets or
Excluded Assets table.
Or, you can click New Asset Search to create a new asset search. Enter appropriate information in the different fields, and click Save to save the search. Repeat this step to add multiple searches to the Included Assets or Excluded Assets table.
| If you want a search to be performed only after a user clicks Search on the Specify Target Assets for Testing page, complete the following steps: 1. In ThingWorx Composer, go to the TW.RSM.SFW.Thing.SoftwareUtils thing. 2. Under ENTITY INFORMATION, click Configuration. The Configuration for TW.RSM.SFW.Thing.SoftwareUtils page appears. 3. Under the General Settings section, select the DisableSearchOnMashupLoad check box. |
| Note the following points: • If the value of the isReporting property for a remote asset is true, then you can select and deploy a package to the asset. • If the value of the isReporting property for a remote asset is false, then even if you select and deploy a package to the asset, the deployment is stuck in the Pending state until the asset connects. |
8. Click Next.
The Start Test Deployment page appears.
9. Review the information on this page, and if required, complete the following actions:
◦ To view the assets on which the package will be deployed, click View target assets to go back to the View Target Assets of Test Deployment page. Ensure that all the target assets are present and click Back to return to the Start Test Deployment page.
◦ To modify the assets on which the package will be deployed, click View target asset searches to go back to the Specify Target Assets for Testing page. Select the appropriate asset and click Next.
10. Once you have confirmed that the test deployment is configured correctly, select the Confirm you intend to deploy this 'UNPUBLISHED' package immediately to the target assets listed above check box, and click Deploy.
The Track Test Deployment page appears. This page lists the test deployments that have been deployed for testing. Use the available filters to filter the packages that have been deployed for testing.
11. From the Deployments list, depending on your requirement, perform any of the following actions:
◦ Select a test deployment, and click
to view the
View Assets For Test Deployment page. Alternatively, double-click a deployment to view the
View Assets For Deployment page. This page provides information about the target assets that were included for the deployment with their individual deployment statuses.
◦ Click
to delete the selected deployment.
◦ Click Next to continue to the Access page.
