[an error occurred while processing this directive] Install COM+ Application Proxies

[an error occurred while processing this directive]

After the application proxy is created as a Windows Installer (.msi) file, you can install it on a client computer. Installing the application proxy provides the registration information that is necessary for client applications to access the COM+ application remotely from the client computer.

Important

You can install a COM+ application proxy on any computer running Windows Installer. Windows Installer is automatically installed on all computers running Windows 2000, Microsoft Windows Serverâ„¢ 2003, or Windows Server 2008, and it is also available for computers running earlier versions of Windows. However, if an application proxy requires the COM+ Queued Components service, the application proxy can be installed only on a computer running Windows 2000, Windows Server 2003, or Windows Server 2008. The Queued Components service is available only on platforms that support Component Services.

Membership in Administrators, or equivalent, is the minimum required to complete this procedure. Review the details in "Additional considerations" in this topic.

Installing COM+ application proxies

To install a COM+ application proxy using the Component Services snap-in
  1. Open Component Services.

  2. In the console tree, locate the COM+ Applications folder that is associated with the computer on which you want to install the application.

  3. Right-click the COM+ Applications folder, point to New, and then click Application.

  4. In the COM+ Application Install Wizard, click Next.

  5. On the Install or Create a New Application page, click Install pre-built application(s).

  6. In the Install from application file dialog box, browse to select the .msi file for the application proxy that you are installing, and then click Open.

  7. On the Select Application Files page, click Add to browse for any additional application proxies that you want to install, and then click Next.

  8. On the Application Installation Options page, specify the directory in which you want to install the COM+ application proxy, and then click Next.

    The application's component files are copied from the .msi file to the installation directory. The default installation directory is:

       %Program Files%\COMPlus Applications\appid

    You can either accept the default directory or click Specific directory and search for another location.

  9. Click Finish. The Component Services console tree now shows the new application. If you install multiple applications, the directory that you choose in step 8 is used for all the applications.

Additional considerations

  • Component Services is no longer in Administrative Tools. To open Component Services, click Start. In the search box, type dcomcnfg, and then press ENTER.

  • To install a COM+ application proxy, you must have Write access to the installation directory.

To install a COM+ application proxy using Windows Explorer
  1. On the client computer, locate the application proxy file (.msi) using Windows Explorer. This file can reside locally or on a network shared resource.

  2. Double-click the application proxy file. You can also right-click the file name, and then click Install.

    Windows Installer automatically installs the application proxy on the client computer.

Additional considerations

  • To install a COM+ application proxy, you must have Write access to the installation directory.

To install a COM+ application proxy using a command line
  • At the command prompt, type the following, and then press ENTER:

    msiexec -i [<property overrides>] <application_name>.msi
    

    Value Description

    property overrides

    In addition to the standard Windows Installer property overrides, you can specify the following option to change the installation directory for the COM+ application from the default to the specified directory:

    TARGETDIR = <target installation directory>
    

    application_name

    The name of the application to be installed.

In addition to the standard Windows Installer property overrides, you can specify the installer options that are described in the following table.

Installer option Description
REMOTESERVERNAME = <new target server>

Changes the server to which the client computer connects from the exported default to the specified new target server.

ALLUSERS = 0

Installs the application proxy only for the current user. By default, the application proxy is installed computer-wide.

TARGETDIR = <target installation directory>

Changes the installation directory for the COM+ application from the default to the specified directory.

Additional considerations

  • To install a COM+ application proxy, you must have Write access to the installation directory.

Additional references


[an error occurred while processing this directive]