© 2013 IBM Corporation

Upgrade Planning - Integration Framework version 7.5

Belinda Fuller – C&SI Customer Support

26/09/2014

© 2013 IBM Corporation2

Upgrade Planning – Integration Framework

• What’s new in recent releases of Maximo?

• What’s new in Release 7.5.0.3?

• What the upgrade program supports

• What the upgrade program does not support

• Considerations

• Upgrading the Integration Framework

• Upgrading the Oracle Adapter

• Upgrading the SAP adapter

• Custom Integrations

• Services Engagement

© 2013 IBM Corporation3

New in recent releases - Application Export/Import:

• Simple for administrators to set up and for end-users to use

• Users can now export and import records directly from within Maximo

applications

• Enabled on object structures and controlled through application security

• Supports import preview mode so users can test their import files before

importing

• Imported data is validated through Maximo business objects

• JMS infrastructure is not required

• Users do not require knowledge of the Integration Framework applications

http://pic.dhe.ibm.com/infocenter/tivihelp/v23r1/index.jsp?topic=%2Fcom.ibm.mam.d

oc%2Foverview%2Fwhatsnewmam75.html

© 2013 IBM Corporation4

New in recent releases - Web Service Interactions

• A new Maximo User Interface to provide users with an easier way to

communicate between different software applications

• Supports WSDL 1.1 based Web services

http://www-01.ibm.com/support/docview.wss?uid=swg21414565

Web Service Deployment:

• Enhance Web Services Support providing wizzard applications to help guide

you through the creation of a web service

• Deployment of web services is expanded to support the use of the application

server container

© 2013 IBM Corporation5

New in recent releases - Automation Scripting

• Provides the ability to quickly extend Maximo applications without Java/JEE

programming skills or deployment practices

• Scripting is completely dynamic (no server re-starts)

http://pic.dhe.ibm.com/infocenter/tivihelp/v23r1/topic/com.ibm.mam.doc/overview/c_

whats_new_autoscript_7.5.html

© 2013 IBM Corporation6

New in recent releases - Migration Manager

Usability of the Migration Manager application has been greatly improved

• Simplify the migration of configuration content by using migration collections.

• Compare source and target databases to help identify the configuration content that must

be migrated between environments.

• Version compatibility checking is more flexible during deployment.

• You can now correct deployment data errors in many cases, which helps deployments to

run more smoothly.

• Replace attribute values at deployment time to ensure that the configuration content is

appropriate for the target environment.

• Creating a package is now simplified to reduce the requirements for approval and

activation.

• Preview a deployment to identify any problems before you migrate configuration content.

https://www-304.ibm.com/support/docview.wss?uid=swg21380484

© 2013 IBM Corporation7

New in recent releases - Additional new features

• Increased flexibility of integrating with external applications

• Support for integration messages is expanded and improved

• REST API to integrate external applications with process automation engine applications

which supports both XML and JavaScript Object Notation (JSON) format

• Messages can now be written to queues in text format

• Ability to configure child object events

• Configure the processing of integration messages to follow the authorization configuration

that is established for an application and user group

• Integration support is provided for bidirectional languages such as Arabic. You can specify

the bidirectional language format that is used by an external system

http://pic.dhe.ibm.com/infocenter/tivihelp/v23r1/topic/com.ibm.mam.doc/overview/c_whats_new

_data_integrate_ext_app_7.5.html

© 2013 IBM Corporation8

Introduced in Maximo 7.5.0.3

• Maximo Asset Management applications and some external applications can now

link and share data by using OSLC integration

• A new logger is also available for using new OSLC capabilities

http://pic.dhe.ibm.com/infocenter/tivihelp/v23r1/topic/com.ibm.mbs.doc/gp_intfrmwk/

oslc/c_oslc_overview.html

• In Maximo Asset Management 7.5.0.5, this feature has been greatly enhanced

http://pic.dhe.ibm.com/infocenter/tivihelp/v23r1/topic/com.ibm.mam.doc/overview/c_

what_new_mam_7.5.0.3.html

http://www01.ibm.com/support/knowledgecenter/SSLKT6_7.5.0.5/com.ibm.mam.doc

/overview/c_whats_new_mam_7.5.0.5.html?lang=en

© 2013 IBM Corporation9

What the upgrade program supports

The version 7.5 upgrade program supports upgrading the following elements of Maximo

Integation:

• All data

• Any configurations that you performed with the Maximo configuration tools

• Integration definitions

© 2013 IBM Corporation10

What the upgrade program does not support

The Maximo Asset Management 7.5 installation program itself does not automatically upgrade

certain aspects of a Maximo Asset Management 7.1 deployment. The following items are not

automatically upgraded by the Maximo Asset Management 7.5 installation program:

• You can not upgrade Maximo Asset Management 7.1 directly to Maximo Asset

Management 7.5. When upgrading Maximo Asset Management 7.1 to version 7.5, you

must apply the Maximo Asset Management 7.5.0.5 fix pack.

• Any changes to the Maximo database schema or database objects or interface tables

(tables, columns, indexes, and so on) that were not made with the Maximo Database

Configuration application.

• Any database objects that you created (including stored procedures, triggers, views, and

synonyms) that are dependent on Maximo database objects.

• Custom extensions of Maximo code such as interface processing classes, user exit

classes, and css and xlst. These must be manually migrated, as described in the upgrade

scenarios. If you did not compile your custom java code using a jdk 1.6 compiler, you will

need to do this as part of the migration.

© 2013 IBM Corporation11

Considerations

WebLogic versions provided for versions of Maximo Asset Management v5, v6, and v7.1 are

not supported for use with v7.5.

WebSphere Network Deployment is provided a no additional cost, however if you were

previously using WebLogic and want to continue, you will need to contact Oracle or a vendor to

obtain a copy of the WebLogic software.

You can only upgrade Maximo using the same version and vendor for the database. For

example, you cannot upgrade version Maximo Asset Management version 7.1 on Oracle to

version 7.5 on DB2. To begin using DB2, you must install a new instance of the Maximo Asset

Management v7.5.

The features provided by the version 6 Field Control add-on are incorporated into the core

features of version 7 products. If you used the version 6 Field Control add-on, you must make

database modifications before running the upgrade utilities. More information including

instructions are found here:

http://www-01.ibm.com/support/docview.wss?uid=swg21305142

© 2013 IBM Corporation12

Considerations – Cont’d

There have been many changes to component names and concepts related to the Maximo

Integration Framework. Familiarize yourself with these changes prior to upgrading. See here

for more details:

http://www-01.ibm.com/support/docview.wss?uid=swg21266217&aid=11

Queue names have changed in version 7.1. You will need to reconfigure your queue names

within the new version of the WebSphere administration Console.

The Maximo Asset Management integration controls replace the Maximo 6 interface controls.

The integration control has capabilities that are different from the interface control. Integration

controls do not have an association with the adapter, instead they are defined at the system

level. You must assign controls to any enterprise service and publish channel that is

referencing a control in a Java processing class or processing rule.

• Note that the upgrade utility deletes the MXMAXROLE and the MXWF (DM) integration

objects from the Maximo database. The upgrade utility also deletes any instance of the

MX5X adapter and its associated integration objects from the Maximo database.

© 2013 IBM Corporation13

Preparing to Upgrade the Maximo Integration Framework

When planning to upgrade Maximo, the Maximo Integration Framework will be

upgraded at the same time and steps will need to be taken to prepare prior to

performing the upgrade.

Before upgrading:

• Ensure all Maximo interface tables have no pending transactions and all records

have been removed

• Reconcile or delete all remaining error transactions from the message

reprocessing application

• Disable all jmsqseqconsumer and ifacetableconsumer crontasks

© 2013 IBM Corporation14

Upgrading the Maximo Integration Framework – Post Upgrade Tasks

After upgrading:

• Create JMS resources in the WebSpere Solutions Console

• Recreate all interface tables

• Manually recompile any custom jms classes and reapply custom xslt

• Re-enable all jmsqseqconsumer and ifacetableconsumer crontasks

© 2013 IBM Corporation15

Preparing to Upgrade the Maximo Enterprise Adapter for Oracle

Applications

The Maximo Upgrade Guide contains information you will need when upgrading the

Maximo Enterprise Adapter for Oracle Applications. Several steps need to be

followed prior to and after upgrading the Maximo Oracle adapter:

Before upgrading:

• Ensure all Maximo and Oracle interface tables have no pending transactions and

all records have been removed

• Reconcile or delete all remaining error transactions from the message

reprocessing application

• Disable the OA12 external system

• Disable the crontasks associated with integration

© 2013 IBM Corporation16

Upgrading the Maximo Enterprise Adapter for Oracle Applications –

Post upgrade tasks

After upgrading the Maximo Oracle Adapter:

• Interface tables must be recreated

• Crons must be re-enabled

• The external system OA12 must be re-enabled

• Master data must be resynchronized

• The adapter must be updated on the Oracle Applications server

The Maximo Upgrade Guide can be downloaded here:

https://www-304.ibm.com/support/docview.wss?uid=swg21266217&aid=3

© 2013 IBM Corporation17

Preparing to Upgrade the Maximo Enterprise Adapter for SAP

Applications

The Maximo Upgrade Guide contains information you will need when upgrading the

Maximo Enterprise Adapter for SAP Applications.

The objectid and objectorder values of the Maximo Enterprise Adapter for SAP

Applications 7.1 object, SAP_ITEM_LDESC, must be updated before running the

product installation program to upgrade. If you do not update these values, an error

occurs during the updatedb process.

• Run the following update statement prior to upgrading:

update maxintobjdetail set objectid=6, objectorder=5, processorder=6 where

objectname=’SAP_ITEM_LDESC’;

commit;

© 2013 IBM Corporation18

Custom Integrations

If you have custom processing classes, you must recompile them use Java

Development Kit 1.6.

XSLT will need to be recreated for the Maximo 7.5 environment and tested.

Custom classes may not work after the upgrade and may need to be recoded. In

some circumstances, you may want to engage IBM Professional Services to help

reintegration your custom classes based on your business requirements.

http://www-935.ibm.com/services/th/en/it-services/professional-services.html

© 2013 IBM Corporation19

Graphic Images

Visibility, Control,

and Automation Icons

Solution Icons

Business

Outcome Icons

Cloud & IT

Optimization

Big Data &

Analytics

Smarter

Physical

Infrastructure

Security

Intelligence

Increase

Revenue

Cost

Savings

Customer

Experience

Innovation Risk

Reduction

Endpoint &

Mobile

Management

© 2013 IBM Corporation20 © 2013 IBM Corporation20