Microsoft iSCSI Software Target 3.3 Custom Installer Actions

  • Article

The Windows Logo Certification program requires that software installation packages (.msi files) document nonstandard installation behavior. This document describes custom actions that are implemented by the installer files for Microsoft iSCSI Software Target 3.3 and the iSCSI Initiator. These custom actions occur automatically, and they cannot be manually set by OEMs or end users.

ISCSI Software Target 3.3 installer custom actions

The following list describes the custom actions that are performed when the iSCSI Software Target 3.3 installer (iscsitarget.msi) runs.

  • CheckForReboot   Queries the installed local mount device to determine if a reboot is needed for iSCSI Software Target 3.3 to function.

  • CheckiSCSITargetIsInUse   Checks whether the iSCSI Software Target is in use (for example, if there are any open sessions). This is used during uninstallation to warn a user if there are open sessions.

  • CheckMUOptInState   Checks if the computer is currently opted-in for Microsoft Windows Update.

  • CheckSku   Checks the operating system SKU value.

  • CreateFirewallRules   Creates the firewall rules that are required for iSCSI Software Target 3.3 to function.

  • CreateFirewallRules.SetProperty   Sets the user interface (UI) level and the installation path properties that are used by the CreateFirewallRules custom action.

  • DoMUOptIn   Adds the Microsoft Windows Update service opt-in option if CheckMUOptInState returns a state of No, and the user chooses to opt-in through the UI.

  • HideCancelButtonCA   Hides the Cancel button when iSCSI Software Target 3.3 is uninstalling.

  • InitiateMUScan   Initiates a Microsoft Windows Update scan after iSCSI Software Target 3.3 is installed if the end user has configured Microsoft Windows Update for automatic updates (specifically, when wuauclt/detectnow is run).

  • InstallWTLMD   Installs the local mount driver.

  • InstallWTLMD.SetProperty   Sets the UILevel property for the InstallWTLMD custom action.

  • NoDowngrade   Displays an error message if a newer version of iSCSI Software Target is already installed on the computer.

  • RegisterClusterResource   Registers the cluster resources within the cluster service.

  • RegisterPerfCounters   Registers the iSCSI Software Target performance counters.

  • RegisterSnapshotEvtProvMOF   Registers the Windows Management Instrumentation (WMI) provider for the hardware snapshots.

  • RegisterWTProvMOF   Registers the WMI provider for iSCSI Software Target 3.3.

  • RemoveAppSetting   Removes the iSCSI Software Target application settings when iSCSI Software Target 3.3 is uninstalled.

  • RemoveFirewallRules   Removes the iSCSI Software Target firewall rules if iSCSI Software Target 3.3 is uninstalled.

  • RollbackCreateFirewallRules   Removes the iSCSI Software Target firewall rules if the iSCSI Software Target 3.3 installation is canceled or if setup terminates abnormally.

  • RollbackInstallWTLMD   Uninstalls the local mount driver if the iSCSI Software Target 3.3 installation is canceled or setup terminates abnormally.

  • RollbackRegisterClusterResource   Unregisters the cluster resources if the iSCSI Software Target 3.3 installation is canceled or setup terminates abnormally.

  • RollbackRegisterPerfCounters   Unregisters the iSCSI Software Target performance counters if the iSCSI Software Target 3.3 installation is canceled or setup terminates abnormally.

  • RollbackRegisterSnapshotEvtProvMOF   Unregisters the WMI provider for the hardware snapshots if the iSCSI Software Target 3.3 installation is canceled or setup terminates abnormally.

  • RollbackRegisterWTProvMOF   Unregisters the WMI provider if the iSCSI Software Target 3.3 installation is canceled or setup terminates abnormally.

  • SetCeipOptInOption   Sets the default opt-in option (Not opted-in) for the Customer Experience Improvement Program.

  • SetInstallDirNextPageCEIPOptIn   Enables the Customer Experience Improvement Program opt-in Wizard page to be displayed so that during installation, this option is presented after the Destination Folder page.

  • SetVerifyReadyPreviousPageAsCEIPOptIn   Sets the Customer Experience Improvement Program Opt-in Wizard to appear before the Ready to Install Microsoft iSCSI Software Target page.

  • SetVerifyReadyPreviousPageAsMUOptIn   Sets the Microsoft Windows Update opt-in Wizard page to appear before the Ready to Install Microsoft iSCSI Software Target page.

  • UnInstallWTLMD   Uninstalls the local mount driver if iSCSI Software Target 3.3 is uninstalled.

  • UnregisterClusterResource   Unregisters the cluster resources if iSCSI Software Target 3.3 is uninstalled.

  • UnRegisterPerfCounters   Unregisters the iSCSI Software Target performance counters if iSCSI Software Target 3.3 is uninstalled.

  • UnregisterSnapshotEvtProvMOF   Unregisters the WMI provider for the hardware snapshots if iSCSI Software Target 3.3 is uninstalled.

  • UnregisterWTProvMOF   Unregisters the WMI provider for iSCSI Software Target 3.3.

  • WixUIPrintEula   Enables the user to print the Microsoft Software License Terms during installation.

iSCSI Software Target Client 3.3 installer custom actions

The following list describes the custom actions that are performed when the iSCSI Software Target Client 3.3 installer (iscsitargetClient.msi) runs.

  • CheckForPreviousUpdatePackages   Checks if there are any Volume Shadow Copy Service (VSS), Virtual Disk Service (VDS), or high-performance computing (HPC) hardware provider update packages previously installed on the system.

  • CheckMUOptInState   Checks if the computer is currently opted-in for Microsoft Windows Update.

  • CheckServiceAccount   Validates the service account credentials that are stored in the Windows Installer properties SERVICEUSERNAME and SERVICEPASSWORD, and then checks the Windows Installer property IsServiceAccountValid.

  • ClearServiceAccount   Clears the data in the Windows Installer properties SERVICEUSERNAME and SERVICEPASSWORD.

  • CreateClientFirewallRules   Creates the iSCSI Software Target client-side firewall rules that are required for iSCSI Software Target 3.3 to function.

  • CreateClientFirewallRules.SetProperty   Sets the UILevel and installation path properties that are used by the CreateClientFirewallRules custom action.

  • DoMUOptIn   Performs the Microsoft Windows Update opt-in.

  • HideCancelButtonCA   Hides the Cancel button when iSCSI Software Target Client 3.3 is uninstalling.

  • InitiateMUScan   Initiates a Microsoft Windows Update scan by running wuauclt/detectnow at the end of setup if the user has configured the computer so that Windows Update is enabled.

  • RegisterVdsHWProv   Registers the iSCSI Software Target VDS hardware provider.

  • RegisterVssHWProv   Registers the iSCSI Software Target VSS hardware provider.

  • RemoveClientFirewallRules   Removes the iSCSI Software Target firewall rules on the client if iSCSI Software Target Client 3.3 is uninstalled.

  • RollbackCreateFirewallRules   Removes the iSCSI Software Target firewall rules on the client if the iSCSI Software Target Client 3.3 installation on the client is canceled or setup terminates abnormally.

  • RollbackRegisterVdsHWProv   Unregisters the iSCSI Software Target VDS hardware provider if the iSCSI Software Target Client 3.3 installation on the client is canceled or setup terminates abnormally.

  • RollbackRegisterVssHWProv   Unregisters the iSCSI Software Target VSS hardware provider if the iSCSI Software Target Client 3.3 installation on the client is canceled or setup terminates abnormally.

  • UnregisterVdsHWProv   Unregisters the iSCSI Software Target VDS hardware provider if iSCSI Software Target Client 3.3 is uninstalled on the client.

  • UnregisterVssHWProv   Unregisters the iSCSI Software Target VSS hardware provider if iSCSI Software Target Client 3.3 is uninstalled on the client.

  • ValidateServiceAccount   Determines whether the service account credentials that are stored in the Windows Installer properties SERVICEUSERNAME and SERVICEPASSWORD are valid.