Share via


Installation Instructions for Source Code Installer

Retired Content

The Web Service Software Factory is now maintained by the community and can be found on the Service Factory site.

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies.
This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Retired: November 2011

Follow the instructions below to install the Service Factory: Modeling Edition. When you get to the end, if you receive any errors, just reset your experimental hive (see step 3 in the following procedure) and try again.

Note

To prevent errrors, you should not install or build the Service Factory more than once on a machine. Therefore, if you intend to install the source and build it, you must uninstall the binary or custom versions first.

Note

Known Issue: If you install the source code in a non-default location, it is possible that you will not be able to create your solution files. By default, you should use the following folder: C:\Projects\WssfSrc\

To install the Service Factory: Modeling Edition

Ensure that your computer meets the system requirements. You should install the requirements in the order they appear.

If you have installed any previous Service Factory: Modeling Edition community drops, follow the Uninstallation Instructions to remove the previous version.

If you are using Microsoft Vista, open the Visual Studio 2008 Command Prompt as an administrator and run devenv /setup.

Reset the Visual Studio 2008 Experimental hive. On the taskbar, click Start, point to All Programs, point to Microsoft Visual Studio 2008 SDK, point to Tools, and then click Reset the Microsoft Visual Studio 2008 Experimental hive.

Note

The experimental hive is a part of the registry; it is provided by the Visual Studio SDK and is designated to test Visual Studio extensions (like DSLs) without the danger of corrupting the main registry hive that Visual Studio uses (the instance of Visual Studio you use every day). During testing, a different instance of Visual Studio is used that operates only on the experimental hive. For more information about the experimental hive, see Experimental Build on MSDN. This step ensures you start from a clean slate. If you have been doing other work with the DSL toolkit in the experimental hive, this will erase the registrations of those components.

Install the Web Service Software Factory source .msi file to the default location (C:\Projects\WssfSrc). If you choose a different location, you should install the source code to a directory with a short path name (for example, C:\Projects\WssfV4Src). This is due to the following known issue with respect to the length of file names:

Note

Known Issue: Windows operating systems do not allow pathnames longer than 254 characters on non-NTFS partitions. Some applications such as Visual Studio enforce his constraint independent of the format of the partition. Because the Service Factory: Modeling Edition source code includes some long namespaces, which directly affect the names of the resource files during a build, we recommend installing to a short path name.

Run the build script that contains the post-installation activities.

  1. Open a Visual Studio Command Prompt and navigate to the folder where you installed the Service Factory (for example, C:\Projects\WssfSrc). If you are using Windows Vista, this should be opened as an administrator.
  2. Run the build task by entering msbuild PostInstall.proj.
  3. Close the command prompt window.

Using a normal (non-experimental) instance of Visual Studio, open the Service Factory Guidance package.sln file from your source installation folder.

Rebuild the entire solution.

Attach the Guidance Automation Toolkit to the solution. To do this:

  1. On the Tools menu, click Guidance Package Manager.
  2. In the Guidance Package Manager dialog box, click Enable/Disable Packages.
  3. In the Enable and Disable Packages dialog box, select the Guidance Package Development check box, and then click OK.
  4. In the Guidance Package Manager dialog box, click Close.

In Solution Explorer, right-click Service Factory Guidance Package, and then click Register Guidance Package. (This may take several minutes, depending on the speed of your computer).

After you successfully register the guidance package, close Visual Studio.

After completing the preceding steps, this drop is installed. The important thing to remember is anytime you want to create a Service Factory: Modeling Edition solution, you must do so with an experimental instance of Visual Studio. If you try to create a solution using the normal instance of Visual Studio, it will fail with errors, as it should.