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 |