Installation Guide
Page 2
... Ellson ([email protected]). Portions of the Geographic Survey Institute, to be installed and used in , and the foregoing license shall not apply to : (i) copy, distribute, display and perform the work is © Crown Copyright 1997. Notwithstanding the foregoing, you shall acquire no rights in this software product (Approval No.: 646 issued by Thomas Boutell. You are copyright ©...
... Ellson ([email protected]). Portions of the Geographic Survey Institute, to be installed and used in , and the foregoing license shall not apply to : (i) copy, distribute, display and perform the work is © Crown Copyright 1997. Notwithstanding the foregoing, you shall acquire no rights in this software product (Approval No.: 646 issued by Thomas Boutell. You are copyright ©...
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
You can act as support servers that make up MapGuide Open Source: ■ MapGuide Server ■ MapGuide Web Server Extensions The installer programs are available from source, refer to Building and Configuring MapGuide on Windows for instructions. One computer must supply the IP address of the site functions. 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 two...
You can act as support servers that make up MapGuide Open Source: ■ MapGuide Server ■ MapGuide Web Server Extensions The installer programs are available from source, refer to Building and Configuring MapGuide on Windows for instructions. One computer must supply the IP address of the site functions. 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 two...
Installation Guide
Page 8
... the installer program MgWebServerExtensionsSetup.exe. 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). Choose a configuration type. You can select this option even if you will use for your site, Apache HTTP Server or Internet Information Services (IIS...
... the installer program MgWebServerExtensionsSetup.exe. 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). Choose a configuration type. You can select this option even if you will use for your site, Apache HTTP Server or Internet Information Services (IIS...
Installation Guide
Page 9
... the IIS configuration option, specify the development environment, either PHP or Java. See Configuring ASP.NET (page 25) for details about configuration. See Configuring MapGuide Web Server Extensions on port 80. If you must change this manually. The service name for Apache is 8008, so it does not configure a web server. If you choose Java as the default environment for the MapGuide virtual directories. You must install the Java JDK, and configure Tomcat. If...
... the IIS configuration option, specify the development environment, either PHP or Java. See Configuring ASP.NET (page 25) for details about configuration. See Configuring MapGuide Web Server Extensions on port 80. If you must change this manually. The service name for Apache is 8008, so it does not configure a web server. If you choose Java as the default environment for the MapGuide virtual directories. You must install the Java JDK, and configure Tomcat. If...
Installation Guide
Page 11
... to develop MapGuide applications, you plan to use PHP as a development environment. Also by default, the API documentation is installed for any component. NOTE If you select more than one API 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. If you should install this documentation. Installing MapGuide Web Server Extensions | 7 If you must configure Web Server Extensions manually.
... to develop MapGuide applications, you plan to use PHP as a development environment. Also by default, the API documentation is installed for any component. NOTE If you select more than one API 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. If you should install this documentation. Installing MapGuide Web Server Extensions | 7 If you must configure Web Server Extensions manually.
Installation Guide
Page 12
Install using the default installation instructions. To install Java, download the JDK from java.sun.com. Edit the Apache httpd.conf file. 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 Apache. ■ Set JAVA_HOME ■ Start Tomcat. Setting Up Java for the Bundled Installation If you install the Apache/PHP...
Install using the default installation instructions. To install Java, download the JDK from java.sun.com. Edit the Apache httpd.conf file. 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 Apache. ■ Set JAVA_HOME ■ Start Tomcat. Setting Up Java for the Bundled Installation If you install the Apache/PHP...
Installation Guide
Page 13
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 default installation, Tomcat is C:\Program Files\Java\jdk1.5.0_06 Different versions of your Java installation. For the JDK 5.0, update 6, this is installed in different locations. Set the environment variable JAVA_HOME to the Tomcat bin directory and run startup.bat. Redirect /mapguide/mapviewerajax...
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 default installation, Tomcat is C:\Program Files\Java\jdk1.5.0_06 Different versions of your Java installation. For the JDK 5.0, update 6, this is installed in different locations. Set the environment variable JAVA_HOME to the Tomcat bin directory and run startup.bat. Redirect /mapguide/mapviewerajax...
Installation Guide
Page 16
... 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 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\MapGuideOpenSource\WebServerExtensions\www Make the appropriate substitutions for developing your own applications. Existing installations of these components are three installation methods, with some variations: Installation Method Description...
... 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 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\MapGuideOpenSource\WebServerExtensions\www Make the appropriate substitutions for developing your own applications. Existing installations of these components are three installation methods, with some variations: Installation Method Description...
Installation Guide
Page 17
... | 13 If you do any more configuration. NOTE This document contains screenshots showing the IIS Administration Console version 5.1. Many of using the installer program, but choose to do not need to configure a web server manually, you want to develop applications. There are the same. Configuration with IIS: ■ Install and auto-configure using the installer program. ■ Install using either case, if you must install PHP. Start the IIS administration console and create a new virtual directory.
... | 13 If you do any more configuration. NOTE This document contains screenshots showing the IIS Administration Console version 5.1. Many of using the installer program, but choose to do not need to configure a web server manually, you want to develop applications. There are the same. Configuration with IIS: ■ Install and auto-configure using the installer program. ■ Install using either case, if you must install PHP. Start the IIS administration console and create a new virtual directory.
Installation Guide
Page 20
... path is different. If you install MapGuide to the default location under C:\Program Files, you will be using PHP as an ISAPI extension. Setting up an application mapping so IIS handles PHP files properly. For CGI, the executable is InstallDir\WebServerExtensions\Php\php-cgi.exe For ISAPI, the executable is C:\Progra~1\MapGuideOpenSource\WebServerExtensions\Php\php5isapi.dll. 16 | Chapter 2 Configuring MapGuide Web Server Extensions on...
... path is different. If you install MapGuide to the default location under C:\Program Files, you will be using PHP as an ISAPI extension. Setting up an application mapping so IIS handles PHP files properly. For CGI, the executable is InstallDir\WebServerExtensions\Php\php-cgi.exe For ISAPI, the executable is C:\Progra~1\MapGuideOpenSource\WebServerExtensions\Php\php5isapi.dll. 16 | Chapter 2 Configuring MapGuide Web Server Extensions on...
Installation Guide
Page 23
... increase the number of available ports will be used up before enough ports have been freed. To do this, set the security properties, go to change it. Setting Up the Security Properties | 19 Refer to the Windows Registry. Set the options as shown in IIS to mapagent.exe if necessary. Add the following to the Microsoft support note at http://support.microsoft.com/default.aspx?scid...
... increase the number of available ports will be used up before enough ports have been freed. To do this, set the security properties, go to change it. Setting Up the Security Properties | 19 Refer to the Windows Registry. Set the options as shown in IIS to mapagent.exe if necessary. Add the following to the Microsoft support note at http://support.microsoft.com/default.aspx?scid...
Installation Guide
Page 26
... name 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\mapviewerphp. If you use PHP as your development language, set the physical...
... name 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\mapviewerphp. If you use PHP as your development language, set the physical...
Installation Guide
Page 27
... installed in InstallDir\WebServerExtensions\Php. The default documents are as a development language for MapGuide applications or if you plan to use it as follows: ■ For PHP development, add dwfviewer.php to the default document list. ■ For ASP.NET development, add dwfviewer.aspx to use the Site Administrator. Set the name to create a virtual directory for both directories. To configure PHP, edit the PHP configuration file, php.ini. Configuring PHP You must configure...
... installed in InstallDir\WebServerExtensions\Php. The default documents are as a development language for MapGuide applications or if you plan to use it as follows: ■ For PHP development, add dwfviewer.php to the default document list. ■ For ASP.NET development, add dwfviewer.aspx to use the Site Administrator. Set the name to create a virtual directory for both directories. To configure PHP, edit the PHP configuration file, php.ini. Configuring PHP You must configure...
Installation Guide
Page 28
... for the key HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath. cgi.force_redirect = 1 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 must ensure that determines which php.ini will be processed. Identifying the Correct php.ini File PHP checks for...
... for the key HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath. cgi.force_redirect = 1 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 must ensure that determines which php.ini will be processed. Identifying the Correct php.ini File PHP checks for...
Installation Guide
Page 29
... use the installer, ASP.NET should be loaded properly. Older versions will not work. Add C:\Program Files\MapGuideOpenSource\WebServerExtensions\Php to run PHP as the required file. Configuring Web Service Extensions for IIS 6 IIS 6, running on Windows Server 2003, requires some additional configuration to enable PHP and the Map Agent to the system PATH environment variable. Set the extension status to Allowed. From the IIS Manager, select the Web Service Extensions folder. Configuring ASP...
... use the installer, ASP.NET should be loaded properly. Older versions will not work. Add C:\Program Files\MapGuideOpenSource\WebServerExtensions\Php to run PHP as the required file. Configuring Web Service Extensions for IIS 6 IIS 6, running on Windows Server 2003, requires some additional configuration to enable PHP and the Map Agent to the system PATH environment variable. Set the extension status to Allowed. From the IIS Manager, select the Web Service Extensions folder. Configuring ASP...
Installation Guide
Page 31
... Common Configuration Steps | 27 By default, the configuration is enabled. If you have been split over multiple lines in Setting Up Java for the configuration of the Apache installation. ScriptAlias /php/ "C:/Program Files/MapGuideOpenSource/ WebServerExtensions/Php/" Action application/x-httpd-php "/php/php-cgi.exe" AddType application/x-httpd-php .php ■ In the Dynamic Shared Object Support section, ensure that you select the option to configure the web server manually, the installer installs and configures a version of...
... Common Configuration Steps | 27 By default, the configuration is enabled. If you have been split over multiple lines in Setting Up Java for the configuration of the Apache installation. ScriptAlias /php/ "C:/Program Files/MapGuideOpenSource/ WebServerExtensions/Php/" Action application/x-httpd-php "/php/php-cgi.exe" AddType application/x-httpd-php .php ■ In the Dynamic Shared Object Support section, ensure that you select the option to configure the web server manually, the installer installs and configures a version of...
Installation Guide
Page 33
... Use JSP | 29 Install using the default installation instructions. 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. Download Tomcat and the Tomcat-Apache connector from java.sun.com. You must also perform the following declarations at the end of your Java installation. Configuring Apache to the root directory of httpd.conf. Download the Java...
... Use JSP | 29 Install using the default installation instructions. 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. Download Tomcat and the Tomcat-Apache connector from java.sun.com. You must also perform the following declarations at the end of your Java installation. Configuring Apache to the root directory of httpd.conf. Download the Java...
Installation Guide
Page 35
... /mapguide/mapviewerjava/* worker1 Redirect /mapguide/mapviewerajax/ http://:/mapguide/mapviewerjava/ajaxviewer.jsp Redirect /mapguide/mapviewerdwf/ http://:/mapguide/mapviewerjava/dwfviewer.jsp Connector Configuration Rename the pre-built Apache/Tomcat connector binary to Use JSP | 31 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. The original file includes the version number...
... /mapguide/mapviewerjava/* worker1 Redirect /mapguide/mapviewerajax/ http://:/mapguide/mapviewerjava/ajaxviewer.jsp Redirect /mapguide/mapviewerdwf/ http://:/mapguide/mapviewerjava/dwfviewer.jsp Connector Configuration Rename the pre-built Apache/Tomcat connector binary to Use JSP | 31 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. The original file includes the version number...
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...