Installation Guide
Page 2
... installed and used in the USA and/or other countries. IN NO EVENT SHALL AUTODESK, INC., BE LIABLE TO ANYONE FOR SPECIAL, COLLATERAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH OR ARISING OUT OF ACQUISITION OR USE OF THESE MATERIALS. DWF is based in part on the work , each under the conditions set forth at: http://creativecommons.org/licenses...
... installed and used in the USA and/or other countries. IN NO EVENT SHALL AUTODESK, INC., BE LIABLE TO ANYONE FOR SPECIAL, COLLATERAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH OR ARISING OUT OF ACQUISITION OR USE OF THESE MATERIALS. DWF is based in part on the work , each under the conditions set forth at: http://creativecommons.org/licenses...
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
... installed on Windows You can 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. When you install Web Server Extensions, you do not 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 for instructions. Installing MapGuide Server 2 | Chapter 1 Installing MapGuide...
... installed on Windows You can 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. When you install Web Server Extensions, you do not 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 for instructions. Installing MapGuide Server 2 | Chapter 1 Installing MapGuide...
Installation Guide
Page 8
... can select this option even if you have an existing Apache installation. These versions are installed as part of the Web Server Extensions installation, and they do not interfere with any existing installations. 4 | Chapter 1 Installing MapGuide on Windows Also decide which web server you will use for application development, PHP, ASP.NET, or Java Server Pages (JSP). The bundled configuration option installs and configures the Apache HTTP Server, PHP, and Tomcat. Installing MapGuide Web Server Extensions Before installing MapGuide Web Server Extensions...
... can select this option even if you have an existing Apache installation. These versions are installed as part of the Web Server Extensions installation, and they do not interfere with any existing installations. 4 | Chapter 1 Installing MapGuide on Windows Also decide which web server you will use for application development, PHP, ASP.NET, or Java Server Pages (JSP). The bundled configuration option installs and configures the Apache HTTP Server, PHP, and Tomcat. Installing MapGuide Web Server Extensions Before installing MapGuide Web Server Extensions...
Installation Guide
Page 9
... use .NET 1.x as the development environment, you choose the bundled configuration option, select a port for the MapGuide virtual directories. If you must change this manually. The service name for details. Installing MapGuide Web Server Extensions | 5 See Configuring ASP.NET (page 25) for Apache is 8008, so it does not configure a web server. The IIS configuration option installs PHP for the Site Administrator, and configures IIS for details about configuration. You must install the Java JDK, and configure Tomcat...
... use .NET 1.x as the development environment, you choose the bundled configuration option, select a port for the MapGuide virtual directories. If you must change this manually. The service name for details. Installing MapGuide Web Server Extensions | 5 See Configuring ASP.NET (page 25) for Apache is 8008, so it does not configure a web server. The IIS configuration option installs PHP for the Site Administrator, and configures IIS for details about configuration. You must install the Java JDK, and configure Tomcat...
Installation Guide
Page 11
... custom setup, you can decide which components to install, and change the installation location for the Site Administrator pages, even if you specify the typical setup, the rest of the installation proceeds automatically, using default values for the installed components and locations. By default, PHP is not installed. NOTE If you select more than one API you should install this documentation. Installing MapGuide Web Server Extensions | 7 If you plan to develop MapGuide applications, you must configure Web Server Extensions manually...
... custom setup, you can decide which components to install, and change the installation location for the Site Administrator pages, even if you specify the typical setup, the rest of the installation proceeds automatically, using default values for the installed components and locations. By default, PHP is not installed. NOTE If you select more than one API you should install this documentation. Installing MapGuide Web Server Extensions | 7 If you plan to develop MapGuide applications, you must configure Web Server Extensions manually...
Installation Guide
Page 12
... IP address of your server in the following steps: ■ Install the Java JDK. ■ Set up redirections for Apache. ■ Set JAVA_HOME ■ Start Tomcat. Install using the default installation instructions. To install Java, download the JDK from java.sun.com. Setting Up Java for the Bundled Installation If you install the Apache/PHP/Tomcat bundle and choose Java as the development environment, you must also perform the following lines: 8 | Chapter 1 Installing MapGuide on Windows Edit...
... IP address of your server in the following steps: ■ Install the Java JDK. ■ Set up redirections for Apache. ■ Set JAVA_HOME ■ Start Tomcat. Install using the default installation instructions. To install Java, download the JDK from java.sun.com. Setting Up Java for the Bundled Installation If you install the Apache/PHP/Tomcat bundle and choose Java as the development environment, you must also perform the following lines: 8 | Chapter 1 Installing MapGuide on Windows Edit...
Installation Guide
Page 13
... Apache. Set the environment variable JAVA_HOME to the Tomcat bin directory and run startup.bat. 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 For the JDK 5.0, update 6, this is installed in different locations.
... Apache. Set the environment variable JAVA_HOME to the Tomcat bin directory and run startup.bat. 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 For the JDK 5.0, update 6, this is installed in different locations.
Installation Guide
Page 16
... Make the appropriate substitutions for path names in the instructions that follow. 12 | Chapter 2 Configuring MapGuide Web Server Extensions on the choices you made when installing MapGuide Web Server Extensions, you need to do any site-specific customization, it may have an existing installation of web server You must configure a web server manually. If you use the installer program, the default installation directory (InstallDir) is C:\Program Files\MapGuideOpenSource and the Web Server Extensions directory (WebDir) is not affected. Directory...
... Make the appropriate substitutions for path names in the instructions that follow. 12 | Chapter 2 Configuring MapGuide Web Server Extensions on the choices you made when installing MapGuide Web Server Extensions, you need to do any site-specific customization, it may have an existing installation of web server You must configure a web server manually. If you use the installer program, the default installation directory (InstallDir) is C:\Program Files\MapGuideOpenSource and the Web Server Extensions directory (WebDir) is not affected. Directory...
Installation Guide
Page 17
...; Set up virtual directories for use with IIS: ■ Install and auto-configure using the installer program. ■ Install using either PHP or ASP.NET to develop applications. If you use the installer, but configure the web server manually. Start the IIS administration console and create a new virtual directory. Configuration with IIS If you use IIS as reference, to see what configuration steps have the choice of the configuration steps for IIS This is required if you choose to configure the server manually.
...; Set up virtual directories for use with IIS: ■ Install and auto-configure using the installer program. ■ Install using either PHP or ASP.NET to develop applications. If you use the installer, but configure the web server manually. Start the IIS administration console and create a new virtual directory. Configuration with IIS If you use IIS as reference, to see what configuration steps have the choice of the configuration steps for IIS This is required if you choose to configure the server manually.
Installation Guide
Page 20
... you must set up an application mapping so IIS handles PHP files properly. Setting Up the PHP Association This is required if you will be running the Site Administrator on Windows You must use C:\Progra~1 in the path instead. You can choose to php5isapi.dll. For example, the default location is C:\Progra~1\MapGuideOpenSource\WebServerExtensions\Php\php5isapi.dll. 16 | Chapter 2 Configuring MapGuide Web Server Extensions...
... you must set up an application mapping so IIS handles PHP files properly. Setting Up the PHP Association This is required if you will be running the Site Administrator on Windows You must use C:\Progra~1 in the path instead. You can choose to php5isapi.dll. For example, the default location is C:\Progra~1\MapGuideOpenSource\WebServerExtensions\Php\php5isapi.dll. 16 | Chapter 2 Configuring MapGuide Web Server Extensions...
Installation Guide
Page 23
... you by IIS and you don't need to change it. Setting Up the Security Properties | 19 Note that the pool of ephemeral ports available for the FastCGI agent. Set the options as shown in IIS to disable the FastCGI agent and use a regular CGI agent instead. Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\FASTCGI] "MaxPostData"=dword:00000000 "CustomVars"=dword:00000000 "ThreadPoolSize"=dword:0000000a "BypassAuth...
... you by IIS and you don't need to change it. Setting Up the Security Properties | 19 Note that the pool of ephemeral ports available for the FastCGI agent. Set the options as shown in IIS to disable the FastCGI agent and use a regular CGI agent instead. Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\FASTCGI] "MaxPostData"=dword:00000000 "CustomVars"=dword:00000000 "ThreadPoolSize"=dword:0000000a "BypassAuth...
Installation Guide
Page 26
.... 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. If you use ASP.NET as your development language, set up the default document for the new virtual directory. Set the alias name to the default document list. 22 | Chapter 2 Configuring MapGuide Web Server Extensions on Windows Finally, set the...
.... 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. If you use ASP.NET as your development language, set up the default document for the new virtual directory. Set the alias name to the default document list. 22 | Chapter 2 Configuring MapGuide Web Server Extensions on Windows Finally, set the...
Installation Guide
Page 27
... for MapGuide applications or if you plan to use the Site Administrator. Set the name to the default document list. To configure PHP, edit the PHP configuration file, php.ini. The php.ini file is the same for the DWF viewer. The physical path is installed in InstallDir\WebServerExtensions\Php. Configuring PHP You must configure PHP if you plan to create a virtual directory for both directories. Repeat the steps above to use...
... for MapGuide applications or if you plan to use the Site Administrator. Set the name to the default document list. To configure PHP, edit the PHP configuration file, php.ini. The php.ini file is the same for the DWF viewer. The physical path is installed in InstallDir\WebServerExtensions\Php. Configuring PHP You must configure PHP if you plan to create a virtual directory for both directories. Repeat the steps above to use...
Installation Guide
Page 28
... File PHP checks for the key HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath. These modifications increase resource limits 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 Read the PHP documentation for you must ensure that determines which php.ini will be a Windows registry entry that the MapGuide version...
... File PHP checks for the key HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath. These modifications increase resource limits 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 Read the PHP documentation for you must ensure that determines which php.ini will be a Windows registry entry that the MapGuide version...
Installation Guide
Page 29
.... Click Add a new Web Service Extension. From the IIS Manager, select the Web Service Extensions folder. Configuring ASP.NET If you use the installer, ASP.NET should be loaded properly. Navigate to the mapguide site and open the IIS administration console. On the ASP.NET tab, check the version number. This ensures that you are using the correct version of ASP.NET. Add C:\Program Files\MapGuideOpenSource\WebServerExtensions\Php to Allowed. Adding the PHP Directory to...
.... Click Add a new Web Service Extension. From the IIS Manager, select the Web Service Extensions folder. Configuring ASP.NET If you use the installer, ASP.NET should be loaded properly. Navigate to the mapguide site and open the IIS administration console. On the ASP.NET tab, check the version number. This ensures that you are using the correct version of ASP.NET. Add C:\Program Files\MapGuideOpenSource\WebServerExtensions\Php to Allowed. Adding the PHP Directory to...
Installation Guide
Page 31
... in Configuring Apache to configure the web server manually, the installer installs and configures a version of the Apache installation. If you select the option to Use JSP (page 28). Ensure it looks like this document, but does not start the Apache server. Common Configuration Steps There are using JSP for development, ensure that the rewrite module is set as follows, or add the following to use PHP as necessary. By default, the configuration is enabled...
... in Configuring Apache to configure the web server manually, the installer installs and configures a version of the Apache installation. If you select the option to Use JSP (page 28). Ensure it looks like this document, but does not start the Apache server. Common Configuration Steps There are using JSP for development, ensure that the rewrite module is set as follows, or add the following to use PHP as necessary. By default, the configuration is enabled...
Installation Guide
Page 33
... directory of httpd.conf. Download Tomcat and the Tomcat-Apache connector from java.sun.com. 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. ■ Tomcat ■ The Apache/Tomcat connector. Install using the default installation instructions. You must also perform the following declarations at the end of your Java installation. Set...
... directory of httpd.conf. Download Tomcat and the Tomcat-Apache connector from java.sun.com. 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. ■ Tomcat ■ The Apache/Tomcat connector. Install using the default installation instructions. You must also perform the following declarations at the end of your Java installation. Set...
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...