GWP1003 Geo Web Publisher V8i installation on Windows Server 2008 64 bit [TN]


	Applies To

	Product(s):	Bentley Geo Web Publisher V8i
	Version(s):	SELECT Series 1 and SELECT Series 2
	Environment:	N/A
	Area:	N/A
	Subarea:	N/A
	Original Author:	Carlos Martins, Bentley Technical Support Group

Overview

This TechNote provides guidelines on how to install Geo Web Publisher (GWP) V8i on Windows Server 2008 64 bit (WS2008 64x) and goes through a standard configuration set in order to access the example website from another machine.

Installing Server Roles and Role Services

Before running the server setup, the web server Microsoft Internet Information Services (IIS) must be installed. A web server is the essential component of a web site and is needed to publish a web site on the internet. Bentley GWP requires the Web Server (IIS) role and number of IIS role services to be installed for its proper installation and execution. The installation of WS2008 64x roles and role services is done accessing the Server Manager, selecting Roles, clicking Add Roles and selecting the Web Server (IIS) roles to be added. The GWP required Web Services (IIS) Role Services are listed next

Web Server (IIS) Role Services Requirements
       Web Server
                       Common HTTP Features
                                                 Static Content
                                                 Default Document
                                                 HTTP Errors
                         Application Development
                                                 ASP.NET
                                                 .NET Extensibility
                                                 ASP    Note: Only used for the delivered examples.
                                                 ISAPI Extensions
                                                 ISAPI Filters
                         Security
                                                 Basic Authentication
                                                 Windows Authentication
                         Management Tools
                                                 IIS Management Console
                                                 IIS 6 Management Compatibility
                                               IIS 6 Metabase Compatibility

Geo Web Publisher V8i Installation

All components of Bentley GWP can be installed on the server machine, but the frequently used administrative applications (Administrator, Map Author and Site Author) can be installed on a separate machine which is used to log to the server machine.

The Geo Web Publisher Installation prerequisites can be found in Bentley Geo Web Publisher Requirements.

When running the server setup, the following components are installed:

Bentley Geo Web Publisher Server.
Web server extension PubExtension.dll.
Documentation files.
Examples files.

When running the client setup, the following components are installed:

Administration.
Map Author.
Site Author.
Pre-publishing tool (iDPRcnv.exe).
Documentation files.

Subsequent to finishing the installation access IIS and make sure the examples are installed

Configuring the root of your Web site to run a 32-bit application pool and GWP Server as Web Server extension

Bentley Geo Web Publisher V8i is a 32-bit application. Web sites that are created with the Bentley Geo Web Publisher Site Author application will have to be configured to run with a 32-bit application pool. Bentley Geo Web Publisher V8i uses an ISAPI Filter when running as a Web Server Extension, and since this ISAPI Filter is a 32-bit dll, the root of the Web site must be configured to run has a 32-bit application pool. If the Web site root does not run a 32-bit application pool, the "Automatic Configuration of IIS" feature of the Administration Program will fail and Bentley Geo Web Publisher V8i will not be able to run as a Web Server Extension. To change the configuration and change the root of the Web site to run a 32-bit application pool access IIS and select the DefaultAppPool Advanced Settings and enable 32 bit application.

Important: IIS and GWP must be restarted in order the changes take effect.

To run the server as a Web Server Extension access the GWP Administration and enable Run as Web Server Extension and Automatically Configure MicroSoft IIS when Pressing START or RESTART, GWP needs to be restarted in order the changes take effect.

If the Web site root isn't configured to run with a 32-bit application pool the maps won't be displayed. The following error will occur when trying to publish from the MapViewer of the examples website.

The viewer will display the message that it isn’t possible to load the map “Unable to load the map definition file: ……… The remote server returned an error: (500) Internal Server Error”

Running Geo Web Publisher Examples Website from another machine

The Bentley GWP V8i Examples are by the default configuration set to run on the same machine as the server (server address is "localhost" and port number is "8087"). To access these examples from another machine, the server address and port number must be changed otherwise the maps won't be displayed. Otherwise an error will occur when trying to publish a map from the MapViewer examples website.

The configuration must be changed in

The GeoWebSite: Open the SampleWebSite.dat file in the Site Author, the Server Name and the Port Number must be changed. If the server is set to run as Web Server Extension port 80 is in use. Replace "localhost" with the proper address and change port number to 80.

Important: Republish the site once the changes are completed.

The MapViewer: In the Web.config file (located under "\Bentley\GeoWebPublisher\Examples\MapViewerExample"), replace "localhost" with the proper address.

OGC WMS: In the Web.config file (located under "\Bentley\GeoWebPublisher\Examples\WmsViewerExample"), replace "localhost" with the proper address

OpenLayers: Change the serverName and serverPort variables in the OpenLayers.html file (located under "\Bentley\GeoWebPublisher\Examples\OpenLayersExample").

In the Silverlight Client: Same as GeoWebSite.

OGC WMS Server Stress and MapViewer Server Stress: Change the public Web services address in the web.config file (located under "\Bentley\GeoWebPublisher\Examples\ServersStressPages").

Not Running as Web Server Extension

To configure the server in order to bypass IIS, Running as Web Server Extension must be disabled; the default port set is 8087 in the Administration program and in Site Author the port set must be also 8087.