Readme file for: IBM® Maximo® Spatial Asset Management Version 7 Release 1 Modification 0 Fix Pack 1 IBM Corporation 25 March 2009 © Copyright International Business Machines Corporation 2009. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. ====================================================== Table of Contents ====================================================== 1. Introduction 2. Contents 3. Installation information 4. Resolved issues 5. Contacting IBM Support 6. Notices and trademarks ====================================================== 1. Introduction ====================================================== The purpose of this fix pack is to support ESRI ArcGIS Server 9.3 Service Pack 1. This readme document provides information about the version 7.1.0.1 fix pack release for IBM® Maximo® Spatial Asset Management. This readme document describes the contents of this fix pack, provides installation instructions, and a list of the fixed issues in this release. ====================================================== 2. Contents ====================================================== The following items are included: 1) SpatialFixpack7101.zip ---------------------- This zip package contains the 7.1.0.1 fix pack for Maximo Spatial Asset Management. ====================================================== 3. Installation information ====================================================== Overview: To apply the fix pack, complete these tasks: 1 Check that pre-installation requirements are met. 2 Install the fix pack. 3 Merge faces-config.xml files using the XML tool. 4 Add spatial tags to the web.xml file. 5 Rebuild the EAR files. 6 Restart the application server and deploy the EAR files. ----------------------------------------- 1) Checking pre-installation requirements Before you install this fix pack, check the following requirements: - You have system administrator rights and privileges. - IBM Maximo Asset Management 7.1 is installed and Base Services 7.1.1.4 fix pack is installed. - IBM Maximo Spatial Asset Management 7.1 is installed. - ESRI ArcGIS Server 9.3 SP1 Enterprise Advanced is installed. - ESRI ArcSDE 9.3 SP1 (packaged with ArcGIS Server) is installed. - All users are logged off Maximo. - All Maximo application servers and services are stopped. - No other programs are open. - The entire directory where Maximo is installed is backed up. - The Maximo database is backed up. - The Maximo help system is backed up. The help system is located in \\applications\maximohelp\helpweb\webmodule\en. -------------------------- 2) Installing the fix pack Install this fix pack as follows: 1. Download the SpatialFixpack7101.zip file, into a temporary directory on the administrative system. For example, C:\temp 2. Using Windows Explorer, go to the directory where your solutionInstallerGUI.bat file is located (for example, home dir\SMP\bin). 3. Double-click the solutionInstallerGUI.bat file in your drive folder. The IBM Tivoli Base Services window opens. 4. Select a language for your installation and click "OK". 5 From the Process Solution Installer Introduction panel, click "Next". 6. From the Choose PSI Package panel, click "Choose", navigate to the SpatialFixpack7101.zip file (for example, C:\temp\SpatialFixpack7101.zip), select it, click "Open" and click "Next". Once a package has been selected and opened, the process solution installer performs a series of validation checks to verify that the package you selected is valid. The system is checked to ensure that the package has not already been deployed, or, if the package is intended as an upgrade, the system is checked to ensure the base package has already been installed. 7. From the Package Validation Results panel, review and verify the information displayed, and click "Next". 8. Select the "I accept the terms in the license agreement" option and click "Next". The Add Features screen opens. 9. If you plan on installing the product in a language other than English, select the "IBM Maximo Spatial Asset Management Language Support Feature" checkbox and click "Next". Otherwise, leave the checkbox cleared and click "Next". 10. If you installed your adapter on BEA WebLogic Server or you have not used the Middleware installer, skip to step 13. 11. From the Middleware Login Information panel, enter the credentials for which you are being prompted, and click "Next". The contents of this panel are constructed dynamically, and depend on the type of package that you are installing. Once you have entered the requested user IDs and passwords, the process solution installation wizard validates the credentials by connecting to the middleware servers using the supplied credentials. 12. After the credentials have been verified, a package options panel is displayed and details the deployment options that the package supports. The "Defer Maximo Application Redeployment" and the "Defer the Update of the Maximo Database" checkboxes are cleared by default. Accept these values by clicking "Next". The process solution installer performs a system check to ensure that all system requirements necessary for the package to be installed are present. Click "Next" to advance. 13. From the Pre-Install Summary panel, review and verify the information displayed, and click "Next". The process solution installer begins the installation process. You can view the progress on the screen. When the installation is complete, the Package Successfully Deployed panel opens. If the installation fails, a message displays the step that failed. Do not proceed to the next step until you have resolved the error and the package has been installed successfully. 14. From the Package Successfully Deployed panel, click "Next". 15. From the Install Another Package panel, leave the "Install Another Package" check box cleared and click “Done” to exit the wizard. 16. Rebuild and redeploy the Maximo EAR file. ---------------------------------------------------- 3) Merging faces-config.xml files using the XML tool To use the map properties and tasks that you configured in ArcGIS Server Manager, you must merge the spatial faces-config.xml file with the maximo faces-config.xml file. The XML tool updates, adds, and deletes nodes in the maximo faces-config.xml file based on the nodes in the spatial faces-config.xml file. The script creates a backup copy of your current maximo\applications\maximo\ maximouiweb\webmodule\WEB-INF\faces-config.xml file and then replaces it with a new one. About this task When you merge the spatial faces-config.xml file with the maximo faces-config.xml file, you must specify the spatial faces-config.xml file. If you created one Web application in ArcGIS Server Manager, the editing task uses pooled map services. Pooled map services shows non-versioned data on the Map tab. Use the -p parameter in the script for non-versioned editing. If you created two Web applications in ArcGIS Server Manager, one for pooled map services and one for non-pooled map services, use the -p parameter and the -n parameter when you run the script. The non-pooled map service is used for versioned editing. To merge the XML files, open a command prompt, navigate to the directory where Maximo is installed, and run one of the following scripts: -If your implementation uses only non-versioned editing: maximo\tools\maximo\spatial-facestransform.bat -p gis manager pooled faces-config.xml -If your implementation uses versioned editing: maximo\tools\maximo\spatial-facestransform.bat -p gis manager pooled faces-config.xml -n gis manager non-pooled faces-config.xml For example, run the following script, where maximo\ is the location where Maximo is installed on your system and c:\pooled-faces-config.xml and c:\non-pooled-faces-config.xml are the files that you extracted from the ArcGIS Server Manager .war files that you exported: maximo\tools\maximo\spatial-faces-transform.bat -p c:\pooled-faces-config.xml -n c:\non-pooled-faces-config.xml ------------------------------------------ 4) Adding spatial tags to the web.xml file To use the applications that are enhanced with map features, you need to add spatial code to the web.xml file. You can replace the default web.xml file that is installed with Maximo with the web-spatial.xml file. If you customized the default web.xml file, you need to add spatial tags to the web.xml file. Procedure 1. Open the web-spatial.xml file in the MAXIMO\applications\maximo\ maximouiweb\webmodule\WEB-INF folder. 2. Copy the spatial XML code into the corresponding places in the web.xml file. Use the definitions in the web-app_2_4.xsd in the header of the web.xml file for information about tag placement. Spatial XML code is enclosed by the following comments: and 3. Save the file. -------------------------- 5) Rebuilding the EAR files Ensure that the maximo.properties file is up-to-date, then rebuild the maximo.ear file and the maximohelp.ear file. For more information about building EAR files, see the IBM Maximo Spatial Asset Management Installation Guide. ---------------------------------------------------------------- 6) Restarting the application server and deploying the EAR files You must redeploy your EAR files and then restart the Maximo application server to apply the fix pack changes. For information about deploying EAR files, see the IBM Maximo Spatial Asset Management Installation Guide. ====================================================== 4. Resolved issues ====================================================== There are no customer reported issues. ====================================================== 5. Contacting IBM Support ====================================================== IBM Software Support provides assistance with product defects. Before contacting IBM Software Support, your company must have an active IBM software maintenance contract, and you must be authorized to submit problems to IBM. For information about the types of maintenance contracts available, see "Enhanced Support," in the Software Support Handbook at http://techsupport.services.ibm.com/guides/services.html. To contact IBM Software Support with a problem: 1. Define the problem, gather background information, and determine the severity of the problem. For help, see "Contacting IBM" in the Software Support Handbook at http://techsupport.services.ibm.com/guides/beforecontacting.html. 2. Gather diagnostic information. 3. Submit your problem to IBM Software Support in one of the following ways: - Online: Report the problem on the IBM Software Support site: http://www.ibm.com/software/support/probsub.html. - By telephone: For the telephone number to call in your country, go to the Contacts page of the Software Support Handbook: http://techsupport.services.ibm.com/guides/contacts.html. If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the IBM Support web site daily, so that other users who experience the same problem can benefit from the same resolution. ====================================================================== 6. Notices and trademarks ====================================================================== Third-Party Technology: Certain IBM Maximo products contain technology provided under license from third parties, as noted below. All Products: - Portions © 1996-2003 Visual Mining, Inc. Visual Mining™ NetCharts Server provided by Visual Mining, Inc. IBM Maximo: - Portions © 1995-2004 Actuate Corporation. - Portions © 2005 BEA Systems, Inc. BEA WebLogic Server® provided by BEA Systems, Inc. - Portions © 1996-2005, i-net software GmbH. J-Integra for COM® v2.4. © 2004 Intrinsyc Software International, Inc. - Sentry Spelling-Checker Engine © 2000 Wintertree Software, Inc. IBM Maximo Discovery: - MSDE Copyright © Microsoft® Corporation. - Portions © 1998-2005 Centennial Software Limited. IBM Maximo Asset Navigator: - Portions © 1993-2002 Snowbound™ Software Corporation. RasterMaster™ Raster imaging technology provided by Snowbound Software Corporation. IBM Maximo Mobile: - Portions © 2005 DataMirror, Inc. - Portions © 2000-2005 Zaval Creative Engineering Group. IBM Maximo Mobile SE: - Portions © 1996-2005 Syclo, LLC. Open Source: IBM Maximo contains computer software obtained from the public domain, known as "Open Source" ownership of which is attributed as follows: Portions © 2002, Steve Souza (admin@jamonapi.com). Portions © 2000-2004, Jason Hunter & Brett McLaughlin. Portions © 2004-2005, The Apache Software Foundation (http://www.apache.org/). This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. IBM and IBM Corporation are registered trademarks of the International Business Machines Corporation in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others.