Autodesk MapGuide Enterprise 2011 Update 2 Readme

Thank you for downloading Autodesk MapGuide Enterprise 2011 Update 2.

This readme contains the latest information regarding the installation and use of this update. It is strongly recommended that you read this entire document before you apply this update to your product. For reference, you should save this document to your hard drive or print a copy.

Contents

Who Should Install This Update?

Update 2 is for Autodesk MapGuide Enterprise 2011, in all languages, running on all supported operating systems. Update 2 contains all the updates released in Update 1, and can be applied to the following versions of product. Be sure to install the correct update for your software.

32-bit Product (Windows)

Update (Windows)

Autodesk MapGuide Enterprise Server 2011 or Update 1

MGEServer2011Update2.exe

Autodesk MapGuide Enterprise Web Extension 2011 or Update 1

MGEWeb2011Update2.exe

Autodesk MapGuide Studio 2011 or Update 1

MGStudio2011Update2.exe

 

32-bit Product (Linux)

Update (Linux)

Autodesk MapGuide Enterprise Server 2011 or Update 1

mapguideenterprise2011-server-2.2.0.6301-1.i386-rpm.bin

Autodesk MapGuide Enterprise Web Extension 2011 or Update 1

mapguideenterprise2011-webextension-2.2.0.6301-1.i386-rpm.bin

FDO

fdo-3.5.0.60.tgz

 

64-bit Product (Windows)

Update (Windows)

Autodesk MapGuide Enterprise Server 2011 or Update 1

MGEServer2011Update2.x64.exe

Autodesk MapGuide Enterprise Web Extension 2011 or Update 1

MGEWeb2011Update2.x64.exe

Return to Top

Supported Operating Systems

You can apply this update on the following operating systems.

Autodesk MapGuide Enterprise Server/Web Extension:

  • Microsoft® Windows Server® 2003 R2 (SP2), 32-bit
  • Microsoft® Windows Server® 2003 R2 (SP2), 64-bit
  • Microsoft® Windows Server® 2008 Enterprise (SP2), 32-bit
  • Microsoft® Windows Server® 2008 Enterprise (SP2), 64-bit
  • Microsoft® Windows Server® 2008 Enterprise R2, 64-bit
  • Red Hat® Enterprise Linux ES Version 5.3, 32-bit

Autodesk MapGuide Enterprise Studio:

  • Microsoft Windows XP Professional (SP3) Edition, 32-bit
  • Microsoft Windows XP Professional (SP2) Edition, 64-bit
  • Microsoft® Windows Vista® Ultimate (SP2), 32-bit
  • Microsoft® Windows Vista® Ultimate (SP2), 64-bit
  • Microsoft® Windows 7 Ultimate, 32-bit
  • Microsoft® Windows 7 Ultimate, 64-bit

Return to Top

Information for Windows Vista and Windows 7 Users

If you apply the Autodesk MapGuide Studio update while running Autodesk MapGuide Studio, it is recommended that you do not click the "Automatically close applications and attempt to restart them after setup is complete" option. Instead, close Autodesk MapGuide Studio manually, and press “Ignore” at the prompt. It is also recommended that you reboot your system after installing the update.

Return to Top

Primary Issues Resolved by This Update

·         Tile service – Tiled image files can be created correctly when GIF or JPG is specified as the Image Format. Previously, PNG file would be created for GIF format and no image file would be created for JPG format.

·         Performance – With default server configuration, a certain amount of concurrent users may generate excessive repository busy errors. To better support concurrent users, a solution is provided in this update by creating repository for each session. To achieve it, you can manually add the following parameters in serverconfig.ini file under install folder, e.g. C:\Program Files\Autodesk\MapGuideEnterprise2011\Server\Bin for Windows and opt/Autodesk/mapguideenterprise2011/server/bin/serverconfig.ini for Linux.

[ResourceServiceProperties]

SessionRepositoriesConfig          = FilePerSession or SingleFile

SessionRepositoriesLimit           = 200

With FilePerSession setting, MapGuide Server will create a repository for every single session and the maximum session number is 200.  Note that 200 is just a reference number, you can tune it according to the concurrent user requirement.

With SingleFile setting, MapGuide Server will use one repository for all sessions as before and SessionRepositoriesLimit parameter doesn’t take effect.

Note: Without defining the two parameters in serverconfig.ini, FilePerSession will be used by default and the limited session number is 200.

·         KML Export – Extra line breaks within one style section are removed during KML export, so objects can be displayed correctly afterwards.

·         KML Export – Point styles defined in MapGuide can be exported to KML file now thus shown correctly in the other applications like Google Earth.

·         FDO ODBC – ODBC initial connection to Oracle has been optimized to improve the performance by adding a new parameter (Xsm below) to connection string.

Driver={Oracle ODBC Driver};Dbq=[Insert database name];Xsm=[Insert schema name (optional)];Uid=;Pwd=;

·         Load Package – ‘Height’ and ‘Width’ properties are set for AreaText html control on Package Log web page. Now it behaves the same and looks better among all browsers.

·         Thread Safe – Thread safe issues for CS transformation, MFD Model Parser and MG Layer serializing are resolved.

·         Flexible Web Layout – Viewing flexible web layout with 250+ legends by Internet Explorer (IE) will cause error ‘Stop running this scripts’. One solution is provided to solve the issue by either increasing IE rest time or decreasing the number of legends IE requests each time. By applying this update, IE will take 1ms rest after requesting every 10 legends which is able to handle a flexible web layout with 250~300 legends without errors. If you need to handle more legends, please refer to the following instructions:

1. Stop the web service.

2. Open Legend.js under install folder e.g. C:\Program Files\Autodesk\MapGuideEnterprise2011\WebServerExtensions\www\fusion\widgets for Windows.

3. Find ‘RepeatingOperation:’ and you’ll see below setting:

           setTimeout(function() { op(instance, layer, range.styles[count], scale, bCheckBox); }, 1, [])

   Change the rest time to 2ms for example:

          setTimeout(function() { op(instance, layer, range.styles[count], scale, bCheckBox); }, 2, [])

4. Alternatively, find ‘updateLayer:’ in Legend.js where you’ll see:

          var ro = new this.RepeatingOperation(this.createAndAppendTreeItem, range.styles.length, 10);

   Change the legend number, for example:

var ro = new this.RepeatingOperation(this.createAndAppendTreeItem, range.styles.length, 8);

5. Regenerate fusionSF.js and replace the one in install folder e.g. C:\Program Files\Autodesk\MapGuideEnterprise2011\WebServerExtensions\www\fusion\lib.

6. Compress the new fusionSF.js to get fusionSF-compressed.js and replace the one in the same folder above.

7. Restart the web service.

·         Memory Leak - A memory leak issue when selecting large amount of objects is fixed by increasing the stack reserve size from 1M to 10M in Server.

Return to Top

General Installation Information

As you prepare to install Update 2, keep the following in mind:

Backup Repositories

Administrators should back up the current installations and repositories as per best practice.

Backup Configuration Files

Administrators should back up several configuration files, see more details below.

Windows

  • ..\Autodesk\mapguideenterprise2011\server\bin\serverconfig.ini
  • ..\Autodesk\mapguideenterprise2011\server\wfs\ogcwfsservice.config.awd (This file is normally modified using the Site Administrator.)
  • ..\Autodesk\mapguideenterprise2011\server\wms\ogcwmsservice.config.awd (This file is normally modified using the Site Administrator.)
  • ..\Autodesk\mapguideenterprise2011\webserverextensions\apache2\conf\httpd.conf
  • ..\Autodesk\mapguideenterprise2011\webserverextensions\apache2\conf\mapguide.conf
  • ..\Autodesk\mapguideenterprise2011\webserverextensions\php\lib\php.ini

Linux

·         opt/Autodesk/mapguideenterprise2011/server/bin/serverconfig.ini

·         opt/Autodesk/mapguideenterprise2011/server/wfs/ogcwfsservice.config.awd (This file is normally modified using the Site Administrator.)

·         opt/Autodesk/mapguideenterprise2011/server/wms/ogcwmsservice.config.awd (This file is normally modified using the Site Administrator.)

·         opt/Autodesk/mapguideenterprise2011/webserverextensions/apache2/conf/httpd.conf

·         opt/Autodesk/mapguideenterprise2011/webserverextensions/apache2/conf/mapguide.conf

·         opt/Autodesk/mapguideenterprise2011/webserverextensions/php/lib/php.ini

Stop Services

Administrators should close all applications especially any MapGuide Enterprise related services e.g. MapGuide Enterprise Server Service and IIS/Apache/Tomcat before applying the update.

Administrative Privileges

In order to apply the update, you must have administrative privileges to install and uninstall products.

Reboot

After installation, it is recommended to reboot your system even if not prompted.

 Return to Top

Installation Instructions

From the Product Support website, download the appropriate update files for your operating system. Copy the update files into a temporary folder on your computer and run the files as described below.

Note: The Windows update is simply an update to a subset of files. The Linux update is a full install.

Installing the Server/Web Update on Windows

1.  Download the following update files and save to any folder:

  • MGEServer2011Update2.exe or MGEServer2011Update2.x64.exe
  • MGEWeb2011Update2.exe or MGEWeb2011Update2.x64.exe

2.  Stop the Autodesk MapGuide Enterprise 2011 Service and the Web Server services. 

3.  Run the update files that you downloaded in step 1.

4.  Replace any overwritten configuration files listed in previous section.

5.  Restart your services and connect to the MapGuide Enterprise Site Administrator to confirm things are working.

Installing the Server/Web/FDO Update on Linux

1.  Download the update files and save them to any folder like /tmp:

  • mapguideenterprise2011-server-2.2.0.6301-1.i386-rpm.bin
  • mapguideenterprise2011-webextension-2.2.0.6301-1.i386.rpm.bin
  • fdo-3.5.0.60.tgz

Note: Make sure that you download and install the correct Server and Web Extension update files for your language, e.g. German, Japanese, French, etc. For example, if you are using the German version of MapGuide Enterprise, you should download the files mapguideenterprise2011deu-server-2.2.0.6301-1.i386.rpm and mapguideenterprise2011deu-webextension-2.2.0.6301-1.i386.rpm. The FDO update file is not language-specific.

2.  Stop the MapGuide Enterprise 2011 Service, the Apache Server and the Tomcat Server if applicable.

3.  Backup the Repositories folder from the /opt/Autodesk/mapguideenterprise2011/server/ folder to another directory outside the Autodesk subdirectories such as /tmp. The new install should not overwrite the

     current repository, but the backup is just a precaution.

4.  Confirm the version of MGE installed by executing:

rpm -qa | grep mapguide

5.  Uninstall the MapGuide 2011 Web Extensions by executing:

rpm -e mapguideenterprise2011-webextension-2.2.0.6001-1

6.  Uninstall the MapGuide 2011 Server by executing:

rpm -e mapguideenterprise2011-server-2.2.0.6001-1

      Note: Modify the version numbers above as needed. For example, when MGE2011 Update 1 is not installed, the version should be 2.2.0.5305.

7.  Navigate to /usr/local/fdo-3.5.0 and uninstall FDO by executing:

./uninstall

8.  Navigate to the folder where the new install files were copied to.

9.  Extract the FDO files by executing:

tar -xzvf fdo-3.5.0.60.tgz

10. cd to the fdo-3.5.0.60 folder and execute:

./install

11. To extract the Server and Web Extension files execute the following:

./ mapguideenterprise2011-server-2.2.0.6301-1.i386-rpm.bin

./ mapguideenterprise2011-webextension-2.2.0.6301-1.i386-rpm.bin

      Enter ‘Yes’ when prompted to accept the license agreements.

12. To install the Server execute the following:

rpm -ivh mapguideenterprise2011-server-2.2.0.6301-1.i386.rpm

13. To install the Web Extensions execute the following:

rpm -ivh mapguideenterprise2011-webextension-2.2.0.6301-1.i386.rpm

14. Replace any overwritten configuration files as outlined in previous section.

15. Restart the services and connect to the MapGuide Enterprise Site Administrator to confirm things are working.

Installing the Studio Update on Windows

1.  Download the update file and save it to any folder.

  • MGStudio2011Update2.exe

2.  Exit Autodesk MapGuide Studio 2011. 

3.  Run the update file you downloaded in Step 1.

4.  Restart Autodesk MapGuide Studio 2011.

Uninstalling the Update

Windows XP and Windows Server 2003

1.    From the Start menu (Windows), click Settings > Control Panel.

2.    In Control Panel, click Add or Remove Programs.

3.    In the Add or Remove Programs window, select the Show Updates option.

4.    Find the appropriate update in the list of programs. Click Remove.

Windows Vista, Windows 7 and Windows Server 2008

1.    From the Start menu (Windows), click Control Panel.

2.    Click Programs.

3.    Click Programs and Features.

4.    In the Programs and Features window, in the left pane, click View Installed Updates.

5.    Find the appropriate update in the list of updates. Click Uninstall.

Return to Top

Copyright © 2011 Autodesk, Inc.