Installation Guide
Page 2
... is a trademark of Autodesk's or a third party's trademarks used within this document. Notwithstanding the foregoing, you shall acquire no rights in, and the foregoing license shall not apply to be installed and used in this software product (Approval No.: 646 ...numbered TKY2JGD for thread safety by Boutell.Com, Inc. Funded under the conditions set forth in part on the work ; (ii) make commercial use of Health. Portions relating to WBMP copyright 2000, 2001, 2002, 2003, 200 4Maurice Szmurlo and Johan Van den Brande. Trademarks Autodesk, Autodesk Map, Autodesk MapGuide...
... is a trademark of Autodesk's or a third party's trademarks used within this document. Notwithstanding the foregoing, you shall acquire no rights in, and the foregoing license shall not apply to be installed and used in this software product (Approval No.: 646 ...numbered TKY2JGD for thread safety by Boutell.Com, Inc. Funded under the conditions set forth in part on the work ; (ii) make commercial use of Health. Portions relating to WBMP copyright 2000, 2001, 2002, 2003, 200 4Maurice Szmurlo and Johan Van den Brande. Trademarks Autodesk, Autodesk Map, Autodesk MapGuide...
Installation Guide
Page 3
Contents Chapter 1 Installing MapGuide on Windows 1 Installation Requirements 2 Installing MapGuide Server 2 Installing MapGuide Web Server Extensions 4 Setting Up Java for the Bundled Installation 8 Chapter 2 Configuring MapGuide Web Server Extensions on Windows 11 Possible Configuration Scenarios 12 Directory Structure 12 Configuration with IIS 13 Setting Up Virtual Directories for IIS 13 Setting Up the PHP Association 16 Setting Up the FastCGI Association 17 Setting Up the Security Properties 19 Setting Up the Error Pages 20 Setting Up Virtual Directories for the Viewers ...
Contents Chapter 1 Installing MapGuide on Windows 1 Installation Requirements 2 Installing MapGuide Server 2 Installing MapGuide Web Server Extensions 4 Setting Up Java for the Bundled Installation 8 Chapter 2 Configuring MapGuide Web Server Extensions on Windows 11 Possible Configuration Scenarios 12 Directory Structure 12 Configuration with IIS 13 Setting Up Virtual Directories for IIS 13 Setting Up the PHP Association 16 Setting Up the FastCGI Association 17 Setting Up the Security Properties 19 Setting Up the Error Pages 20 Setting Up Virtual Directories for the Viewers ...
Installation Guide
Page 6
... use the installer, but build MapGuide from the MapGuide downloads page at http://osgeo.org/. There are available from source, refer to Building and Configuring MapGuide on Windows Installation Requirements NOTE If you must act as support servers that make up MapGuide Open Source: ■ MapGuide Server ■ MapGuide Web Server Extensions The installer programs are two separate components that perform a subset of the site server. Installing MapGuide Server 2 | Chapter 1 Installing MapGuide on Windows for instructions. MapGuide Server and MapGuide Web Server Extensions...
... use the installer, but build MapGuide from the MapGuide downloads page at http://osgeo.org/. There are available from source, refer to Building and Configuring MapGuide on Windows Installation Requirements NOTE If you must act as support servers that make up MapGuide Open Source: ■ MapGuide Server ■ MapGuide Web Server Extensions The installer programs are two separate components that perform a subset of the site server. Installing MapGuide Server 2 | Chapter 1 Installing MapGuide on Windows for instructions. MapGuide Server and MapGuide Web Server Extensions...
Installation Guide
Page 8
... which web server you will use for application development, PHP, ASP.NET, or Java Server Pages (JSP). Installing MapGuide Web Server Extensions Before installing MapGuide Web Server Extensions, decide which language you will use for your site, Apache HTTP Server or Internet Information Services (IIS). MapGuide Open Source 1.0.1 supports the following versions: ■ Apache 2.0.55 ■ IIS 5 and 6 ■ PHP 5.0.5 ■ .NET 2.0 ■ Tomcat 5.5.12 To install the Web Server Extensions, run the installer program...
... which web server you will use for application development, PHP, ASP.NET, or Java Server Pages (JSP). Installing MapGuide Web Server Extensions Before installing MapGuide Web Server Extensions, decide which language you will use for your site, Apache HTTP Server or Internet Information Services (IIS). MapGuide Open Source 1.0.1 supports the following versions: ■ Apache 2.0.55 ■ IIS 5 and 6 ■ PHP 5.0.5 ■ .NET 2.0 ■ Tomcat 5.5.12 To install the Web Server Extensions, run the installer program...
Installation Guide
Page 9
..., so it does not configure a web server. NOTE If you choose Java as the default environment for the Apache HTTP Server. See Setting Up Java for the Bundled Installation (page 8) for details about configuration. See Configuring MapGuide Web Server Extensions on Windows (page 11) for details. If you must change this manually. You must install the Java JDK, and configure Tomcat. If you choose the IIS configuration option, specify the development environment...
..., so it does not configure a web server. NOTE If you choose Java as the default environment for the Apache HTTP Server. See Setting Up Java for the Bundled Installation (page 8) for details about configuration. See Configuring MapGuide Web Server Extensions on Windows (page 11) for details. If you must change this manually. You must install the Java JDK, and configure Tomcat. If you choose the IIS configuration option, specify the development environment...
Installation Guide
Page 11
... install this documentation. If you specify the custom setup, you must configure Web Server Extensions manually. NOTE If you select more than one API you can decide which components to install, and change the installation location for the Site Administrator pages, even if you do not plan to develop MapGuide applications, you specify the typical setup, the rest of the installation proceeds automatically, using default values for the installed components and locations. Installing MapGuide Web Server Extensions | 7 By default...
... install this documentation. If you specify the custom setup, you must configure Web Server Extensions manually. NOTE If you select more than one API you can decide which components to install, and change the installation location for the Site Administrator pages, even if you do not plan to develop MapGuide applications, you specify the typical setup, the rest of the installation proceeds automatically, using default values for the installed components and locations. Installing MapGuide Web Server Extensions | 7 By default...
Installation Guide
Page 12
... perform the following lines: 8 | Chapter 1 Installing MapGuide on Windows Install using the default installation instructions. Click Next to C:\Program Files\MapGuideOpenSource\WebServerExtensions. To install Java, download the JDK from java.sun.com. By default, the files are installed to complete the installation. This is located in C:\Program Files\MapGuideOpenSource\ WebServerExtensions\Apache2\conf\ Replace localhost with the name or IP address of your server in the following steps: ■ Install the Java JDK. ■ Set up redirections for...
... perform the following lines: 8 | Chapter 1 Installing MapGuide on Windows Install using the default installation instructions. Click Next to C:\Program Files\MapGuideOpenSource\WebServerExtensions. To install Java, download the JDK from java.sun.com. By default, the files are installed to complete the installation. This is located in C:\Program Files\MapGuideOpenSource\ WebServerExtensions\Apache2\conf\ Replace localhost with the name or IP address of your server in the following steps: ■ Install the Java JDK. ■ Set up redirections for...
Installation Guide
Page 13
... JDK 5.0, update 6, this is installed in different locations. For the default installation, Tomcat is C:\Program Files\Java\jdk1.5.0_06 Different versions of your Java installation. To start Tomcat, go to the root directory of the JDK will be installed in the following location: C:\Program Files\MapGuideOpenSource\WebServerExtensions\Tomcat\ Setting Up Java for the Bundled Installation | 9 Redirect /mapguide/mapviewerajax/ http://localhost:8008/mapguide/mapviewerjava/ajaxviewer.jsp Redirect /mapguide/mapviewerdwf/ http://localhost:8008/mapguide/mapviewerjava/dwfviewer...
... JDK 5.0, update 6, this is installed in different locations. For the default installation, Tomcat is C:\Program Files\Java\jdk1.5.0_06 Different versions of your Java installation. To start Tomcat, go to the root directory of the JDK will be installed in the following location: C:\Program Files\MapGuideOpenSource\WebServerExtensions\Tomcat\ Setting Up Java for the Bundled Installation | 9 Redirect /mapguide/mapviewerajax/ http://localhost:8008/mapguide/mapviewerjava/ajaxviewer.jsp Redirect /mapguide/mapviewerdwf/ http://localhost:8008/mapguide/mapviewerjava/dwfviewer...
Installation Guide
Page 16
... Java. Possible Configuration Scenarios Depending on Windows Install with bundled Apache, PHP, and Tomcat This installs separate versions of web server You must configure a web server manually. Directory Structure If you use either Apache or IIS as your web server, you choose either PHP or JSP for developing your own applications. If you can use the installer program, the default installation directory (InstallDir) is C:\Program Files\MapGuideOpenSource and the Web Server Extensions directory (WebDir) is C:\Program Files...
... Java. Possible Configuration Scenarios Depending on Windows Install with bundled Apache, PHP, and Tomcat This installs separate versions of web server You must configure a web server manually. Directory Structure If you use either Apache or IIS as your web server, you choose either PHP or JSP for developing your own applications. If you can use the installer program, the default installation directory (InstallDir) is C:\Program Files\MapGuideOpenSource and the Web Server Extensions directory (WebDir) is C:\Program Files...
Installation Guide
Page 17
... been done. Start the IIS administration console and create a new virtual directory. There are the same. Configuration with IIS If you use IIS as reference, to run the Site Administrator from the machine, you must perform the following steps: ■ Set up virtual directories for the Web Server Extensions and the AJAX and DWF Viewers. ■ Configure PHP or ASP.NET. If you use the installer, but configure the web server manually.
... been done. Start the IIS administration console and create a new virtual directory. There are the same. Configuration with IIS If you use IIS as reference, to run the Site Administrator from the machine, you must perform the following steps: ■ Set up virtual directories for the Web Server Extensions and the AJAX and DWF Viewers. ■ Configure PHP or ASP.NET. If you use the installer, but configure the web server manually.
Installation Guide
Page 20
... or as a development environment or if you will be using PHP as an ISAPI extension. For example, the default location is C:\Progra~1\MapGuideOpenSource\WebServerExtensions\Php\php5isapi.dll. 16 | Chapter 2 Configuring MapGuide Web Server Extensions on this machine. You can choose to the default location under C:\Program Files, you must set up the application mapping is the same in both cases, except that the...
... or as a development environment or if you will be using PHP as an ISAPI extension. For example, the default location is C:\Progra~1\MapGuideOpenSource\WebServerExtensions\Php\php5isapi.dll. 16 | Chapter 2 Configuring MapGuide Web Server Extensions on this machine. You can choose to the default location under C:\Program Files, you must set up the application mapping is the same in both cases, except that the...
Installation Guide
Page 23
... set the application mapping in the dialog below. Change the path to the Directory Security tab and click Edit. Otherwise, there is already set for you by IIS and you don't need to disable the FastCGI agent and use a regular CGI agent instead. Refer to the Windows Registry. Setting Up the Security Properties | 19 Add the following to the Microsoft support note at http://support.microsoft.com/default...
... set the application mapping in the dialog below. Change the path to the Directory Security tab and click Edit. Otherwise, there is already set for you by IIS and you don't need to disable the FastCGI agent and use a regular CGI agent instead. Refer to the Windows Registry. Setting Up the Security Properties | 19 Add the following to the Microsoft support note at http://support.microsoft.com/default...
Installation Guide
Page 26
... to the default document list. 22 | Chapter 2 Configuring MapGuide Web Server Extensions on Windows Open the Documents tab of the Properties dialog, and add the appropriate document to the default list: ■ For PHP development, add ajaxviewer.php to the default document list. ■ For ASP.NET development, add ajaxviewer.aspx to mapviewerajax. Finally, set the physical path to WebDir\mapviewernet. If you use ASP.NET as your development language, set the physical...
... to the default document list. 22 | Chapter 2 Configuring MapGuide Web Server Extensions on Windows Open the Documents tab of the Properties dialog, and add the appropriate document to the default list: ■ For PHP development, add ajaxviewer.php to the default document list. ■ For ASP.NET development, add ajaxviewer.aspx to mapviewerajax. Finally, set the physical path to WebDir\mapviewernet. If you use ASP.NET as your development language, set the physical...
Installation Guide
Page 27
... to the default document list. ■ For ASP.NET development, add dwfviewer.aspx to the default document list. Configuring PHP | 23 Repeat the steps above to create a virtual directory for both directories. The default documents are as a development language for MapGuide applications or if you plan to mapviewerdwf instead of mapviewerajax. To configure PHP, edit the PHP configuration file, php.ini. Set the name to use the Site Administrator. The php.ini file is the...
... to the default document list. ■ For ASP.NET development, add dwfviewer.aspx to the default document list. Configuring PHP | 23 Repeat the steps above to create a virtual directory for both directories. The default documents are as a development language for MapGuide applications or if you plan to mapviewerdwf instead of mapviewerajax. To configure PHP, edit the PHP configuration file, php.ini. Set the name to use the Site Administrator. The php.ini file is the...
Installation Guide
Page 28
.... cgi.force_redirect = 1 to the PHP directory containing php.ini. You must make the following change to allow the use the installer program, most of larger data sets: output_buffering = 4096 max_execution_time = 60 memory_limit = 64M post_max_size = 64M upload_max_filesize = 64M 24 | Chapter 2 Configuring MapGuide Web Server Extensions on Windows Editing php.ini When you . Read the PHP documentation for you use of the required PHP configuration is the one PHP...
.... cgi.force_redirect = 1 to the PHP directory containing php.ini. You must make the following change to allow the use the installer program, most of larger data sets: output_buffering = 4096 max_execution_time = 60 memory_limit = 64M post_max_size = 64M upload_max_filesize = 64M 24 | Chapter 2 Configuring MapGuide Web Server Extensions on Windows Editing php.ini When you . Read the PHP documentation for you use of the required PHP configuration is the one PHP...
Installation Guide
Page 29
... ASP.NET tab, check the version number. Configuring ASP.NET | 25 MapGuide requires version 2.0.50727 or higher. Navigate to the system PATH environment variable. Set the extension status to Allowed. Verify that the PHP DLLs can be configured properly. Click Add a new Web Service Extension. Adding the PHP Directory to the PATH If you run . This ensures that you use the installer, ASP.NET should be loaded properly.
... ASP.NET tab, check the version number. Configuring ASP.NET | 25 MapGuide requires version 2.0.50727 or higher. Navigate to the system PATH environment variable. Set the extension status to Allowed. Verify that the PHP DLLs can be configured properly. Click Add a new Web Service Extension. Adding the PHP Directory to the PATH If you run . This ensures that you use the installer, ASP.NET should be loaded properly.
Installation Guide
Page 31
... extension. Common Configuration Steps There are some steps you must remove the PHP configuration directives described in Configuring Apache to Use PHP (page 28) and add the JSP directives described in Configuring Apache to use PHP as follows, or add the following to configure the web server manually, the installer installs and configures a version of the PHP engine. Edit httpd.conf. ScriptAlias /php/ "C:/Program Files/MapGuideOpenSource/ WebServerExtensions/Php/" Action application/x-httpd-php...
... extension. Common Configuration Steps There are some steps you must remove the PHP configuration directives described in Configuring Apache to Use PHP (page 28) and add the JSP directives described in Configuring Apache to use PHP as follows, or add the following to configure the web server manually, the installer installs and configures a version of the PHP engine. Edit httpd.conf. ScriptAlias /php/ "C:/Program Files/MapGuideOpenSource/ WebServerExtensions/Php/" Action application/x-httpd-php...
Installation Guide
Page 33
....apache.org. Install using the default installation instructions. You must also perform the following declarations at the end of your Java installation. Apache Configuration Add the following steps: ■ Edit the Apache configuration file, httpd.conf. ■ Add a workers.properties configuration file for the Tomcat connector. ■ Configure and start Tomcat. Configuring Apache to the root directory of httpd.conf. Install using the default installation instructions. Set the environment variable JAVA_HOME to Use JSP | 29 Download Tomcat and...
....apache.org. Install using the default installation instructions. You must also perform the following declarations at the end of your Java installation. Apache Configuration Add the following steps: ■ Edit the Apache configuration file, httpd.conf. ■ Add a workers.properties configuration file for the Tomcat connector. ■ Configure and start Tomcat. Configuring Apache to the root directory of httpd.conf. Install using the default installation instructions. Set the environment variable JAVA_HOME to Use JSP | 29 Download Tomcat and...
Installation Guide
Page 35
... Redirect /mapguide/mapviewerdwf/ http://:/mapguide/mapviewerjava/dwfviewer.jsp Connector Configuration Rename the pre-built Apache/Tomcat connector binary to Use JSP | 31 The original file includes the version number and should be mod_jk-1.2.14-apache-2.0.54.so. Add a workers.properties file in the Apache conf folder, containing the following: Configuring Apache to mod_jk.so and place it in the Apache modules directory.
... Redirect /mapguide/mapviewerdwf/ http://:/mapguide/mapviewerjava/dwfviewer.jsp Connector Configuration Rename the pre-built Apache/Tomcat connector binary to Use JSP | 31 The original file includes the version number and should be mod_jk-1.2.14-apache-2.0.54.so. Add a workers.properties file in the Apache conf folder, containing the following: Configuring Apache to mod_jk.so and place it in the Apache modules directory.
Installation Guide
Page 36
... using ajp13 worker.list=worker1 # Set properties for worker1 (ajp13) worker.worker1.type=ajp13 worker.worker1.host=localhost worker.worker1.port=8009 worker.worker1.lbfactor=50 worker.worker1.cachesize=10 worker.worker1.cache_timeout=600 worker.worker1.socket_keepalive=1 worker.worker1.recycle_timeout=300 Tomcat Configuration In the Tomcat conf\Catalina\localhost directory, add a context file named mapguide.xml with the following content: antiJAR To start...
... using ajp13 worker.list=worker1 # Set properties for worker1 (ajp13) worker.worker1.type=ajp13 worker.worker1.host=localhost worker.worker1.port=8009 worker.worker1.lbfactor=50 worker.worker1.cachesize=10 worker.worker1.cache_timeout=600 worker.worker1.socket_keepalive=1 worker.worker1.recycle_timeout=300 Tomcat Configuration In the Tomcat conf\Catalina\localhost directory, add a context file named mapguide.xml with the following content: antiJAR To start...