IBM Intelligent Transit Analytics Version 1.5

Interim fix PO01086

About this readme file

This readme file provides information about interim fix PO01086 for IBM Intelligent Transit Analytics Version 1.5.

Introduction

IBM® Intelligent Transit Analytics V1.5 interim fix PO01086 provides fixes for problems in the user interface, and also a memory leak which occurs when you load production timetable data.

Download Description

IBM® Intelligent Transit Analytics V1.5 interim fix PO01086 resolves the following problems:

User interface issues

When you install interim fix PO01086, the following problems in the Operator:Transit view no longer occur:

  • Selected layers on the map in the Current Transit Conditions portlet are cleared when you refresh a page, resize a portlet, or switch views.
  • Sometimes, stops that are not included in the shape file for a journey pattern are erroneously displayed in the UI.
  • When a stop is used by multiple lines or services, the hover and highlight feature does not work as expected.
Memory leak issue

Interim fix PO01086 also resolves a memory leak that can occur in the data loading utility of the Vehicle Awareness and Prediction feature. The memory leak occurs when you load large production timetable data files into the solution. For more information about this problem, see the following technote.

Memory leak occurs while loading production timetable data

Installation instructions

Prerequisite steps

Before you begin to install interim fix PO01086, download and install IBM Intelligent Operations for Transportation V1.5 interim fix PO01084.

For more information, go to http://www.ibm.com/support/docview.wss?uid=swg24034647.

Extract the artifacts

    Extract the IBMIT-ITA-1.5.0.0-IFPO01086.zip interim fix file. The fix consists of updated versions of the following IBM Intelligent Transit Analytics system files:

    • vap_portlet_ear.ear

    • trans_vap_ui_restservices_ear.ear

    • vap_loaddata.sh

    • trans_vap_offline_infrastructure.jar

Installing the updated vehicle awareness prediction applications

  1. Log on to the IBM Intelligent Operations Center V1.5 application server node.

  2. Copy the files titled vap_portlet_ear.ear and trans_vap_ui_restservices_ear.ear to a temporary directory on the IBM Intelligent Operations Center V1.5 application server node.

  3. Open the WebSphere Application Server administration console.

  4. In the View pane, navigate to Applications > Application Types > WebSphere enterprise applications.

  5. Update the vap_portlet_ear application by completing the following steps:

    1. Filter the applications by '*vap*'.

    2. Find and select the vap_portlet_ear application.

    3. Click Update and accept the default configurations.

    4. When prompted, enter the path of the updated vap_portlet_ear.ear file that you extracted to a temporary directory.

    5. To save the updated ear file to the master configuration, click Save.

    6. Start the installed vap_portlet_ear application, and verify that it starts successfully.

  6. Update the trans_vap_ui_restservices_ear application by completing the following steps:

    1. Filter the applications by '*trans*'.

    2. Find and select the trans_vap_ui_restservices_ear application.

    3. Click Update and accept the default configurations.

    4. When prompted, enter the path of the updated trans_vap_ui_restservices_ear.ear file that you extracted to a temporary directory.

    5. To save the updated ear file to the master configuration, click Save.

    6. Start the installed trans_vap_ui_restservices_ear application, and verify that it starts successfully.

  7. Clear the browser cache of the connecting clients.

    8. Installing and configuring the updated vehicle data load utility

    1. Log on to the IBM Intelligent Operations Center data server as the root user.

    2. Open the /opt/IBM/iss/intelligentTransportation/intelligentTransitAnalytics/scripts directory.

    3. Back up the original V1.5 vap_loaddata.sh and trans_vap_offline_infrastructure.jar files, by copying them into a directory of your choice.

    4. Copy the updated vap_loaddata.sh and trans_vap_offline_infrastructure.jar fix files that you extracted earlier, into the /opt/IBM/iss/intelligentTransportation/intelligentTransitAnalytics/scripts directory.

    5. When prompted, enter y to overwrite the existing files.

    6. To check that the files have the correct ownership, run the following command:

      7. #ls -la

      The ownership should be as follows:

      root root 7907 Aug 12 09:57 vap_loaddata.sh

      db2inst1 db2iadm1 172476 Aug 12 09:53 trans_vap_offline_infrastructure.jar

      It is possible even with this fix in place that the Java heap is exhausted by the loading excessively large PTT files. This can result in a failure to load and store the data. To work around this issue, it is possible to increase the memory limits on the Java process that is used by the data load utility.

    7. Optionally, edit the vap_loaddata.sh script file to increase the Java heap size. To do this, complete the following steps:

      1. Search for line that starts the Java process, which begins with the following string:

        2. $JAVA_HOME/bin/java

      2. On this line, search for the -Xmx parameter. The value that immediately follows -Xmx represents the maximum heap size. For example, the value -Xmx4096m indicates that the maximum heap size is set to 4096 MB (or 4 GB).

      3. Increase the Java heap size as needed to ensure successful loading of the large PTT data files. Increase the setting in multiples of whole giga-byte values, for example -Xmx6144m or -Xmx8192m.

      4. When the large PTT files are loaded, to optimize performance you can optionally reset the -Xmx value back to the original setting.

    More information

    For more information about configuring and administering IBM Intelligent Transit Analytics, see the IBM Intelligent Transportation V1.5 Information Center at:

    http://pic.dhe.ibm.com/infocenter/cities/v1r5m0/topic/com.ibm.transport.doc/ic-homepage.html

    For the latest support updates, fix news, and downloads, see the IBM Intelligent Transportation Support Portal site at:

    http://www.ibm.com/support/entry/portal/overview/software/smarter_cities/ibm_intelligent_transportation

    Trademarks

    IBM and WebSphere are registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

    Copyright

    Licensed Materials - Property of IBM. © Copyright IBM Corporation 2013. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.