Component Type: COM+ Application (N1 Service Provisioning System 4.1 User's Guide)

N1 Service Provisioning System 4.1 User's Guide

Component Type: COM+ Application

Resource type is used to represent COM+ Applications. COM+ Applications are treated as a monolithic unit. The settings and content are installed as a group.

Browsing

Table 5–16 COM+ Application Browser Behavior


Root Path	List of COM+ Applications on the system
Delimiter	N\A
Ordering	Alphabetical based on application name.
Selection Type	User can single select an individual COM+ Application for check in. COM+ Applications have no children and cannot be expanded.
Sample Path	FM Stocks
Filters	None

Exported/Internal File Format

COM+ Applications are exported into a Windows Installer File (*.MSI) using the COM+ Admin SDK.

M-I Difference

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. M-I diff will only indicate that there were differences (i.e. the two binary files are different) but will not indicate the details of the differences.

Installation

If the COM+ Application with the same name is already installed on the target system and running as a service then it is stopped along with all of its 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 startApplication call step to manually start the COM+ application.

Un-Install

The MSI used to install the COM+ Application is used to uninstall the COM+ Applications using the following command line:

msiexec /qn /x <path to msi file>

Once this is complete the msi file is removed from the target system.

Error Conditions

Table 5–17 COM+ Application Error Conditions


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	Uninstall fails
Install/Uninstall	Remote Agent does not have administrator privileges	Install/Uninstall fails

Extended Control Procedures

Table 5–18 COM+ Application Extended Control Procedures


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 whom is going to run the application password: Password of the user	Allows installation of a COM+ application which runs as a particular user.