----------------------------------------------------------------------
Microsoft Provisioning System SDK Readme File
October 2006
© 2003 Microsoft Corporation. All rights reserved.
This document provides late-breaking or other information
that supplements the Microsoft Microsoft Provisioning System SDK solution.

### CONTENTS

1. About this Release

2.1 Set up a Development Environment
2.2 Install the Documentation for Microsoft© Visual Studio©
2.3 Install the SDK Development Tools

### 1. ABOUT THIS RELEASE

Welcome to the Microsoft Provisioning System (MPS) software development kit. This solution includes development tools and documentation that integrate with Microsoft Visual Studio .NET 2003 and Microsoft Visual Studio 2005.

### 2.1 SET UP A DEVELOPMENT ENVIRONMENT

In order to develop for Microsoft Provisioning System (MPS), we recommend that you create a dedicated development environment which is made up of at least a minimal setup for MPS and the hosted service you are developing for, or a lab deployment of the solution reference architecture. In this way, you ensure that the production system is not impacted by any activity during the development phase.

Following is a list of the items you will need if you do not want to deploy the solution completely:

- Microsoft Windows Server 2003 R2 Machine
- MPS Distribution from the Microsoft Solution for Windows-based Hosting version 3.5 or the Microsoft Solution for Hosted Messaging and Collaboration version 3.5
- Microsoft SQL Server 2005 RTM installation media
- Microsoft Visual Studio 2005 RTM installation media
- A domain controller that you have administrative access to (can be a Virtual Server)
- A server running the service you are creating a provider for, and which you can use to try out your provider (can be a Virtual Server)

Following are the steps to follow in order to prepare your environment for development for MPS.

To prepare the MPS development environment:

1. On all machines, install the operating system and the latest service pack and hotfixes.
2. Join all machines to the domain.
3. Install SQL Server 2005 on your development server.
4. Install Visual Studio 2005 on your development server.
5. Install MPS on your development server, using the MPF.MSI and following the Install Wizard. Install all components except the ISAPI Filter.
6. Reboot the development server.
7. Install the MPS SDK 2.0.
8. If you need the other providers and namespaces shipped with the solution, you can install the respective MSIs on the MPS Engine Server from the solution distribution CD.
   Note When running the MSIs, you will receive a warning that they can only be installed by using the MPS Deployment Tool. To get around this, use this command line without the quotes "msiexec /i msiname.msi ENABLEUI=YES" (the parameter is case sensitive).

Important Do not use this for a production system; these instructions are for development systems only.

Now that this is done you will have to set up the environment variables on the development server.

To set up the environment variables on the development server

1. Open the computer properties, and then, on the Advanced tab, add the following path to the Path Variable C:\Program Files\Microsoft Provisioning\Tools
2. Add the Domain\MPFServiceAccts Group to the local Administrators Group.
3. Add the Domain\MPFClientAccts to the Local DCOM Users Group.
4. Restart the MPF Engine COM+ Application using the Component management MMC Snap-in (dcomcnfg.exe).
5. Open a command prompt and type provtest.exe /X3 "C:\Program Files\Microsoft Provisioning\Samples\Simple.xml"

   You should get a response that is formated XML in green and blue looking like this:``

       <response>
       ?   <data>
       ?      <organizations>
       ?         <organization name="tailspintoys.com"/>
       ?      </organizations>?
       	</data>?
       </response>

   If the response is a error in yellow and red like the following example, the error message might be different.``

       <response>?
       <errorContext description="No provisioning engines are available to process the request." code="0xc2201908"/>
       </response>

Make sure that all the environment settings are done correctly. If in doubt please post questions on the Microsoft Provisioning Forum.

### 2.2 Install the Microsoft Provisioning System Software Development Kit

Before you use the MPS SDK installer, make sure the following software components are already installed on the local computer:

- The MPS Client
- Visual Studio 2003 or Visual Studio 2005 or both

> Important
> Visual Studio 2005 must have been started at least once before you run the MPS SDK installer. If it has not been initialized, then the MPS SDK components designed for use with Visual Studio 2005 and the .NET 2.0 framework will not be installed.

To install the Microsoft Provisioning System Software Development Kit:

1. Locate the file Microsoft Provisioning System SDK.msi file and double-click to open it.
2. On Welcome to the Installer Wizard for MPSSDK Package page, click Next.
3. On the License Agreement page, click I accept the terms in the license agreement, then click Next.
4. On the Customer Information page:
   - Enter your User Name
   - Enter your Organization
   - Make a selection for Install this application for:
   Then, click Next.
5. On the Setup Type page, verify that Complete is selected, then click Next.

   Note When you leave the Setup Type set to Complete, the installer checks your system to see which version or versions of Visual Studio are installed on the local computer. If you select Custom, you will be prompted to choose which MPS SDK components to install.

6. On the Ready to Install the Program page, click Install.
7. On the Installer Wizard Completed page, click Finish.

### 2.3 INSTALL THE SDK DOCUMENTATION FOR VISUAL STUDIO

To install the documentation for the MPS SDK, do one of the following:

- Run MPSSDK2003Setup.msi to install the MPS SDK documentation in Visual Studio .NET 2003.
  -or-
- Run MPSSDK2005Setup.msi to install the MPS SDK documentation in Visual Studio 2005.