Creating and Deploying an Add-In Package

Creating and Deploying an Add-In Package

Published: December 17, 2010

Updated: October 9, 2012

Applies To: Windows Home Server 2011, Windows Server 2012 Essentials, Windows Small Business Server 2011 Essentials, Windows Storage Server 2008 R2 Essentials

To distribute your add-in, you must create an add-in package that is a cabinet (CAB) file, which contains Windows Installer packages, an addin.xml file for metadata, and an optional .rtf for an End-User License Agreement. The CAB file must use a .wssx extension

Creating the add-in package

Deploying the add-in package

You can deploy the add-in package (.wssx file) through any channel that you find appropriate for your add-in. For example you can offer the add-in from a website:

  1. The .wssx file is downloaded from a website to a client computer that can communicate with the server.

  2. The .wssx file is double-clicked to start the installation process. During the installation of the add-in, the components (server-side .msi and client-side .msi files) are installed on the server. The server redistributes the client-side .msi file to all of the client computers on the network.

    Most servers are installed and configured to be administered remotely. An installation of an add-in from the desktop on a server is not a supported scenario. You must not rely on users having access to the desktop of the server.

You must digitally sign your add-in package to prevent a warning from being displayed when the add-in is installed. For more information, see How to: Digitally Sign the Add-In Package.

End-User Installation Process

You can offer the add-in package (.wssx file) through any channel that you deem appropriate to the end-user who will install the add-in. The following steps illustrate a typical scenario of how the user would download and install an add-in:

  1. The user downloads the .wssx package from an Internet site to his client computer that is joined to a server for which you created the add-in.

  2. The user double-clicks the .wssx file to start the installation process:

    1. The add-in components (server-side .msi and client-side .msi files) are transported to the server.

    2. The server-side component is installed on the server.

    3. The server then redistributes the client-side .msi to any of the joined client computers in the network.

In order to avoid the user seeing a security warning message at installation, you must properly code sign the add-in package.

As many servers are headless devices, installation from a server’s desktop is not a supported scenario and you must not rely on users having access to the server’s desktop.

© 2016 Microsoft