Deploying a Serviced Component

Add an existing Windows service project StepByStep7_8 (NorthwindSC, created in Chapter 7) to the solution.

Right-click the project StepByStep7_8 and choose Add, Add New Item from the context menu. The Add New Item dialog box appears. Select Installer Class from the right pane. Name the new class NorthwindSCInstaller.cs.

Add a reference to the System.Windows.Forms.dll to the StepByStep7_8 project by using the Add Reference dialog box.

Open the NorthwindSCInstaller.cs file in the code view and add the following using directive:

using System.EnterpriseServices;

using System.Windows.Forms;

Add the following code after the Component Designer–generated code section in the class definition:

public override void Install(

    System.Collections.IDictionary stateSaver)

{

    try

    {

        string application = null;

        string tlbimp = null;



        // Get the location of the assembly

        string scassembly =

            GetType().Assembly.Location;



        // Install the assembly in the COM+ catalog

        RegistrationHelper rh =

            new RegistrationHelper();

        rh.InstallAssembly(scassembly,

            ref application, ref tlbimp,

            InstallationFlags.

            FindOrCreateTargetApplication);



        // Save the application name and assembly

        // location in the InstallState file

        stateSaver["application"] = application;

        stateSaver["scassembly"] = scassembly;

    }

    catch(Exception ex)

    {

        MessageBox.Show(

            ex.Message, "Install Exception");

    }

}



public override void Uninstall(

    System.Collections.IDictionary savedState)

{

    try

    {

        // Retrieve the application name and assembly

        // location from the InstallState file

        string application =

            (string) savedState["application"];

        string scassembly =

            (string) savedState["scassembly"];



        // Uninstall the assembly from the COM+ catalog

        RegistrationHelper rh =

            new RegistrationHelper();

        rh.UninstallAssembly(scassembly, application);

    }

    catch(Exception ex)

    {

        MessageBox.Show(

            ex.Message, "Uninstall Exception");

    }

}

Build the StepByStep7_8 project.

Add a new project to the solution. In the Add Project dialog box, select Setup and Deployment Projects from the Project Types tree and select Setup Project from the list of templates on the right. Name the project NorthwindSCSetup.

In Solution Explorer, right-click the project and select Add, Project Output from the context menu. In the Add Project Output Group dialog box, select StepByStep7_8 as the project and select Primary Output from the list box. Click OK.

Open the Custom Actions Editor for the NorthwindSCSetup project. Right-click the Install node under the Custom Actions node and then select Add Custom Action from the shortcut menu. The Select Item in Project dialog box appears. Look in the Application Folder and select Primary Output from StepByStep7_8 (Active). Click OK. The primary output is added to the Install node.

Now select the Uninstall node and select Add Custom Action from the context menu. The Select Item in Project dialog box appears. Look in the Application Folder and select Primary Output from StepByStep7_8 (Active). Click OK. The primary output is now also added to the Uninstall node, as shown in Figure.

Open the File System Editor for the NorthwindSCSetup project. Select the File System on Target Machine node and choose Add Special Folder, Global Assembly Cache Folder from the context menu. Select the Global Assembly Cache Folder and select Add, Project Output from the context menu.

The Add Project Output Group dialog box appears. Select the StepByStep7_8 project and select Primary Output from the list of items to be added. Click OK. The File System Editor now appears as shown in Figure.

Open the Registry Editor for the NorthwindSCSetup project. Select the HKEY_LOCAL_MACHINE node and hierarchically add new keys to the node in the order HKEY_LOCAL_MACHINE, Software, Microsoft, .NETFramework, AssemblyFolders, and NorthwindSCCorp, as shown in Figure.

Add a new string value to the newly added NorthwindSCCorp key. Select the value and invoke the Properties window. Empty the Name property. When you do this, the (Default) name of the value is set (refer to Figure). Set the Value property to [TARGETDIR]. This is the folder where the assembly file copy is stored, along with the GAC.

Select the new project in Solution Explorer. Activate the Properties window. Set Manufacturer to NorthwindSC Corp, set ProductName to NorthwindSC Serviced Component, and set Title to NorthwindSC Serviced Component Installer.

Build the NorthwindSCSetup project. Install the project.

Open the Component Services administrative tool from the Administrative Tools section of the Windows Control Panel. You should see the NorthwindSC component in the Northwind Data Application with Object Pooling application is being added to the Component Services on the target machine.

Open the Component Services administrative tool from the Administrative Tools section of the Windows Control Panel.

Right-click the Northwind Data Application with Object Pooling (created in StepByStep7_8) in the Component Services administrative tool and select Export from the context menu.

The welcome screen of the COM Application Export Wizard appears. Click Next.

The second screen of the wizard is the Application Export Wizard screen. Enter the full path and filename where the package file needs to be exported, as shown in Figure. Also, in the Export as Group box, select the Server Application option (see Figure). Click Next and then click Finish.

Browse to the destination folder, where the package files are exported. You should see two files, NorthwindSC.msi and NorthwindSC.msi.cab, being created.

Open the Component Services administrative tool from the Administrative Tools section of the Windows Control Panel.

Right-click the COM+ Application node and select New, Application from the context menu.

The welcome screen of the COM Application Install Wizard appears. Click Next.

The second screen of the wizard is the Install or Create a New Application screen. Click the Install Pre-built Application(s) button, as shown in Figure.

This opens the Install from Application File dialog box. Browse and select the NorthwindSC.msi package created in Step-by-Step 10.19. The Select Application Files screen of the wizard with the application file appears as shown in Figure. Click Next.

The Set Application Identity screen of the wizard appears. Select the Interactive user option, as shown in Figure. You can also provide user and password details if you want to install the application with a different identity. Click Next.

The Application Installation Options screen of the wizard appears. Select the Specific Directory option and specify a desired install directory for the component files, as shown in Figure. Click Next and then click Finish.

You should see the COM+ application Northwind Data Application with Object Pooling being added to the Component Services on the target machine.

Browse to the install directory selected in step 7. You should see that two component files, StepByStep7_8.dll and StepByStep7_8.tlb, have been created.