Installation Instructions for WSRF.NET 3.0.1

1. Prerequisites: Install IIS, then .NET framework 2.0 and then WSE 3.0. The ordering is important to make sure all the correct components are installed on your machine.

IIS comes with Windows XP (and others), but is often not installed by default. It can usually be installed by going to Control Panels -> Add/Remove Programs and then selecting "Add/Remove Windows Components". You may need the CD for your copy of Windows.

If you already had the .NET framework 2.0 on your machine and you just installed IIS, remove the framework (under Control Panels -> Add/Remove Programs). Otherwise IIS will not be integrated with it correctly.

Install/reinstall the .NET 2.0 framework from here.

WSE 3.0 can be downloaded here.

2. Download the WSRF.NET msi

Download WSRFdotNet3.0.1.msi to your computer.

3. Double-click on WSRFdotNet3.0.msi This will install WSRF.NET. Follow the instructions given.
4. Install and configure a Database WSRF.NET uses an XML database to store WS-Resources. Currently, WSRF.NET is compatible with Xindice, Microsoft SQLServer 2005 and Microsoft SQLServer 2005 Express. Xindice is available from Apache and runs on top of Tomcat. SQLServer 2005 is Microsoft's latest generation database. SQLServer 2005 Express Edition is freely available and is included with Visual Studio 2005.

To install and configure either SQLServer 2005 or SQLServer 2005 Express Edition, click here.

To install and configure Xindice, click here.
5. Make sure the WSRF.NET solution's web projects are using .NET 2.0 IIS maintains the version of the .NET framework that each service uses.

If you are installing on a machine with VS.NET 2005, make sure that the web projects in WSRF.NET are using .NET 2.0 by opening the WSRFdotNet.sln solution in VS.NET 2005. If you are prompted to convert the web projects to .NET 2.0, click "yes".

If you are installing on a machine without VS.NET 2005, you must do one of the following:

1) if the machine on which you are installing is only using web services based on .NET 2.0, you can just run the command "aspnet_regiis -i -enable" (which will set all your services to use .NET 2.0)

  • make sure you are using the aspnet_regiis that comes with .NET 2.0 (typically in C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727)

2) if you are using web services based on both .NET 1.1 and .NET 2.0 then you must:

  • run "aspnet_regiis -s /W3SVC/1/ROOT/WSRF" (which will modify only the services which come with WSRF.NET)

  • if you are using IIS 6 (WinServer)

  • create a new IIS AppPool, enable it for .NET 2.0

  • set each WSRF.NET service to use that AppPool (for each service under the WSRF directory in the IIS control panel, right click and select "properties" - set the AppPool field (on the bottom of the dialog) to use your new AppPool)
5. (optional) Install NUnit. WSRFdotNet comes with several NUnit tests. If you chose to install NUnit, you can verify that the WSRFdotNet install is working. You must use NUnit 2.2.3 or later to work with the .NET 2.0 framework and VS.NET 2005. To download NUnit 2.2.3 go here and then follow these install instructions.
6. (optional - if you did step 5) Test the install You can now test your installation using NUnit.

Go to the Start -> Programs -> NUnit . Select "NUnit-Gui" (this assumes you installed the binaries. If you built it from source, run the NUnit GUI from src tree). Then select File -> Open. From the file dialog box navigate to your WSRFdotNet Bin dir. Select NUnitTesting.dll. Finally click the Run button. By default the TestProcessLauncer tests will be skipped (show yellow) but all other test should succeed (show green).

Problems? email wasson@virginia.edu