Windows application component types consist of three types:
A component of this type represents a COM+ application. COM+ applications are treated as a unit. The settings and content are installed as a group.
When you browse for a COM+ application, the browser provides an alphabetical list of COM+ applications on the target system.
You can select a single COM+ application to be checked in. COM+ applications have no children and cannot be expanded..
COM+ applications are exported into a Microsoft Windows Installer (MSI) file using the COM+ Admin SDK.
The COM+ Application is re-exported on the target system as an MSI file and compared against the MSI file used to install the application. The software will only indicate that there were differences, but will not indicate the details of the differences.
If a COM+ application with the same name is already installed on the target system and running as a service, the existing application is stopped along with any running dependent services. The COM+ application will then be deleted from the COM+ catalog.
The new COM+ application is installed using the COM+ Admin SDK.
To start the COM+ application the user will have to use the startApp call step to manually start the COM+ application.
The COM+ application is uninstalled using the COM+ Admin SDK.
Action |
Condition |
Result |
---|---|---|
Install |
COM+ Application already exists with the same name and either cannot be stopped or dependent services cannot be stopped. |
Installation fails |
Uninstall |
MSI file used for installation is no longer available |
Uninstallion fails |
Install or Uninstall |
Remote Agent does not have administrator privileges |
Installation or Uninstallation fails |
Name |
Parameters |
Description |
---|---|---|
startApp |
appName – Full name of the COM+ application. |
Starts the COM+ application if it is run as a service |
stopApp |
appName – Fill name of the COM+ application to stop. |
Stops the COM+ application and all dependent services |
stopRouter |
N/A |
Stops the COM+ Routing services |
startRouter |
N/A |
Starts the COM+ Routing services |
installAsUser |
rsrcSrcPath – Name of the COM+ application rsrcInstallPath – Path to the *.msi file representing the application userID – User who is going to run the application password – Password of the user |
Enables installation of a COM+ application that runs as a particular user |
This component type represents a COM file.
To choose a file for this component type, select a *.ocx or *.dll file from the file browser.
The COM component is compared as a binary file against the file used during installation. The software indicates when there are differences, but does not provide details about the differences.
The Regsvr32 utility is called to register the COM components in the DLL using the following command line:
regsvr32.exe /s file path |
The Regsvr32 utility is called to unregister the COM components in the DLL using the following command line:
regsvr32.exe /s /u <file path> |
After the DLL is unregistered, it is removed from the target system.
Action |
Condition |
Result |
---|---|---|
Install |
The supplied .dll or .ocx file does not contain COM components |
Installation fails |
Uninstall |
The supplied .dll or .ocx file does not contain COM components |
Uninstallation fails |
A component of this component type includes a silent Microsoft Installer (MSI) file.
To choose a file for this component type, select a *.msi file from the file browser.
The Microsoft Windows installer service is called on the MSI file to import it into the target system with the following command:
misexec /qn /i file path |
The Microsoft Windows installer service uninstall is called on the MSI file used during installation to uninstall the package using the following command:
msiexec /qn /x file path |
After msiexec finishes, the MSI file is removed.
Action |
Condition |
Result |
---|---|---|
Install |
The supplied *.msi file is not a proper Microsoft Windows installer file. |
Installation fails. |
Install |
The agent does not have proper permissions to run installations |
Installation fails. |
Uninstall |
The package has already been uninstalled |
Uninstall fails |