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.
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
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:
When running the client setup, the following components are installed:
Subsequent to finishing the installation access IIS and make sure the examples are installed
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”
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 addressOpenLayers: 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").
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.
Product TechNotes and FAQs
Geospatial Server Products Wiki
Bentley Technical Support KnowledgeBase
Bentley LEARN Server
Bentley's Technical Support Group requests that you please submit any comments you have on this Wiki article in the "Comments" area below. THANK YOU!