Autodesk MapGuide Release 6.5 Service Pack 1 Readme

Each Autodesk® product is subject to the terms detailed in the license agreement that accompanies it. Before proceeding, please read and accept the terms in the license text, which you will see during the installation procedure.

For additional information about each of the Autodesk MapGuide® products, refer to the Autodesk MapGuide page on the Autodesk Web site at

Table of Contents

Installation Instructions

Known Issues and Solutions

Support for AutoCAD 2007 Format DWG Files


Raster Workshop

SDF Loader

Dynamic Authoring Toolkit


Symbol Manager


Documentation Errata

Corrected Issues

Installation Instructions

For installation instructions, including platform and system requirements, please refer to the Autodesk MapGuide Installation Card (MGInstallationInstructions.pdf) included on the Autodesk MapGuide installation CD. You should reboot your computer after installing Autodesk MapGuide products.

Known Issues and Solutions

The following are known issues and solutions for Autodesk MapGuide Release 6.5 Service Pack 1.

Support for AutoCAD 2007 Format DWG Files

Using AutoCAD® 2007 Format DWG files

In Autodesk MapGuide Author, you can create a new map layer by using the Autodesk DWG Data Source option and selecting a DWG file in AutoCAD 2007 format. Refer to the server section of this readme for more details.

Browsing a Virtual Directory of MWF Files Using Microsoft Internet Explorer 7

An MWF file can be viewed in the ActiveX viewer by browsing a virtual directory and clicking on a map. Under certain conditions, Microsoft IE7 may prevent the map from loading. Two errors can occur referring to “invalid character” and “object expected”. These errors are only visible via the error icon in the lower-left corner of the browser. It appears security settings in Microsoft IE7 have changed such that, if the URL to the server is not added to the browser's Trusted Site list, the ActiveX control will not load. On Microsoft Windows 2003 Server, a message indicating that the site should be added to the Trusted Site list may appear. However, the same message may not appear on Microsoft Windows XP. If enabled, the security setting "Allow active content to run in files on My Computer" (found under Tools\Internet Options\Advanced tab) will block the loading of the control. Disabling this setting will allow the map to load.

The issue is tied to the existence of a registry key \\HKEY_CURRENT_USER\Software\Microsoft\Internet_Explorer\Main\FeatureControl\FEATURE_LOCALMACHINE_LOCKDOWN\iexplore.exe=0. This entry is created if you change the Advanced settings for Security. Initially, this entry may not exist as part of the install of Microsoft IE7. If it does exist, it may default to 1. Allowing active content will toggle the entry to 0 and block the control. Restoring the defaults for the Advanced settings resets the entry to 1.

The ActiveX control still works if it is embedded in an HTML page using the CLSID, so web applications using the control should be unaffected.

Support for FDO Layers in DWG 2007 Format Files

The new FDO layers in Autodesk Map® 2007 files are not supported.


Some Autodesk MapGuide Author Preferences Are Reset by Installation

When you install Autodesk MapGuide Author, the following Preference settings are reset to their default values:

Before installing, you should make note of your Preferences and then reset them as needed after installing.

Duplicate Theme Names in a Single DWG Layer

If you have more than one theme defined for a DWG layer and these themes have identical names but different categories, you can only access one of the themes. Autodesk MapGuide Server returns the first theme that it encounters with the duplicate name.

Queries or Themes that use DWGs with Duplicate Link Template Names

If a MapGuide query or theme uses a Project DWG from Autodesk MapTM, the DWGs in the project should not have duplicate link template names. If the link templates attached to the DWGs have the same name but point to different data sources (UDL files) or to different database files or tables, you cannot access any link template data that is associated with the objects returned by the query or theme. There are no problems if multiple DWGs use the same link template as long as it points to the same data source (with the same name and in the same location.)

For more information about setting up link templates, see the Autodesk Map documentation.

Blank Name Fields May Result in Incomplete or Blank MapTips

Databases or database drivers that treat blank fields as NULL values or that concatenate strings with NULL values may truncate MapTips or not display MapTips at all.

The following example includes a NULL value in the Name Field for a MapTip.

"''Owner : '+[FNAME]+' '+'[INITIAL]'+' '+[LNAME]"

The INITIAL field is NULL. As a result, the MapTip ends after the owner's first name or the point of the NULL value (the last name is not displayed).

There are workarounds for NULL values with some data providers. The following examples show how Access, Oracle, and SQLServer implement NULL substitution:

Access: 'Owner : ' & FNAME & ' ' & IIF(ISNULL(INITIAL),'',INITIAL) & ' ' & LNAME

Oracle: 'Owner : ' || FNAME || ' ' || NVL(INITIAL, '') || ' ' || LNAME

SQLServer: 'Owner : ' + FNAME + ' ' + COALESCE(INITIAL,'') + ' ' + LNAME

Please note that not all databases or database drivers behave similarly. Some databases have no problems displaying MapTips because they treat NULL values as an empty string.

For more information on creating MapTips, see "Viewing Map Information" in Autodesk MapGuide Help.

Creating a Layer from a DWF File Sheet

DWFs are intended to be used as background images, in much the same way that DWG files were used in previous releases. Because DWFs are essen­tially electronic plots, the level of precision depends on the plot settings. This is not an issue for most maps. However, if your application demands a higher degree of precision, you can increase the size of the virtual DWF paper by setting the appropriate DPI and paper size before you publish to DWF.

The following link goes to an article that explains DWF precision, why it is not the same as the DWG, and how to improve the precision:

Raster Workshop

Raster Workshop Does Not Process Multiple Images

When converting multiple images to TIFF format, you must convert one image at a time. Raster Workshop does not support multiple-image processing.

SDF Loader

Support for AutoCAD 2007 Format DWG Files

The SDF Loader uses a process similar to the one described in the Server section (below) when reading a DWG 2007 file. A temporary file exists during processing. The original DWG file will remain unchanged after the process is completed.

Exceeding Maximum Number of Vertices in a Feature

If you convert a file containing a polyline or polygon feature that has more than 65,535 vertices, SDF Loader generalizes the feature to use no more than 65,535 vertices. The maximum vertices for a feature made up of polypolylines or polypolygons is 2,097,152. Also the number of primitives in a polypolyline or a polypolygon cannot exceed 65,535. Generalization will also not be performed on a polypolyline or polypolygon when the number of vertices exceeds 2,097,152.

Updating and Repairing the SDF Loader Installation

You cannot use the Add/Remove Programs Control Panel to update or repair an SDF Loader installation. To update or repair a SDF Loader Installation, run the Autodesk MapGuide installation CD.

Generating CSV Files from DWGs

The SDF Loader has the ability to extract Point/Symbol and Text data from a DWG to a CSV (comma-delimited text) file. You can use the CSV file to populate a database table which can then be used to create point and text layers in Autodesk MapGuide. When the SDF Loader creates point and text CSV files, it also creates polygon and polyline line and fill style CSV files. Autodesk MapGuide does not read CSV files with polygon and polyline line and fill style data.

Dynamic Authoring Toolkit

Issue Deleting Temporary Files

The Dynamic Authoring Toolkit cannot delete temporary files from the host machine where a web or stand-alone application instantiates the Dynamic Authoring Toolkit unless the users or group who access the host machine have modification rights for the Windows temp folder. To apply modification rights to the temp folder, right-click the temp folder, click Properties, select the Security tab, and then select the Allow Modify option for the selected or added user or group.

The path of the folder for temporary files is specified by the TMP, TEMP, or USERPROFILE environment variable. The location of the folder depends on the Windows operating system. It can vary from c:\temp, c:\windows\temp, c:\winnt\temp, c:\Documents and Settings\Default User\Local Settings\temp, and so on.


Support for AutoCAD 2007 Format DWG Files

To use AutoCAD 2007 Format DWG files, you must add the DWG files to an existing ADL referenced directory or create a new data source using the Server Admin. The following describes the process used to access the files:

Multiple Paths Not Supported for DWG, SHP, and SDF Data Sources

Multiple search paths for DWG, SDF, and SHP are no longer supported. If you have existing Autodesk MapGuide applications that use data sources with multiple paths, you will need to migrate this data to work with Autodesk MapGuide 6.5. To do this, you can either move the data from the multiple path locations to one common location, or create separate data sources for the multiple-path data and reference these new data sources.

Certain DWG Files May Cause Autodesk Provider for DWG to Hang and Fill Up the Application Log

If a DWG file contains a block of text and that was inserted at a very small scale factor (for example, 0.01), Autodesk Provider for DWG may hang and fill up the application log.

To work around this issue and get Autodesk MapGuide Server back on line:

  1. Stop and restart the Server Service in the Windows Control Panel.
  2. Clear the Application Log.
  3. Put the Autodesk MapGuide Server back on line using the Autodesk MapGuide Server Admin.

To prevent this problem from happening again:

Find and remove all instances of small blocks of text in the DWG file.

Updating and Repairing an Autodesk MapGuide Server Installation

You cannot use the Add/Remove Programs Control Panel to update or repair an Autodesk MapGuide Server installation. To update or repair an Autodesk MapGuide Server installation, run the Autodesk MapGuide installation CD.

Upgrading from a Previous Version

If you are upgrading to Autodesk MapGuide Server 6.5, and you still have a previous version on your computer, be sure to install the new version to a different folder.

Coexistence of Autodesk MapGuide Server 6.5 and Other Autodesk Products

Autodesk MapGuide Server 6.5 can coexist on the same machine as other Autodesk products, including:

These products share certain architectural components, including spatial data providers. Because of this, please follow these guidelines when installing or uninstalling these products:

DWG Files Locked by Autodesk MapGuide Server

When a request is made to the Autodesk MapGuide Server for an Autodesk DWG layer, the DWG data file is locked to any application attempting to access it, including another Autodesk MapGuide Server. In general, you should make edits to your DWG files prior to publishing them with Autodesk MapGuide. If you need to update a DWG file that you have already set up as an Autodesk MapGuide data source, do the following:

  1. In Autodesk MapGuide Server Admin, choose Edit > Properties.
  2. Click the Data Sources tab.
  3. Clear the Available check box next to the DWG data source you need to edit.

After you edit and save your DWG file, be sure to put the data source back online by selecting the Available check box in the Autodesk MapGuide Server Admin Data Sources tab.

Invalid MrSID Files Can Cause Autodesk MapGuide Server to Hang

Due to a known issue with the MrSID decompression SDK, Autodesk MapGuide Server may eventually hang if an invalid MrSID image file is used. Autodesk MapGuide Server recognizes a file as being a MrSID format file if the first four characters in the file are “msid.”

Possible Server Hang Problem and Enabling Server Auto-Restart

In the unlikely event that the MapGuide Server hangs in your application, you can activate the auto-restart mechanism. By default, the auto-restart mechanism is disabled. To activate it, use regedit to add two registry keys as follows in HKEY_LOCAL_MACHINE\SOFT- WARE\Autodesk\MapGuide Server\6.5\Parameters:

Health Restart Enabled must be a DWORD value. A zero (0) disables this features and a non-zero value enables it. Typically, set this key to 1 to enable the feature. Health Restart Threshold must be a DWORD value in the range 0 to 100. The higher this number is, the more frequently the server will restart. A 0 value indicates to restart Autodesk MapGuide Server when it is completely lifeless. Do not set this entry to higher than 50 or the possibility of restarting a healthy server increases dramatically. Note also that there is no range validation for this entry.

Autodesk MapGuide Server Registries Are Reset by Installation

When you install Autodesk MapGuide Server, the following registry settings are set to their default values:

Issues Converting to MWX with Some Regional Settings

If your Windows Regional Options are set to use a comma (,) for the Decimal Symbol and a period (.) for the Digit Grouping Symbol, you will not be able to save and then reload an MWX file in Autodesk MapGuide Author.

To save and reload MWX files in Autodesk MapGuide Author, set your Regional Options as follows:

Autodesk MapGuide Server Stops Writing to Application Event Log when Stopped and Started Using Server Admin

If you manually stop and then restart Autodesk MapGuide Server using Autodesk MapGuide Server Admin, all subsequent Viewer requests result in an entry in the system's Application Event Log, and no tracking data is saved. To avoid this issue, do the either of the following:

Symbol Manager

Creating Symbols from TrueType Fonts for Use with Java Edition Viewer and Autodesk MapGuide LiteView

If you are authoring maps for display with either the Autodesk MapGuide Viewer Java Edition or Autodesk MapGuide LiteView, and you are using TrueType fonts as symbols, be sure to select the Add By Rendering TrueType Fonts As Graphics option when you create the symbol using Symbol Manager. If you do not select this option, the TrueType fonts will be displayed at a very small size.


Some Viewer Keyboard Shortcut Keys Do Not Work on Apple Macintosh Computers

The following Autodesk MapGuide Viewer keyboard shortcut keys do not work on Apple Macintosh computers running MacOS 9 with Internet Explorer 5.0:

Plug-In Viewer Needs http:// in URL Links

Autodesk MapGuide Viewer Plug-In needs http:// at the beginning of URL links to correctly locate the Autodesk MapGuide Server and specified maps.

Java Edition Viewer Missing Dialog Box Help Buttons

Autodesk MapGuide Viewer Java Edition is missing Help buttons for dialog boxes, such as Preference, Zoom Goto, and Page Setup, and so on. To get dialog box Help, either select the Help (?) icon or right-click and select Help > Help Contents, then navigate to the appropriate dialog box topic.

Java Edition Viewer File Install

On some operating systems, in particular the Japanese OS, Autodesk MapGuide Viewer Java Edition installation may appear to fail. You may see a blank Autodesk MapGuide window at the end of installation, and when you hold the cursor over the window, the status bar reads:

load: com.autodesk.mgjava.MGMapApplet can't be instantiated.

However, the installation has in fact succeeded, and Autodesk MapGuide Viewer Java Edition will run.

Downloaded Java Edition Viewer Appears as “Damaged”

After installing the Autodesk MapGuide Viewer Java Edition, you may notice that in the Downloaded Program Files folder, the status column for the Autodesk MapGuide Viewer, Java Edition shows “Damaged”. This is caused by a problem with Internet Explorer. After you reboot the machine, the Java Edition will be shown as “Installed”.

Printing with the Autodesk MapGuide Viewer Java Edition

Java 2 version 1.4 automatically detects the page dimensions of a map when printing from the Viewer. If you are running an earlier version of Java 2, you will need to specify the page dimensions in the Page Setup dialog box before you print.

Internet Explorer 6 SP1 Disables Java Edition Viewer Reporting Feature

If you install Internet Explorer 6 Service Pack 1, the reporting feature of Autodesk MapGuide Viewer Java Edition is disabled when targeting a frame on the same page as the viewer. To avoid this problem, change the application to show reports in a separate window. If you cannot change the application, you can find generated reports as HTML files in C:\Documents and Settings\yourloginname\Local Settings\Temp.

Autodesk MapGuide Viewer Java Edition with Unsigned Wrapper Applets under the Java 2 Security Model

The MapGuide Viewer Java Edition applet requires more permissions than those currently available in the Java Applet "sandbox." All user-defined unsigned Wrapper Applets under the Java 2 Security Model will encounter various security violations when directly invoking the MapGuide Viewer Java Edition APIs. The following are some examples of these violations:

  1. Invoking setUrl API with a remote address leads to a security violation with insufficient socket permissions.
  2. Invoking copyUrl API leads to an exception thrown with access denied.
  3. Invoking printDlg API opens a dialog box asking for printing permissions.

These security violations are caused by insufficient privileges assigned to these unsigned Wrapper Applets. To gain full permission under the Java 2 Security Model while encapsulating the MapGuide Viewer Java Edition Applet, the specific Wrapper Applet has to be either:

The sample applet (Example6.class) file in the MapGuideDocumentation6.5>ViewerAPIHelp>JavaEdition>examples>classes folder provides an example of a digitally signed Wrapper Applet.

Autodesk MapGuide Viewer Java Edition Does Not Install without the Microsoft Java Virual Machine or the Sun Java Runtime Environment

You must have the Microsoft Java Virtual Machine or the Sun Java Runtime Environment installed on your computer before you can install the Autodesk MapGuide Viewer Java Edition. If you click the Start Install button on the Autodesk MapGuide Viewer Java Edition Installation page and nothing happens, make sure you have installed either the Microsoft Java Virtual Machine or the Sun Java Runtime Environment and try again.

Autodesk MapGuide Viewer Java Edition on Mac OS X

Under stressful conditions, Microsoft Internet Explorer 5 may hang on the Mac OS X operating system. If this occurs, restart both Internet Explorer and the Autodesk MapGuide View Java Edition.

Documentation Errata

The following are known errata for Autodesk MapGuide documentation.

Autodesk MapGuide User’s Guide

Autodesk MapGuide Help

Autodesk MapGuide Viewer API Help

Autodesk MapGuide SDF Loader Help

Corrected Issues

This section describes corrected issues included in this service pack.

655680 Issues with Coordinate Transformations

When transforming Lat Long to NAD27 Georgia State Planes West, it was possible for layers not to appear or to appear incorrectly. This issue has been resolved.

653500 SDF Data Rendering Incorrectly

In some cases, SDF data was rendering incorrectly and the extents were not being read properly. This issue has been resolved.

633069 Unnecessary Files Being Installed with Autodesk MapGuide Server 6.5

Unnecessary files were being installed with Autodesk MapGuide Server 6.5. The following files will no longer be installed with the server: obdxAuto16enu_MG, mpolygoncom16enu_MG, odbxBrep16, odbxImage_core16.

612673 Accessing the MgPrintInfo object

You can now access the MgPrintInfo object in the Active-x API without having to print anything.

609692 Issues Displaying Greek Characters Correctly

The issue causing Greek characters to display incorrectly has been resolved.

608807, 470319 Adding ECW files to Raster Image Catalogs

The issue with adding ECW files to Raster Image Catalogs (RICs) has been resolved. ECW files can now be added to RICs using Autdesk Raster Workshop.

603715 Issues with Missing Data when Datum Shift Enabled

In some cases, data would be missing after zooming. This was related to an issue with datum shifts. The issue has now been resolved.

600308 Datum Shift Issues with Certain Oracle Coordinate Systems

Refer to the Oracle Datum Shifts White Paper, available from Product Support, for a description of how to resolve this issue.

583398 Issues Displaying Geometry with SDP Provider

In some case, geometry imported with the SDP provider was displaying incorrectly. This issue has been resolved.

574689 Hardcoded strings in Java Edition installation applet

This was a localization issue. It has been resolved.

572823 Displaying Oracle Arcs Generated From Map 2005 DWGs

Displaying Oracle arcs generated from an Autodesk Map 2005 DWG could result in a server error. This issue has been resolved.

572792, 571369 Opening MWX Files

Opening MWX files with 2 or more TextLayerStyles or line styles could result in an error message. This issue has been resolved.

558148 Zooming With Mouse Wheel

Zooming in using the mouse wheel could cause the Autodesk MapGuide Viewer to enter a continuous busy state, requiring the user to right-click and choose Stop to end it. This issue has been resolved.

538141 Autodesk MapGuide Author Hangs When Attempting to Save a Map to an Unavailable Remote Location

After a possible network timeout period, you may receive errors indicating the filename is invalid (which happens during a Save As to the unavailable location) or the MWF cannot be saved (which happens during a Save). Executing a Save As to a new location will allow you to save your work.

509679 LZW Compressed TIFF Files Supported

LZW compressed TIFF files are now supported by Autodesk MapGuide Server 6.5.

503492 Zoom > Width uses Euclidean distance

Setting the View Distance Function to use Great Circle had no effect on the Zoom > Width option and the status bar display. This issue has been resolved.

669048 Issue with Internet Explorer 6.0 SP2

Using Microsoft Internet Explorer 6.0 SP2 when accessing or refreshing an Autodesk MapGuide site sometimes caused an Internet Explorer error. This issue has been resolved.

Copyright © 2007 Autodesk, Inc. All Rights Reserved
This publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose.
Autodesk, Inc., reserves the right to revise and improve its products as it sees fit. This publication describes the state of this product at the time of its publication, and may not reflect the product at all times in the future.
The following are registered trademarks of Autodesk, Inc., in the USA and/or other countries: 3D Props, 3D Studio, 3D Studio MAX, 3D Studio VIZ, 3DSurfer, ActiveShapes, ActiveShapes (logo), Actrix, ADI, AEC Authority (logo), AEC-X, Animator Pro, Animator Studio, ATC, AUGI, AutoCAD, AutoCAD LT, AutoCAD Map, Autodesk, Autodesk Inventor, Autodesk (logo), Autodesk MapGuide, Autodesk Streamline, Autodesk University (logo), Autodesk View, Autodesk WalkThrough, Autodesk World, AutoLISP, AutoSketch, Biped, bringing information down to earth, CAD Overlay, Character Studio, Cinepak, Cinepak (logo), Codec Central, Combustion, Design Your World, Design Your World (logo), Discreet, EditDV, Education by Design, gmax, Heidi, HOOPS, Hyperwire, i-drop, Inside Track, Kinetix, MaterialSpec, Mechanical Desktop, NAAUG, ObjectARX, PeopleTracker, Physique, Planix, Powered with Autodesk Technology (logo), ProjectPoint, RadioRay, Reactor, Revit, Softdesk, Texture Universe, The AEC Authority, The Auto Architect, VISION*, Visual, Visual Construction, Visual Drainage, Visual Hydro, Visual Landscape, Visual Roads, Visual Survey, Visual Toolbox, Visual TugBoat, Visual LISP, Volo, WHIP!, and WHIP! (logo).
The following are trademarks of Autodesk, Inc., in the USA and/or other countries: 3ds max, AutoCAD Architectural Desktop, AutoCAD Learning Assistance, AutoCAD LT Learning Assistance, AutoCAD Simulator, AutoCAD SQL Extension, AutoCAD SQL Interface, Autodesk Envision, Autodesk Map, AutoSnap, AutoTrack, Built with ObjectARX (logo), Burn, Buzzsaw,, Cinestream, Cleaner, Cleaner Central, ClearScale, Colour Warper, Content Explorer, Dancing Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignProf, DesignServer, Design Web Format, DWF, DWG Linking, DXF, Extending the Design Team, GDX Driver, gmax (logo), gmax ready (logo),Heads-up Design, IntroDV, jobnet, ObjectDBX, onscreen onair online, Plans & Specs, Plasma, PolarSnap, Real-time Roto, Render Queue, Visual Bridge, Visual Syllabus, and Where Design Connects.
Autodesk Canada Inc. Trademarks
The following are registered trademarks of Autodesk Canada Inc. in the USA and/or Canada, and/or other countries: discreet, fire, flame, flint, flint RT, frost, glass, inferno, MountStone, riot, river, smoke, sparks, stone, stream, vapour, wire.
The following are trademarks of Autodesk Canada Inc., in the USA, Canada, and/or other countries: backburner, backdraft, Multi-Master Editing.
All other brand names, product names, or trademarks belong to their respective holders.
Copyright (c) 2000 The Apache Software Foundation. All rights reserved.
Portions of this product are distributed under license from D.C. Micro Development, © Copyright D.C. Micro Development. All rights reserved.
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial Computer Software-Restricted Rights) and DFAR 227.7202 (Rights in Technical Data and Computer Software), as applicable.

Last modified: March 23, 2007