RT Apply Target Disk Image VI

Owning Palette: RT Utilities VIs

Requires: RT Module

Replaces the entire contents of the primary hard drive on the RT target with the files in the target disk image you specify.

By default, this VI restarts the RT target into normal running mode. If there was a startup application deployed to the original target from which the disk image was created, the target at target address starts running the startup application after this VI completes.

Details  

	target address specifies the IP address or DNS name of the target.
	image file path specifies the local path of the disk image to load onto the RT target.
	error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.
	restart after imaging specifies whether to restart the target after applying the target disk image. If this input is FALSE, the RT target remains in install mode after this VI runs. If this input is TRUE, the RT target restarts into normal running mode.
	file blacklist specifies an array of file paths to exclude from the target image. To enable filtering through regular expressions, the data type of this control is an array of strings rather than an array of paths.
	IP settings after restart returns the IP settings of the RT target. If the IP settings change upon restarting, this output returns the new IP settings that take effect after the target restarts. If the previous IP address of the target is in use by another device on the network and the target is configured to use DHCP, the IP address of the target might change upon restarting. IP address is the IP address of the networked device. DNS name is the network DNS name of the target. subnet mask is the bit mask used to identify the subnet in which the target resides on the network. gateway is the network gateway used by the target. DNS server is the domain name server used by the target.
	error out contains error information. This output provides standard error out functionality.

RT Apply Target Disk Image Details

If you need to perform additional configuration operations, set restart after imaging? to FALSE. When restart after imaging? is FALSE, IP settings after restart returns an empty cluster. When restart after imaging? is TRUE, this VI waits to finish until the real-time operating system has started and can communicate over the network. However, because the RT target requires additional time to load LabVIEW, drivers, and startup applications, you might need to allow additional time before using the target.

To avoid IP conflicts, this VI attempts to preserve the existing IP settings of the target.

This VI does not support the following use cases.

• Disk images based on RT targets with multiple operating systems or multiple hard disk partitions
• Disk images created using an RT Desktop PC Utility USB drive
• Disk images created from a target with a model code different from the model code of the target at target address

Note  You can use the RT Get Target Information VI to find the model code of an RT target.