Wednesday, 5 February 2020

Upgrading to Maximo 7.6.1 from Maximo 7.6.0.x

Upgrading to Maximo 7.6.1 from Maximo 7.6.0.x

Body

Upgrading Maximo 7.6.0.x to Maximo 7.6.1 is like upgrading Maximo 7.5.0.x to Maximo 7.6.0.x:
  • Install a new SMP directory
  • Install new versions of WebSphere and/or DB2
  • WebSphere Application Server:
    • If installing to a new server, configure WebSphere with Tivoli's process automatic suite configuration tool
    • If installing to an existing server where Maximo is running, using WebSphere migration tools to recreate existing WebSphere 8.5.5.x profiles in WebSphere 9.0.0.7
  • Database:
    • Db2: Follow Db2 instructions to upgrade the database server (if on the same server), the instances and Maximo database
    • Microsoft SQL Server or Oracle database: ensure database version is compatible with Maximo 7.6.1
    • For all databases: Use Tivoli's process automatic suite configuration tool to connect to existing Maximo 7.6.0.x database. See the Platform Configuration Matrix.

Environment being upgraded in this blog:
image
The server name is maxsup097, which you may see in some of the screen shots below.
Upgrade scenario notes for this blog post:
1. Since I intend to keep these step-by-step instructions limited to Maximo only, this post will not include WebSphere configuration or migration, or any database upgrade steps.
As can be seen above, I previously installed WebSphere 9.0.0.6 and deployed Maximo 7.6.0.x to it. I will apply WebSphere 9 Fix Pack 9.0.0.7 to bring it into line with the version distributed with Maximo Asset Management 7.6.1. Also, Maximo 7.6.1 may be run on WebSphere 8.5.5.13 or later using Java 8 as the default JDK.
However: Use of the version of Tivoli's process automatic suite configuration tool in Maximo 7.6.0.6+ is not supported, but may work with WebSphere 9.0.0.7.  Likewise, the version of Tivoli's process automatic suite configuration tool in Maximo 7.6.1 is not supported, but may work with WebSphere8.5.5.13. In my less-than-exhaustive testing, I found the Maximo 7.6.1.x Config Tool did not detect a correct JMS Queue configuration (and was quirky with Microsoft SQL Server).
Part 0: Upgrade Microsoft Windows Server 2012 R2 to Windows Server 2016. If at all possible, do not do this. Stand up a new server. It will take a lot less time. (I did it because I had several Maximo 7.6.0.x instances I wanted to test upgrade against and it was easier for me.)

Part 1: Install Maximo Asset Management 7.6.1. See Installing Maximo Asset Management 7.6.1 From Start to Finish Part 1 Only.
In Installation Manager, after installing Maximo 7.6.1 but before running the Config Tool, I added the following packages to the repository:
  • IBM Maximo Asset Health Insights 7.6.0
  • Asset Health Insights Feature Pack 7.6.0.5
  • IBM Maximo for Service Providers 7.6.3
  • Maximo for Service Providers Fix Pack 7.6.3.2
A Detour Into Installing Packages through Installation Manager
I did this rather than using the Launchpad to avoid prerequisite errors.While the available versions of both products will install to Maximo 7.6.1, they should be updated to the latest Fix Pack before configuring them. This means you will need to download and add the Fix Pack repository to Installation manager after you install the 7.6.x version.
To speed things up, I took a second approach: Bypass the Launchpad and install them at the latest Fix pack right off.
For each of the four packages above, I created a directory with a unique, expanded the main package, and moved the repository zip into the correct directory, for example:
  1. Create directory ahi-760
  2. Download Max_Asset_Health_Insights_760.zip
  3. Expand .zip into Max_Asset_Health_Insights_760 directory
  4. Move \Max_Asset_Health_Insights_760\AssetHealthInstallerRepository.zip into \ahi-60.
  5. Create directory ahi-7605
  6. Download 7.6.0.5-TIV-AHI-FP0005.zip
  7. Move 7.6.0.5-TIV-AHI-FP0005.zip into ahi-7605
and so on. I don't actually need to move the FP into its own directory. Now I have a directory structure:
  • ahi-760
  • ahi-7605
  • sprin-763
  • sprint-7632
The resulting list of repositories:
image
IBM Maximo Asset Health Insights. There is an additional step that needs to be taken after installing AHI. Go to the tech note Updating the Maximo Asset Management IoT file. Follow the steps there to download and install the correct IoT configuration files.
IBM Maximo for Transportation 7.6.2: See the tech note Unable to install Maximo for Transportation 7.6.2. Installing Transportation requires following the steps I describe above.
Detour ends

After the repositories are added, click Apply and OK. Click on the big Install button.
image
Select the add-ons and Industry Solutions and install them to your new Maximo 7.6.1 instance. When installed, keep IBM Tivoli process automation engine configuration utility selected and click Finish.

Part 2:
image
Click on Configure a new Administrative Workstation to point to an existing Asset Management deployment.
image
On this screen I selected the WebSphere is already configured radio button. Do not check Bypass WebSphere validation.
image
Here's the blank Database Instance Information form...
image
...and here it is filled out, with the cursor carefully placed over the database name, m7609703.image
and the same for configuring the Application server:
image
imageNo J2EE security on my out-of-the-box Maximo:
image

Next, apply the deployment operations:
imageThe new Maximo 7.6.1 directory is now configured as the Administrative workstation for the database called m7609703.

Another Detour: Backing up the Administrative Workstation.
Nothing has happened to the database or web application server yet. Before we upgrade the database, let's go over what to back up when backing up the administrative workstation.
1. The entire SMP directory. You don't have to back up the EAR files in \SMP\maximo\deployment\default\.
2. The entire Installation Manager shared directory, which contains all of the installed .zipp files. (.zipp is .zip with an extra p.)
imagebut not the Installation Manager application directory, [which in this case I put into C:\IBM rather than C:\Program Files\IBM]. If you need to manually roll back or recreate rather than roll back to a snapshot of the Admin workstation, you will have to install Installation Manager anyway.
3. The hidden folder C:\ProgramData\IBM\Installation Manager. This folder contains the repository database of all of the products installed by Installation Manager.
image
End of Detour.

Interesting.
Taking Maximo 7.6.1 out of it, all I've done here is install Maximo, and Configure a new Administrative Workstation to point to an existing Asset Management deployment. These steps can be used independently. whenever you need to "move" the admin workstation or it goes missing somehow. Remember: The only irreplaceable piece of Maximo is the database.

Part 4: The Upgrade
While this will be the big part for Maximo users, it is not the big part for Maximo server administrators, which we just completed.
image
Click on Update Database and Build and Deploy Application EAR Files.
image
image
Click Next.
image
You may also see an option to Deploy the application EAR file.
Change the skin to the new one, and enable enhanced navigation:
image
Click Finish.
image
After deploying the EAR file, log in and finished! Click on picture below to find the 7.6.1 Preview Site.
image

Enabling Maximo Activity Dashboard in Maximo 7.6

As per document: https://www.ibm.com/developerworks/mydeveloperworks/blogs/a9ba1efe-b731-4317-9724-a181d6155e3a/entry/performance_maximo_activity_dashboard_perfmon?lang=en – the web.xml entry is enabled by default within Maximo 7.5 To fully enable the Maximo Activity Dashboard – a System Property needs to be added: mxe.webclient.activitydashboard. To enable this property – follow the below steps:

1) Go To – System Configuration – Platform Configuration – System Properties. Within the 'Global Properties' pane – click on New Row. Add the following information:

Property Name: mxe.webclient.activitydashboard
Description: Maximo Activity Dashboard (PerfMon)
Global Value: true
Maximo Default: false
Online Changes Allowed?: CHECKED
Live Refresh?: CHECKED

Accept all other default values. Click on Save.



2) Within the System Properties application – access the newly added property: 'mxe.webclient.activitydashboard'. Ensure that the Global Value and Current Value are set to 'true'. Click on the Checkbox beside the property – Click on Live Refresh icon on the Toolbar – ensure the property is selected and update the value:



3) Open a new Internet Browser session – enter the following URL:

http://<hostname>:<port>/maximo/webclient/utility/profiler/PerfMon.jsp

Navigate within Maximo with a different user session. The Dashboard will show specific details:

Readme for the interim fixes for IBM Maximo Anywhere 7.6.3

To help you install the interim fixes for IBM Maximo Anywhere 7.6.3, you can use the following installation information:

Content

---------------------------------------------------------------------------------
Obtain the interim fixes
------------------------------------------------------------------------------------
The interim fixes are available on Fix Central:

----------------------------------------------------------------------------------
Pre-installation steps
----------------------------------------------------------------------------------
System requirements:
For the third interim fix, you must first install the MobileFirst interim fix, and you must install Android Build Tools 28.0.3 and Android SDK 28 platform tools.  You still run API 23 as a target.
A minimum of Oracle Java version 1.7 is required for iOS and Windows platforms.
Oracle Java 1.8 is required for Android.
Firebase Cloud Messaging (FCM) for push notifications on Android:
If you want to use Firebase Cloud Messaging (FCM) for push notifications on Android, follow steps 3 - 6 in the following article: Apply LAFIX to use FCM for Push Notification on Android device
Back up and record configurations:
Before proceeding, make a complete backup of the following folders. Default folder locations are provided below.
Maximo Admin Workstation: /IBM/SMP
Maximo Anywhere Build Server: /IBM/Anywhere
Also, make a complete backup of the Maximo database instance.
Check and record any custom WebSphere Application Server configurations, such as module bindings, virtual hosts, and environment property settings.
----------------------------------------------------------------------------------
Install the MobileFirst interim fix (IFIX)
----------------------------------------------------------------------------------
Install the MobileFirst interim fix (IFIX) from the following link by downloading MFPF-IF201903291256 
Note: This version is required for FCM support on MobileFirst version 7.1 
Ensure that MobileFirst server is up and running.
1. Open Installation Manager
2. Go to the File menu, select Preferences, and add a new repository. 
3. Point the repository to the MobileFirst_Platform_Server\disk1\diskTag.inf file in the extracted IFIX folder. 
4. Click Update 
image 1065
5. Select the MobileFirst Installation folder.
image 1067
6. Click Next.
image 1066
7. Click Next.
image 1057
8. Accept the License agreement.
image 1068
9. Click Update.
image 1069
10. When the update has completed, open the Server Configuration Tool.
11. Select the Run time from top left hand corner.
image 1072
12. From the Configurations menu, choose Upgrade a previous configuration.
image 1073
13. Specify the passwords, and click OK.
image 1074
image 1076
14. Restart the MobileFirst server.
15. Open the MobileFirst Console, and open the About screen. The server version should be 7.1.0.00.20190329-1256
image 1018
16. After you install the MobileFirst interim fix, back up your \IBM\Anywhere\MaximoAnywhere\libs\build directory.
17. Copy the following 3 files from the \IBM\MobileFirst_Platform_Server\WorklightServer directory, and paste them into the \IBM\Anywhere\MaximoAnywhere\libs\build directory:
  • worklight-ant-builder.jar
  • worklight-ant-deployer.jar
  • worklight-jee-library.jar
----------------------------------------------------------------------------------
Install Android build tools 28.0.3 and Android SDK 28 platform tools, and run Android API 23 as a target 
----------------------------------------------------------------------------------
Windows:
Open SDK Manager.exe from c:\android-sdk directory and install android SDK build tools 28 and platform-tools 28
Mac:
Mac OS can be used as a build machine to generate .apk for android platform if android SDK has been installed
Open a terminal session and navigate to the /users/mayon/android-sdks/tools/bin directory
Enter ./sdkmanager --list command to show what has been installed
Output should show that the following have been installed:
Android SDK Build-Tools 23.0.3 
Android SDK Build-Tools 28.0.1
Android SDK Platform-Tools 28.0.2
Android API 23
----------------------------------------------------------------------------------
Update the IBM Maximo Asset Management environment
----------------------------------------------------------------------------------
1. Download and extract the oslcos_pmp_deploy_latest.zip and anywhereadmin_pmp_deploy_latest.zip files to the ../IBM/SMP/maximo directory.
2. Update the database and build and deploy the EAR file from the Tivoli's process automation suite configuration tool. Run the Update Database and Build and Deploy Application EAR Files option.
---------------------------------------------------------------------------------
Install the apps
---------------------------------------------------------------------------------
To install the apps, complete the following steps:
1. Download and extract the platform-Latest.delta.zip file to the install_home/MaximoAnywhere/platform directory.
2. On Windows and Linux, extract the MaximoAnywhere_7.6.3.latest.delta.zip file to the install_home/MaximoAnywhere directory. Overwrite the existing MaximoAnywhere directory.
For Mac OS x systems, extract the file to a different location. Do not use Finder to overwrite the existing MaximoAnywhere directory. Instead, in a terminal, use ditto and run the following command: ditto <from_folder> <destination_folder>.
3. Extract the MaximoAnywhere/build/config/app_artifacts_previous.zip file into the MaximoAnywhere/apps path.
4. Run the following command to upgrade your WorkExecution.xml file to the latest version:
ant -f app-sparse-xml-processor.xml upgrade-previous-release-app-artifacts
6. If you are building Android apps, update your build.properties property to specify the version of the Android SDK that you are using, for example, Android_TARGET_DEVICE_NAME=android-23. Also, you must download the same Android SDK in your Android SDK Manager. Android 23 SDK is the minimum supported version for Android 7 apps. Otherwise, Android 21 SDK is the minimum supported version.
7. For Windows, run the following command:
build.cmd update-platform
For Mac OS X, run the following command:
./build.sh update-platform
8. Run the anywhere-rdfs-puller.xml file that is in the MaximoAnywhere directory.
9. For Windows, run the following command:
build.cmd all
For Mac OS X, run the following command:
./build.sh all
----------------------------------------------------------------------------------
Post-installation steps
----------------------------------------------------------------------------------
If you have customized your Maximo Object Structures rerun the OSLC RDF Puller to pull the latest OSLC RDF documents:
https://www.ibm.com/support/knowledgecenter/SSPJLC_7.6.3/com.ibm.si.mpl.doc/integration/t_import_resource_data.html
Reapply any changes you might have made to the app-feature.properties file to reenable any custom properties you might have changed.

Verifying that your local customizations still exist:
Run a comparison tool like Beyond Compare to compare your backed up directory to the newly updated one.
Verify that any (class files, device native code or javascript) customizations you have made are still in place, and reapply them if not.
Verify that your app.xml file changes are still there.
Verify that the bundleids in your application-description.xml file are correct.
Verify that any custom WebSphere Application Server configurations, such as module bindings, virtual hosts, and environment property settings are still there.
If you have customized the logos on the login screen or any of the platform XML files, you must manually reapply those changes.
----------------------------------------------------------------------------------
Resolved issues
----------------------------------------------------------------------------------
The following issues are resolved in the Maximo Anywhere 7.6.3 interim fixes:
First interim fix:
Second interim fix:
IJ11274   UNABLE TO CREATE WORK CENTER SERVICE REQUEST WHEN ENVIRONMENT HAS ANYWHERE
IJ07847 MAXIMO ANYWHERE PHYSICAL COUNTS APPLICATION ALLOWS RECOUNTS TO HAPPEN ON OBSOLETE ITEMS
IJ03352 ANYWHERE TRANSFERS APP CREATES DUPLICATE RECEIPTS OF THE SAME PURCHASE ORDER
IJ07518 CANNOT READ PROPERTY 'GETMETADATA' OF NULL WHEN UNDOING CHANGES TO A WORK ORDER CREATED WITH AN ERROR
IJ05616 THE LAST SPECIFICATIONS ON THE WORK ORDER ARE NOT RETAINING THE VALUE WHEN HITTING THE NEXT ARROW
IJ10682 ANYWHERE CELLULAR & WIFI CONNECTION SETTING PLACES DEVICE IN OFFLINE MODE OR WRONG STATE
IJ11174 MAXIMO ANYWHERE  WORK EXECUTION APP WORK ORDER SPECIFICAITON LOOKUP WON'T  BRING UP CORRECT DOMAIN TABLE CONTENT
IJ05819 CLASSIFICATION NUMERIC ATTRIBUTES CUTS DECIMALS TO 2 PLACES
IJ11540 UNABLE TO LOG IN TO MAXIMO ANYWHERE AFTER DEVICE\SERVER TIMEOUTOCCUR
Third interim fix:
IJ15005 - MAXIMO ANYWHERE HANGS ON LAUNCH SCREEN AFTER CHROME UPDATE 73
IJ15853 - AFTER APPLYING AN INTERIM FIX CONTAINING APAR IJ15005 THERE ARE SCROLLING ISSUES ON iOS DEVICES FOR MAXIMO ANYWHERE
IJ10628 - RETURNING FROM TASK DETAILS TO THE TASK LIST IN ANYWHERE WORK
IJ11540 - UNABLE TO LOG IN TO MAXIMO ANYWHERE AFTER DEVICE\SERVER TIMEOUT OCCURS
IJ11154 - AUTO-LOGOUT AND PERFORMANCE ISSUE IN LOW BANDWIDTH AREA
IJ14460 - ERROR HANDLING ISSUES ON NEW WORK ORDERS IN MAXIMO ANYWHERE
IJ14461 - DEFAULT VALUES DISPLAYED WHEN CREATING A NEW WORK ORDER IN WORK EXECUTION
IJ14055 - ANYWHERE WORK EXECUTION GREEN TIMER RESETS AFTER DOWNLOADING
IJ15606 - AFTER APPLYING FIX FOR IJ13998, WHEN NAVIGATING TO A DATA SHEET, THEN TO AN ASSET FUNCTION, AN ERROR MESSAGE APPEARS
IJ13998 - DATA SHEETS DO NOT SHOW UP ON RECORDS WHEN SELECTED IN OFFLINE
IJ11400 - BROKEN IMAGE DISPLAY FOR REFRESH WHEN WORK LIST UPDATE IS DONE
IJ03230 - INCORRECT PASSWORD SENDS MULTIPLE LOG IN REQUEST
IJ16052 - USER IS ABLE TO CLICK 'LOGIN' BUTTON TWICE IN ANYWHERE WORK
IJ08694 - VALIDATION REQUIRED WHEN RECEIVING SERVICES OR MATERIALS IN ISSUES & RECEIVING
IJ15676 - MOVING ASSET DOES NOT UPDATE THE LOCATION DESCRIPTION
IJ05430 - ASSET AUDIT LOCATION SEARCH FAILS OFFLINE
IJ15054 - ANYWHERE OFFLINE, MAPS: UNABLE TO CREATE REPLICA FOR A MAP WITH MORE THAN 60000 FEATURES
IJ16220 - UNABLE TO UPLOAD MAXIMO ANYWHERE APPLICATIONS TO GOOGLE PLAY
IJ14041 - THE MAP VIEW ON THE ANYWHERE WORK EXECUTION MAP IDENTIFY CONTROL IS NOT POSITIONING CORRECTLY

IBM Readme for IBM Maximo Asset Management 7.6.1.3 Fix Pack

  Fix Readme Abstract This fix pack updates IBM® Maximo® Asset Management version 7.6.1, 7.6.1.1, and 7.6.1.2 Content IBM Maximo Asset Manag...