IBM Maximo Asset Management, Version 7.6.0.10

Readme file for IBM Maximo Asset Management 7.6.0.10 feature pack

This feature pack updates Maximo® Asset Management to version 7.6.0.10.

Prerequisites and supported upgrade paths

You can install the feature pack if one of the following versions of Maximo Asset Management is installed:
  • Version 7.6.0.9
  • Version 7.6.0.8
  • Version 7.6.0.7
  • Version 7.6.0.6
  • Version 7.6.0.5
  • Version 7.6.0.4
  • Version 7.6.0.3
  • Version 7.6.0.2
  • Version 7.6.0.1
  • Version 7.6.0.0

What's new

No new functionality is introduced in this feature pack.

Planning to deploy

You can avoid problems that can occur during installation by ensuring that you complete planning tasks before you install the feature pack.

Before you begin

Whenever you make customizations or changes that require you to rebuild the EAR file, clear the WebSphere® Application Server cache. Learn more about clearing the WebSphere Application Server cache.

Use the MD5 checksum file with an MD5 checksum utility to confirm that the 7.6.0.10-TIV-MAMMT-FP00010.zip compressed file was not corrupted during the download.

Any customizations that are made to commonenv.bat are lost when this feature pack is applied. For more information, see this technote before you apply the feature pack.

Procedure

  1. Open http://www-01.ibm.com/support/knowledgecenter/SSLKT6_7.6.0.10/com.ibm.mam.doc/common/relnotes.html and review all the technotes that are created for Maximo Asset Management 7.6.0.10. If you open to this URL and technotes were not created, you receive a browser message that says that no documents match your query. After technotes are created, they are displayed.
  2. Ensure that the middleware servers like database and LDAP servers are running.
  3. Back up your database and IM data directories.
  4. Back up the entire version 7 installation directory. Learn more about the backup process.
  5. Back up your BIRT reports. This backup is only used if a failure occurs with the feature pack update.
    1. Export all of your existing reports from your V7 database to a new report directory.
    2. Name the report directory for future identification, for example, <v7\reports\birt\DatabaseExport_Pre76010 update. Learn more about exporting reports.
    3. Navigate to the location of your existing reports directory: <v7install_dir>\reports\birt\reports
    4. Copy the reports directory and rename it for ease of identification, for example: <7install_dir>reports\birt\Reportsource_Pre76010 update

    To support the new Data Set Designer application, starting in Maximo 7.6.0.6, report object structures are updated to enable the Support Flat Structure field. Report object structures are used in various locations in Maximo Asset Management, including Ad Hoc Reporting, Result Set portlets, and Cognos metadata package publishing.

    All standard report object structures are updated, and a script is provided to update any custom report object structures that you created.

    Review your custom report object structures for alias conflicts. Alias conflicts occur when the same attribute name is used in multiple objects in the object structure. If you do not correct alias conflicts, problems might occur if you use them in the Data Set Designer features.

    Learn more about resolving alias conflicts for object structures.

Installing the feature pack

Before you begin

If you are not using the updateDBLite process, ensure that no database configuration changes are pending. Copy the Maximo Asset Management and installation manager data directories and save it to another location.

For Microsoft Windows 2012 users, log in as an administrator. If you attempt to upgrade when you are not logged in as an administrator, the installation fails. This feature pack is provided as an Installation Manager compressed file. When the feature pack is installed by using the Installation Manager program, the existing Maximo Asset Management directory structure is overwritten. The feature pack also contains database scripts that modify the existing database.

To reverse the changes, you must restore the earlier version of the Maximo Asset Management directory and database that you saved to another location.

Procedure

  1. Download the 7.6.0.10-TIV-MAMMT-FP00010 compressed file and copy it to the administrative workstation.
  2. Run the Installation Manager from the following directory:
    • Windows: Start > All Programs > IBM Installation Manager > IBM Installation Manager
    • UNIX: In the /opt/IBM/InstallationManager/eclipse directory, run the IBMIM command.
  3. In the Installation Manager main window, click File > Preferences.
  4. Click Add Repository.
  5. Add the repository for the 7.6.0.10-TIV-MAMMT-FP00010.zip file and click OK.
  6. In the Preferences dialog box, click OK.
  7. Click the Update icon.
  8. In the Update Packages dialog box, select the IBM Tivoli's process automation suite package group, and click Next.
  9. To complete the installation, follow the on-screen instructions.
  10. When the installation is complete, exit the Installation Manager.

What to do next

You must configure Maximo Asset Management and rebuild and redeploy the .ear file. See the Configuring the Maximo Asset Management 7.6.0.10 feature pack section of this readme for details on this process.

Configuring the feature pack

You can configure the feature pack by using the automated user interface (UI) configuration tool, the command line interface (CLI) configuration tool, or manually. You must shut down all Maximo Asset Management applications before you configure Maximo Asset Management, and before users use the updated software, they must delete the web browser cache on every computer that uses the product.

Configuring the feature pack by using the UI configuration tool

You can automatically configure the feature pack by using the UI configuration tool, which removes the need for manual tasks.

Procedure

  1. Start the UI configuration tool.
    • For Windows, navigate to C:\IBM\SMP\ConfigTool\ConfigUI.exe or <InstallLocation>\ConfigTool\ConfigUI.exe.
    • For UNIX, navigate to the <installLocation>/ConfigTool directory and run ConfigUI. For example, /opt/IBM/SMP/ConfigTool/ConfigUI.
  2. In the Deployment Operations pane, select Update Database, Build and Deploy Application EAR Files.
  3. To complete the configuration, follow the on-screen instructions.

Configuring the feature pack by using the UI configuration tool and UpdateDB Lite

You can use UpdateDB Lite to reduce application downtime when you update the database.

Procedure

  1. Start the UI configuration tool.
    • For Windows, navigate to C:\IBM\SMP\ConfigTool\ConfigUI.exe or <InstallLocation>\ConfigTool\ConfigUI.exe.
    • For UNIX, navigate to the <installLocation>/ConfigTool directory and run ConfigUI. For example, /opt/IBM/SMP/ConfigTool/ConfigUI.
  2. Open the Configuration tool.
  3. Click Update Database with UpdateDB Lite Feature.
  4. Verify the application version and current state.
  5. Select to run the pre-processing and then post-processing options, and click Finish.
  6. After the pre-processing tasks are complete, run the UpdateDB Lite post-processing tasks. During this step the Maximo application is stopped until the updates to the database are complete.

Configuring the feature pack by using the CLI configuration tool

You can automatically configure the feature pack by using the CLI configuration tool, which removes the need for manual tasks.

Procedure

  1. Change to the <installLocation>/ConfigTool/scripts directory, for example: C:\IBM\SMP\ConfigTool\scripts
  2. To update the system, run the configuration tool command: reconfigurePae.bat -action configureProducts -updatedb -deploymaximoear -deployhelpear -wasuser -wasadmin -waspwd <wasadmin_password>

Configuring the feature pack manually

To manually configure the feature pack, use the updateDB utility.

Procedure

  1. To use the updateDB utility to run all of the feature pack database scripts, change the directory to the <maximo root>\tools\maximo directory, for example, for Windows, change the directory to C:\IBM\SMP\maximo\tools\maximo and run the updateDB utility.
    • For Windows, run the updatedb.bat file.
    • For UNIX, run the /updatedb.sh file.
  2. Delete the application server cache folders:
    • For Oracle WebLogic Server 10.2 and earlier, delete the cache and tmp folders in the <BEA_Root>\user_projects\domains\mydomain\servers\AdminServer directory, for example: C:\bea923\user_projects\domains\max75domain\servers\AdminServer\cache and C:\bea923\user_projects\domains\max75domain\servers\AdminServer\tmp
    • For Oracle WebLogic Server 10.3 and later, delete the folders in the C:\oracle\Middleware directory.
    • For the WebSphere Application Server, delete the cache folder in the <WebSphere_Root>\AppServer\profiles\Custom01\temp\<machinename>Node01\MAXIMOSERVER\MXServer directory.
  3. Delete the web browser cache on every computer that uses Maximo base services.
  4. Rebuild and redeploy the EAR files, and then restart the application server.

Importing report design files into Maximo Asset Management

This feature pack contains new and updated report design files. If you previously customized BIRT reports, the customizations might be overwritten when this feature pack is installed. You can also review any reports that you created to ensure that they are displayed correctly. After you install the feature pack, use the report import utility to import any necessary design file updates to your existing reports. Learn more about importing reports by accessing the 7.6 Report Development Guide.

Procedure

  1. On the administrative workstation, browse to <install_home>\maximo\reports\birt\tools.
  2. Open the reporttools.properties file. This file indicates the location that the reports are imported to.
  3. Edit the reporttools.properties file to meet your system requirements.
  4. Run the importreports.cmd to import your report design files. You can also run variations of this command to import only a subset of reports. Learn more about reporting by accessing the 7.6 Report Development Guide.

New platform support

Platform support is updated for each Maximo Asset Management feature pack.

Learn more about platform support upgrades for Maximo Asset Management 7.6.

Resolved defects

Defects are resolved in each Maximo Asset Management feature pack. Some defects alter the behavior of Maximo Asset Management.

Learn more about resolved defects and behavior changes for Maximo Asset Management 7.6.

Notices

This information was developed for products and services offered in the US. This material might be available from IBM in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it.

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, MD-NC119 Armonk, NY 10504-1785 US

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan

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 jurisdictions 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 websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide 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 Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 US

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.

The performance data and client examples cited are presented for illustrative purposes only. Actual performance results may vary depending on specific configurations and operating conditions.

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.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following terms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBM website.

Personal use

You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

IBM Online Privacy Statement

IBM Software products, including software as service solutions, (“Software Offerings”) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering’s use of cookies is set forth below.

Depending upon the configurations deployed, this Software Offering may use session and persistent cookies that collect each user’s name, user name, password, or other personally identifiable information for purposes of session management, authentication, single sign-on configuration or other usage tracking or functional purposes. These cookies can be disabled, but disabling them will also likely eliminate the functionality they enable.

If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent.

For more information about the use of various technologies, including cookies, for these purposes, see IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM's Online Privacy Statement at http://www.ibm.com/privacy/details in the section entitled “Cookies, Web Beacons and Other Technologies” and the "IBM Software Products and Software-as-a-Service Privacy Statement" at http://www.ibm.com/software/info/product-privacy.