Installation Instructions for OGSI.NET 2.1.6

1. Prerequisites: Install IIS, then .NET framework 1.1 and then WSE 2.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 1.1 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 1.1 framework from here.

WSE 2.0 can be downloaded here.

If you had a previous version of OGSI.NET installed, remove it. This can be done by running the installer program that came with that version and telling it to remove the installation. If you encounter problems, see the release notes.

2. Unzip the OGSI.NET server and client bundles Create a directory for the server bundle: for example c:\OGSIdotNetServer.

Create a directory for the client bundle: for example c:\OGSIdotNetClient.

Download OGSIdotNetServer2.1.6.zip to your server bundle directory and unzip the file.

Download OGSIdotNetClients2.1.6.zip to your client bundle directory and unzip the file.

3. Run setup.exe Run setup.exe in both the server and client bundle directories. Follow the instructions given.
4. Test the install You can now test your installation using the OGSI.NET browser.

Go to the Start -> Programs -> OGSIdotNet. Select "OGSI Browser". Push the "Load" button and the browser will contact the ContainerRegistryService that is running on localhost. From there you should be able to access most of the sample services included in OGSI.NET.

5. Modify the schemaRoot parameter in the  OGSI.config file if necessary The OGSI.NET container is configured by a set of files in the Configuration directory (located in the server bundle's install directory, e.g. c:\Program Files\UVaGCG\OGSIdotNetServer\Configuration). The OGSI.config file contains information on all the services that the OGSI.NET container will start automatically. It also includes parameters used to configure all services. Look for the parameter named "schemaRoot" in the <globalConfiguration> section of the OGSI.config file. This parameter provides the OGSI.NET container with the base path to find all WSDL files associated with the services being run in the container and it should point to the "root" of the local web server. The default value of this parameter is "http://localhost/". In some environments, this default may not be desirable (see the notes page). It is recommended that this parameter be set to include the actual machine name or IP address (e.g. <parameter name="schemaRoot" value="http://abbott.cs.virginia.edu/"/> on machines with fixed IP addresses. For machines without fixed addresses (such as laptops on wireless networks), use the default value, but see the notes page. If you modify this parameter, restart the OGSI.NET container (Start Menu -> Settings -> Control Panels -> Administrative Tools -> Services. Select the OGSIContainerService from the right hand panel and click "Restart" in the left hand panel).

Problems? email wasson@virginia.edu