Deploying the Add-In MSI

  • Article

To deploy the SDKSample Add-in, copy the MSI file, InstallSDKSample.msi, from your development computer to the \\ServerName\Software\Add-ins\ folder on the computer that is running Windows Home Server. MSI packages that conform to the Windows Home Server MSI requirements and that are placed in this folder are visible in the Windows Home Server Settings dialog on the Add-ins tab, in the Available section.

If you created an End User License Agreement (EULA) file, copy the file to the \\ServerName\Software\Add-ins\ folder on the computer that is running Windows Home Server.

To deploy and install the SDKSample Add-in

  1. Copy InstallSDKSample.msi from your development computer to the \\ServerName\Software\Add-ins\ folder on the computer that is running Windows Home Server (where ServerName is the name of your server).

  2. (Optional) If you created a EULA file, copy InstallSDKSample.rtf from your development computer to the \\ServerName\Software\Add-ins\ folder on the computer that is running Windows Home Server (where ServerName is the name of your server).

  3. Open the Windows Home Server console.

  4. Click Settings.

  5. In the Windows Home Server Settings dialog box that appears, click Add-Ins, then select the Available tab.

  6. Your InstallSDKSample add-in should be visible. Click Install.

Note

If your add-in is not visible in the Available tab, make sure that the WHSLogo property has been added to your MSI package.

Next, test the Add-in.

To test the SDKSample Add-in

  1. Log on to the computer that is running Windows Home Server using an account with administrator privileges.

    Note

    Ordinarily, Windows Home Server is remotely administered, with no monitor, keyboard, or pointing device directly attached. In this scenario, users open the Windows Home Server Console remotely on client computers by using the Windows Home Server Connector software. But for the purposes of this tutorial, if you do not have a client computer set up, you can either log on directly to the server (if you have a keyboard, mouse, and monitor attached to it), or you can connect using a Terminal Services session.

  2. Double-click Windows Home Server Console on the server desktop. The Windows Home Server Console appears.

  3. The SDK Sample tab appears (with the SDKSampleImg bitmap) in the list of Console tabs. Verify that the tab text is fully visible. If the text is cropped, adjust the length of your text so that it fits in the space provided (you set the text for your tab when you implement the TabText property of the IConsoleTab interface in your HomeServerTabExtender class).

  4. Click the SDK Sample tab. The Console pane area changes to show the User Control for the SDK Sample Console tab.

  5. Click Show WHS Info. Information about Windows Home Server disks, volumes, and shared folders appears in the display area.

  6. Click Clear Display to clear the displayed information.

  7. Click Open Settings. The Windows Home Server Settings dialog appears. SDK Sample is in the list of Settings tabs.

  8. Click SDK Sample. The Settings page pane area changes to show the Control for the SDK Sample Settings tab. The Control appears with the text "SDK Sample Settings."