IBM PI47826: VMM DOES NOT CLEAR THE CACHE IF CLEARENTITY MODE IS USED. - United States   FIXES ARE AVAILABLE
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9 [http://www-01.ibm.com/support/docview.wss?uid=swg24041819]
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10 [http://www-01.ibm.com/support/docview.wss?uid=swg24042150]
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11 [http://www-01.ibm.com/support/docview.wss?uid=swg24043005]
8.0.0.13: WebSphere Application Server V8.0 Fix Pack 13 [http://www-01.ibm.com/support/docview.wss?uid=swg24042746]
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12 [http://www-01.ibm.com/support/docview.wss?uid=swg24043844]
8.0.0.14: WebSphere Application Server V8.0 Fix Pack 14 [http://www-01.ibm.com/support/docview.wss?uid=swg24044096]
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13 [http://www-01.ibm.com/support/docview.wss?uid=swg24044479]
8.0.0.15: WebSphere Application Server V8.0 Fix Pack 15 [http://www-01.ibm.com/support/docview.wss?uid=swg24044734]

SUBSCRIBE
You can track all active APARs for this component.

APAR STATUS
 * CLOSED AS PROGRAM ERROR.

ERROR DESCRIPTION
 *  If base entry and name in repository is different and
   clearCache functionality is used with clearEntity mode then
   virtual member manager (VMM) still looks in the cache and gets
   the entity from the cache instead of fetching it from the LDAP
   server.

LOCAL FIX
 *  test fix

PROBLEM SUMMARY
 *  ****************************************************************
   * USERS AFFECTED:  All users of IBM WebSphere Application      *
   *                  Server V8.0 and V8.5 virtual member         *
   *                  manager (VMM)                               *
   ****************************************************************
   * PROBLEM DESCRIPTION: Clear cache does not work if            *
   *                      clearEntity                             *
   *                      mode is used.                           *
   ****************************************************************
   * RECOMMENDATION:                                              *
   ****************************************************************
   LDAP Clear cache functionality of VMM does not work when using
   clearEntity mode. Problems occur only if there is a different
   base entry used than the name in the repository entry.

PROBLEM CONCLUSION
 *  This APAR fixes the issue. It clears the cache properly even if
   base entry is different than name in repository.

   The fix for this APAR is currently targeted for inclusion in
   fix packs 8.0.0.13 and 8.5.5.9.  Please refer to the
   Recommended Updates page for delivery information:
   http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980 [http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980]

TEMPORARY FIX

COMMENTS

APAR INFORMATION
 * APAR NUMBER
   PI47826

 * REPORTED COMPONENT NAME
   WEBS APP SERV N

 * REPORTED COMPONENT ID
   5724H8800

 * REPORTED RELEASE
   800

 * STATUS
   CLOSED PER

 * PE
   NoPE

 * HIPER
   NoHIPER

 * SPECIAL ATTENTION
   NoSpecatt / Xsystem

 * SUBMITTED DATE
   2015-08-28

 * CLOSED DATE
   2015-12-09

 * LAST MODIFIED DATE
   2015-12-09

 * APAR IS SYSROUTED FROM ONE OR MORE OF THE FOLLOWING:

 * APAR IS SYSROUTED TO ONE OR MORE OF THE FOLLOWING:

FIX INFORMATION
 * FIXED COMPONENT NAME
   WEBS APP SERV N

 * FIXED COMPONENT ID
   5724H8800

APPLICABLE COMPONENT LEVELS
 * R800 PSY
   UP

 * R850 PSY
   UP

Question:
Why is the reload() not clearing the attribute cache so I can see my newly updated LDAP data in real time? You are leveraging the reload() functionality as described in the blog post:
  https://www.ibm.com/developerworks/community/blogs/PortalL2Thoughts/entry/how_to_programatically_refresh_data_from_ldap64?lang=en

to refresh the attribute cache after a change has been made to data within your LDAP. The purpose of this reload() is to update the data in real time on the Portal server. You discover that you are calling the reload(); however, the newly updated data is not immediately available to the application. Why is that?

Answer:
If base entry and name in repository is different and
   clearCache functionality is used with clearEntity mode then
   virtual member manager (VMM) still looks in the cache and gets
   the entity from the cache instead of fetching it from the LDAP
   server.


IBM Wrong codepoints for non-ASCII characters inserted in UTF-8 database using CLP - United States CLP; insert; codepage; unicode; wrong codepoints; CharConversionException TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 During insert from the CLP there is no codepage conversion if operating system codepage and database codepage are both UTF-8. In this case data to be inserted should also be in UTF-8 encoding.

If data has a different encoding then the database codepage (this can be verified using any hex editor), then the operating system codepage should be changed to match the data's encoding in order to enforce the data conversion to the database codepage.

SYMPTOM
Error executing Select SQL statement. Caught by java.io.CharConversionException. ERRORCODE=-4220

 Caused by:
java.nio.charset.MalformedInputException: Input length = 4759
at com.ibm.db2.jcc.b.u.a(u.java:19)
at com.ibm.db2.jcc.b.bc.a(bc.java:1762)

CAUSE
During an insert of data using CLP characters, they do not go through codepage conversion.
If operating system and database codepage both are UTF-8, but the data to be inserted is not Unicode, then data in the database might have incorrect codepoints (not-Unicode) and the above error will be a result during data retrieval.

To verify the encoding for data to be inserted you can use any editor that shows hex representation of characters. Please verify the codepoints for non-ASCII characters that you try to insert. If you see only 1 byte per non-ASCII characters then you need to force the database conversion during insert from CLP to UTF-8 database.

To force codepage conversion during insert from the CLP make sure that the operating system codepage is non-Unicode and matching to the codepage of data when you insert data to Unicode database from non-Unicode data source.

Problem Details
An example problem scenario is as follows:

 1.  Create a database of type UTF-8:

     CREATE DATABASE <db> USING CODESET utf-8 TERRITORY US

 2.  Create a table that holds character data:

     CREATE TABLE test (col char(20))

 3.  Check operating system locale:

     locale LANG=en_US.UTF-8
     LC_CTYPE="en_US.UTF-8"

 4.  Insert the non-ASCII characters 'Ã' , '³', '©' which have codepoint 0x'C3', 0x'B3',0x'A9' in codepage 819 into the table:

     INSERT INTO test VALUES ('Ã')
     INSERT INTO test VALUES ('³')
     INSERT INTO test VALUES ('©')

 5.  By running the following statement, you can see that all INSERT statements caused only one byte to be inserted into the table:

     SELECT col, HEX(col) FROM test

     Ã C3
     ³ B3
     © A9

     However, the UTF-8 representation of those characters are: 0x'C383' for 'Ã', 0x'C2B3' for '³', and 0x'C2A9' for '©'.
     So these three rows in the table contain invalid characters in UTF-8.

 6.  When selecting from a column using the JDBC application, the following error will occur. This is expected because the table contains invalid UTF-8 data:
     Error executing Select SQL statement. Caught by java.io.CharConversionException. ERRORCODE=-4220
     Caused by:
     java.nio.charset.MalformedInputException: Input length = 4759
     at com.ibm.db2.jcc.b.u.a(u.java:19)
     at com.ibm.db2.jcc.b.bc.a(bc.java:1762)

 7.  Delete all rows with incorrect Unicode codepoints from the test table:
     DELETE * from test

 8.  Change the locale to one that matching codepage of data to be inserted:
     export locale=en_us. One of the way to determine the codepage for your data can be found here: http://www.codeproject.com/Articles/17201/Detect-Encoding-for-In-and-Outgoing-Text [http://www.codeproject.com/Articles/17201/Detect-Encoding-for-In-and-Outgoing-Text]. If you prepare data yourself using some editor please check the documentation for your editor to find out how to set up the codepage for data being prepared by the editor.

 9.  Insert data to the table:
     INSERT INTO test VALUES ('Ã')
     INSERT INTO test VALUES ('³')
     INSERT INTO test VALUES ('©')

 10. Verify that inserted data were converted to UTF-8 during insert:
     SELECT col, HEX(col) FROM test

     Ã C383
     ³ C2B3
     © C2A9

 11. Run your java application selecting Unicode data. No exception should be reported.

ENVIRONMENT
UNIX, Linux, Unicode database

DIAGNOSING THE PROBLEM
Verify that non-ASCII data have a proper Unicode codepoints in Unicode database

RESOLVING THE PROBLEM
Reinsert data with codepage conversion enforced by setting the operation system codepage matching to the codepage of data to be inserted

RELATED INFORMATION
 Export data: [http://www.ibm.com/developerworks/db2/library/techarticle/0210lau/0210lau.html]

Question:
Table ""."" could not be found

When doing a table mapping with DB2 as source, selecting a table which contains special characters on column comments like:

COMMENT ON COLUMN .. IS 'Test comment ‘1’ complete';

Mapping fails with following error message: Table . could not be found in the database.  What's the reason for the error?

Answer:
During an insert of data using CLP characters, they do not go through codepage conversion.
If operating system and database codepage both are UTF-8, but the data to be inserted is not Unicode, then data in the database might have incorrect codepoints (not-Unicode) and the above error will be a result during data retrieval.


IBM Health Checks and Introduction to Troubleshooting on a PureApplication System - United States  TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 This document describes how to check the health of your system, and when needed, where to start troubleshooting a problem on a PureApplication System.

RESOLVING THE PROBLEM
Use this document to confirm the health of your system.

Consider forwarding the PureApplication System Events to an external monitoring system, such as IBM Netcool/OMIbus. and enabling the call home feature.

With PureApplication System firmware versions 2.1.0.1 or newer you can use the System Health check report to see a consolidated view of some of the PureApplication System UI pages.

System > System Troubleshooting, click on System Health Check.
[/support/docview.wss?uid=swg21675742&aid=1] [/support/docview.wss?uid=swg21675742&aid=1]

The Lite Health Checks section lists a set of items which you can review every couple of days. These checks take about 15 minutes.

Full Health Checks lists a set items you can review every week to help you confirm your system is operational. There are more checks in this section.

Introduction to Troubleshooting and Contacting IBM Support and sending in your information are included to help when the information found during a health check is not as expected.

The checks include accessing information on both the System and Workload console. You will need System and Workload administration access.

LITE HEALTH CHECKS
Along with forwarding the events to a monitoring system, you might want to check the following items every couple of days. This should take about 15 minutes.

If the information displayed is not as expected, expand all sections of the web page and copy the page to a word processing document. Proceed to the Contacting IBM Support and sending in your information section of this document. Start with Step 1 where you will add this information from a word processing document.

Check Web Console Page Description High Availability Status of the system System Console > Troubleshooting, then expand the High Availability section. Under Service Code, the overall status should be "Online"when this feature is working properly. Problems System Console > System > Problems This view should be empty. However, if problems have been identified by the system, they will be listed here.

You can sort problems by any of the column headers. The "Created on" date is usually the most helpful. Investigate any problems that are reported here. When the issue has been resolved or determined to not be a real problem, delete the records.

Problems are not automatically deleted from this view. It is important to delete problems on resolution. Problems are often (but not always) associated with Events. There may be some overlap between information in this view and that presented in the Event Viewer.
Search the Support Portal [http://www.ibm.com/support/entry/portal/product/puresystems/pureapplication_system]for content that may help you avoid opening a service request. Events System Console > System > Events Events which have been identified by the system will be listed here. You can sort Events by any of the column headers but the "Updated on" and "Severity" are usually the most helpful. Some of the events are from problems experienced by the workload users and are critical to that workload but not to the entire system. Look for "critical" and "Call HOME events"
Search the Support Portal [http://www.ibm.com/support/entry/portal/product/puresystems/pureapplication_system]for content that may help you avoid opening a service request.

Compute Nodes System Console > Hardware > Compute Nodes Click on any Errors or Warning Events and review the "Health statistic" and other information on these pages.

Check that none of the nodes are in quiesced or stopped state. Click on each compute node in the system. Look for the word "Temperature". There are 2 values. Ambient Temperature and Maximum Ambient Temperature. Hover over the 'temperature icons' for these field to see the expected temperature range.

On the W1700, a compute node with an LED on might be an indication of a AIX Operation System problem on one if the Virtual Machines which is or was running. See: Node <node_nn> message: (System Event) system hardware failure, CMM Event: 77777703, Node Event: B200A101, Check log (Informational LED) is lit on compute node. [http://www.ibm.com/support/docview.wss?uid=swg21669085] This is not a hardware problem

Management Nodes System Console > Hardware > Management Nodes Look at the status of elements and events associated with the two PureSystems Manager nodes and the other two.

Click on any Errors or Warning Events and review the "Health statistic" and other information on these pages.

One of the PureSystem Managers should be marked as the leader with the word "Primary" in the "Type" field.

Any errors that are listed for management nodes can indicate significant problems. Job Queue System Console > System > Job Queue. You want to ensure that jobs are starting and finishing on this page.

Check the Started Queue for failures.

Click the check-box to show internal jobs to get a complete picture of the job queue.

It is quickest to sort by "Status" which will pull all failures to the top. Failures of individual deployment jobs should be reviewed with the team managing the system workload. Scan the information to look for pervasive system issues here. Failed Deployments Workload Console > Instances > All Instances Look over the list of all instances to find those that are failed that appear to be stuck initializing.

A large number of deployments in these failed or stalled states can indicate system wide problems that should be investigated. A few failed or error deployments will occasionally be there because of the way that these systems are being used by the team managing the work loads. Confirm all is well with the team working on these projects.

Scan the information to look for pervasive system issues here. FULL HEALTH CHECKS

Along with forwarding the events to a monitoring system, you might want to check the following items every week. The "Lite Health Check" are included in the "Full Health Check" list below.

If the information displayed is not as expected, expand all sections of the web page and copy the page to a word processing document. Proceed to the Contacting IBM Support and sending in your information section of this document. Start with Step 1 where you will add more information to the word processing document.

Check Web Console Page Description High Availability Status of the system System Console > Troubleshooting, then expand the High Availability section. Under Service Code, the overall status should be "Online" when this feature is working properly. Temperature System Console > Hardware > Infrastructure Map Click on the "Temperature" in the top menu bar.

Check the temperature values for the system Hover over the value to see acceptable range for this value. When checking component status in the following checks, look at the Temperature readings for the component.

Then check the temperature of each component in the following systems using the information under "Component Status" below.

Prior to V2.0, the temperature check on the storage node component is incorrect. Check for events concerning storage node (V7000 Storewize ) component instead.

Component Status System Console > Hardware > Infrastructure Map

For the components in the system, check the status shown on the web page.

If there is a red "!" , in the picture of the rack, click on the icon. The "Default section" will be presented with more information. If there are numbers after the red "!", click on the number and review the events posted. Check the "Updated on" column to see when the event was posted.

[/support/docview.wss?uid=swg21675742&aid=2] System Console > Hardware > Infrastructure Map Click on "Switch to Tree View"

Flex Chassis >

Chassis Management Module

Check that there are 2 Chassis Management Modules (CMM) and a primary and secondary listed for each chassis. Look for any alerts and review the information shown on the web page.
Click on each Chassis in the system. Look for the word "Temperature". There are 2 values. Ambient Temperature and Maximum Ambient Temperature. Hover over the 'temperature icons' for these field to see the expected temperature range.

[/support/docview.wss?uid=swg21675742&aid=2] System Console > Hardware > Compute Nodes Click on any Errors or Warning Events and review the health statistic and other information on these pages.

Check that none of the nodes are in quiesced or stopped state.
Click on each compute node in the system. Look for the word "Temperature". There are 2 values. Ambient Temperature and Maximum Ambient Temperature. Hover over the 'temperature icons' for these field to see the expected temperature range.

On the W1700, or W2700, a compute node with an LED on might be an indication of a AIX Operation System problem on one if the Virtual Machines which is or was running. See: Node <node_nn> message: (System Event) system hardware failure, CMM Event: 77777703, Node Event: B200A101, Check log (Informational LED) is lit on compute node. [http://www.ibm.com/support/docview.wss?uid=swg21669085] This is not a hardware problem

[/support/docview.wss?uid=swg21675742&aid=2] System Console > Hardware > Infrastructure > Management Node

Check the management nodes to make sure they are powered on and available.

One of the PureSystem Managers should have 'primary' in the type field.

Review the "Health statistic"

Look at the status of elements and events associated with the two PureSystems Manager nodes and the two Manager nodes. Click on any Errors or Warning Events and review the health statistic and other information on these pages.

One of the PureSystem Managers should be marked as the leader with "Primary" in the "Type" field.

Any errors that are listed for any management nodes can indicate significant problems. [/support/docview.wss?uid=swg21675742&aid=2] System Console > Hardware > Storage Devices Look at all the Storage Nodes and Storage Node Expansions to make sure the Disk Drives, LUNs, and Storage Controller Ports are all available for each node. Prior to V2.0, the temperature check on the storage node component is incorrect. Check for events concerning storage node (V7000 Storewize ) component instead.

In V2. the temperature is under the "Canister" section. Hover over the temperature gauge icon to confirm the temperatures are normal.

Problems System Console > System > Problems This view should be empty.

However, if problems have been identified by the system, they will be listed here. You can sort problems by any of the column headers but the "Created on" date is usually the most helpful. Investigate any problems that are reported here and when the issue has been resolved or determined to not be a real problem, delete the records.

Problems are not automatically deleted from this view. It is important to delete them on resolution. Problems are often (but not always) associated with Events. There may be some overlap between information in this view and that presented in the Event Viewer. Events System Console > System > Events Events which have been identified by the system they will be listed here. You can sort Events by any of the column headers but the "Updated on" and "Severity" are usually the most helpful. Some of the events are from problems experienced by the workload users and are critical to that workload but not to the entire system.

Job Queue System Console > System > Job Queue. You want to ensure that jobs are starting and finishing on this page.

Check the Started Queue for failures.

Click the check-box to show internal jobs to get a complete picture of the job queue. It is quickest to sort by Status which will pull all failures to the top. Failures of individual deployment jobs should be reviewed with the team managing the system workload. Scan the information to look for pervasive system issues here. Failed Deployments Workload Console > Instances > All Instances Look over the list of all instances to find those that are failed that appear to be stuck initializing.

A large number of deployments in these failed or stalled states can indicate system wide problems that should be investigated. A few failed or error deployments will occasionally be there because of the way that these systems are being used by the team managing the work loads. Confirm all is well with the team working on these projects. Validate Shared Services Workload Console > Instances > Shared Services Validate that shared services are running for all appropriate cloud groups and appear to be in good health. Work with the local patterns administrator to confirm the list of shared services that should be running for this system.

NOTE: It is not unusual for shared services to be stopped or not deployed for various reasons depending upon the use of the system. Check with the patterns administrator on the expected status of shared services. INTRODUCTION TO TROUBLESHOOTING

 1.  The first action is to open up a word processing document to capture the output of any the following steps which shows the problem. Use this technote entitled Organize your problem information [http://www.ibm.com/support/docview.wss?uid=swg21654210] concerning the problem for IBM Support. Copy this template into your word processing document.
 2.  Check System Console > System > Problems This view should be empty.  1. However, if problems have been identified by the system, they will be listed here. You can sort problems by any of the column headers but the
         "Created on" is usually the most helpful. Investigate any problems that are reported here and when the issue has been resolved or determined to not be a real problem, delete the record.
      2. Problems are not automatically deleted from this view. It is important to delete entries on resolution. Problems are often (but not always) associated with Events. There may be some overlap between information in this view and that presented in the Event Viewer.
      3. Search the support portal [http://www.ibm.com/support/entry/portal/product/puresystems/pureapplication_system] [http://www.ibm.com/]to see if there is an explanation of the message in the product documentation center, a technote, or APAR document.
      4. Otherwise, if you have problem listed which you would like IBM to investigate, export the problem. Add this to the document created with the organize your problem information [http://www.ibm.com/support/docview.wss?uid=swg21654210] technote. Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather. Proceed to the Contacting IBM Support and sending in your information section of this document.

 3.  Check the event log: System Console > System > Events  1. If Events have been identified by the system, they will be listed here. You can sort Events by any of the column headers but the "Updated on" and "Severity" are usually the most helpful. Investigate any problems.
      2. Some of the Events are from problems experienced by the workload users and are critical to that workload but not to the entire system. Check with the workload users to see if they are testing or also finding problems.
      3. Search the support portal [http://www.ibm.com/support/entry/portal/product/puresystems/pureapplication_system] to see [http://www.ibm.com/] if there is an explanation of the message in the product documentation, a technote, or APAR document.
      4. Check if the Event lists a hardware component and a hardware error. Look for the failing serial number, name or rack location number.  1. This document has a list of Events which you might see. Look under "Check these known problems first" in this technote. MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21666454] [http://www-01.ibm.com/support/docview.wss?uid=swg21666454]
          2. Check the status of the hardware component via: System Console > Hardware > Infrastructure Map.Try the "Switch to Tree View" option.
          3. If the symptoms describe an Event which requires investigation by IBM, save a copy of the information and gather the information listed in MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21666454] [http://www-01.ibm.com/support/docview.wss?uid=swg21666454]

      5. Otherwise, if you find an Event which you would like IBM to investigate, save the Event. You can export the one event. Use the organize your problem information [http://www.ibm.com/support/docview.wss?uid=swg21654210] technote to prepare to work with IBM Support. Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather. Proceed to the Contacting IBM Support and sending in your information section of this document.

 4.  Check the job queue: System Console > System >Job Queue  1. Under "Started Jobs Queue", check that jobs are running. If not, check the "Display Internal Jobs" check box. Refresh the screen using the "double arrows' under the "Started Jobs Queue" line. Confirm that there were internal jobs running, and successfully completing. Wait 10 minutes. If there are no internal jobs running or completing, save a capture of this screen. Then obtain a system collection set for IBM Support. Use the organize your problem information [http://www.ibm.com/support/docview.wss?uid=swg21654210] technnote to prepare to work with IBM Support. Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather. Proceed to the Contacting IBM Support and sending in your information section of this document.
      2. Look at the "Status" column for failed jobs. Wait and check this page again as you want to ensure that jobs are moving in the Started Queue and that there are not a large number of failures. Failures of individual deployment jobs are usually not a concern unless all deployment jobs seem to be failing.
      3. Consult with your team using the system to deploy business solutions to be sure these are expected failures, or that they are aware and working on the problem.
      4. To help you debug failed deployments, gather files via the Work Load Console. Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather.
      5. A "Pending" job is not actually running -- it is just queued up to run at some point in the future. The "Internal Backup Job" is queued up to run every day. You will always see this job in the queue as "Pending".
      6. Otherwise, if you want IBM to investigate, use the organize your problem information [http://www.ibm.com/support/docview.wss?uid=swg21654210] technote to copy the web page for IBM Support. Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather. Proceed to the Contacting IBM Support and sending in your information section of this document.

 5.  Check the storage nodes: System Console > Hardware > Storage Devices. Look at all the Storage Nodes and Storage Node Expansions to make sure the Disk Drives, LUNs, and Storage Controller Ports are all available for each node.  1. Check the "Total" and "Available" counts for Disk Drives, LUNS, and Ports. The values should be equal.
      2. If there is a problem, click on the "Generate" button on the "Request System Logs" line on the web page. This technote describes how to save and sending the logs: in MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System. [http://www.ibm.com/support/docview.wss?uid=swg21666454] Proceed to the Contacting IBM Support and sending in your information section of this document.

 6.  Check the Management Nodes: System Console > Hardware > Management Nodes. Look at the status of elements and events associated with those elements.  1. There are two PureSystems Manage nodes and the two virtualization manager nodes. One of the PureSystem Managers should be marked as the leader with the word "Primary" in the "Type" field. Look for any errors that are listed for any management nodes as they can indicate significant problems.
      2. If you do see a problem for IBM to investigate, click on the "Generate" button on the "Request System Logs" line on the web page. This technote describes how to save and sending the logs: MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System. [http://www.ibm.com/support/docview.wss?uid=swg21666454] Proceed to the Contacting IBM Support and sending in your information section of this document

 7.  Check the High Availability Status of the system: System Console > Troubleshooting, then expand the High Availability section.  1. In the table, there are service code and status column. The status column should show a status of "Online" when this feature is working properly.
      2. If the status is not "Online", paste this RESTAPI into the browser URL and save the output: https://<rack_ip>/admin/resources/service_status Copy this information into the word processing document and Proceed to the Contacting IBM Support and sending in your information section of this document

 8.  Check Chassis temperature: System Console > Hardware> Flex Chassis. Open the selection. There are 2 values: "Ambient Temperature" and "Maximum Ambient Temperature". Hover over the 'temperature icons' for these field to make sure the temperature is within range. If there is a red "!" , in the picture of the rack, click on the icon. The "Default section" will be presented with more information.  1. This document has a list of Events which you might see. One is concerning temperature. Look under "Check these known problems first" in this technote: MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System. [http://www.ibm.com/support/docview.wss?uid=swg21666454]
      2.  If there are numbers after the red "!", click on the number and review the events posted. Check the "Updated on" column to see when the event was posted.
      3. If you do see a problem for IBM to investigate, click on the "Generate" button on the "Request System Logs" line on the web page. This technote describes how to save and send in the logs: MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21666454]. Proceed to the Contacting IBM Support and sending in your information section of this document

 9.  Check the Network Switches: System Console >Hardware-> Networking devices. Click on each switch.  1. Look on the Events line for the red "!". If there is a number, click on the number to investigate the Event posted by the system.
      2. Confirm the switch shows the "Power Status" and "Status" as "Available".
      3. If you do see a problem for IBM to investigate, click on the "Generate" button on the "Request System Logs" line on the web page. This technote describes how to save and send in the logs: MustGather: Chassis Management Module, IBM Storwize V7000, Top of Rack Switch, San Switch, and Management EndPoint problems for IBM PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21666454]. Proceed to the Contacting IBM Support and sending in your information section of this document

 10. Check the DNS connectivity: System Console > Settings. Expand Domain Service (DNS) and use the "Lookup host name or IP address". Confirm you can connect to the expected IP addresses by IP and hostname. Consult with your team which manages the DNS sever for advice.
 11. Check for failed deployments: Workload Console > Instances > All Instances.  1. A few failed or error deployments will occasionally be there because of the way that these systems are being used and should not be of concern. Confirm all is well with the team working on these projects.
      2. A large number of deployments in these failed or stalled states can indicate system wide problems which should be investigated. Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather. Proceed to the Contacting IBM Support and sending in your information section of this document.

 12. The Troubleshooting chapters in the PureApplication System product documentation has more troubleshooting topics.
 13. Otherwise, if you see other problems which you would like IBM to investigate, use the organize your problem information [http://www.ibm.com/support/docview.wss?uid=swg21654210] technote to copy the web pages into a document to show the problem to IBM Support. [http://www.ibm.com/support/docview.wss?uid=swg21610259] Check the MustGather Read first for PureApplication System [http://www.ibm.com/support/docview.wss?uid=swg21610259] for information to gather. Proceed to the Contacting IBM Support and sending in your information section of this document.

CONTACTING IBM SUPPORT AND SENDING IN YOUR INFORMATION

Use the following technotes to contact IBM Support and send in the MustGather information:

 * Contacting IBM PureApplication System Support [http://www.ibm.com/support/docview.wss?uid=swg21609051] to open a PMR.
 * Use the IBM Secure Diagnostic Data Upload Utility [http://www.ibm.com/de/support/ecurep/send_java-tool.html] also called the Java Utility to upload the PureApplication System [http://www.ibm.com/de/support/ecurep/send.html]collections to greatly reduce the time to upload large files.
 * Exchanging information with IBM PureApplication System Technical Support for problem determination. [http://www.ibm.com/support/docview.wss?uid=swg21596913] [http://www.ibm.com/support/docview.wss?uid=swg21596913]
 * Review the PureApplication System Customer Support Plan [http://www-01.ibm.com/support/docview.wss?uid=swg21613951]
 * Do not send any confidential information from your company.

Question:
How can I check the health of my IBM PureApplication System? How can I check the health of my IBM PureApplication System?
Are there steps to verify that my system is healthy? Is this something I can do, or does IBM have to verify the health of my system?

Answer:
Consider forwarding the PureApplication System Events to an external monitoring system, such as IBM Netcool/OMIbus. and enabling the call home feature.

With PureApplication System firmware versions 2.1.0.1 or newer you can use the System Health check report to see a consolidated view of some of the PureApplication System UI pages.

System > System Troubleshooting, click on System Health Check.


IBM Packaging Utility 1.8 - United States service release; modpack; mod pack; upgrade; refresh; refresh pack DOWNLOADABLE FILES

ABSTRACT
 IBM Packaging Utility 1.8 has been made generally available and contains any fixes for client-reported and internally found defects.

DOWNLOAD DESCRIPTION

Table of Contents Sections Description  * What's new

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

 * Impact assessment

The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.

 * Prerequisites

The Prerequisites section provides important information to review prior to the installation of this release.

 * Download package

The Download package section provides the direct link to obtain the download package for installation in your environment.

 * Installation instructions

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

 * Known problems

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation Document Description  * Detailed System Requirements [http://www.ibm.com/support/docview.wss?uid=swg27036456]

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

 * IBM Knowledge Center [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.auth.ui.doc/helpindex_pu.html]

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

 * Fix List [http://www.ibm.com/support/docview.wss?uid=swg27036454#tab_1.8]

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.

PREREQUISITES

Prerequisites include: Review the Detailed System Requirements [http://www.ibm.com/support/docview.wss?uid=swg27036456] for any prerequisites required for this release.

Back to top

INSTALLATION INSTRUCTIONS

Use Installation Manager to install and update Packaging Utility. If Installation Manager is installed, you can use the Packaging Utility repository on www.ibm.com to install or update Packaging Utility without downloading files. If Installation Manager is not installed, you must download the Packaging Utility files. Installation Manager is included in the Packaging Utility download packages.

The installer package for Packaging Utility is pu.offering.disk.platform_version.zip where platform indicates the operating system and version indicates the version of Packaging Utility. The installer package contains files for only one platform. Using this package, you can install Packaging Utility and Installation Manager by running the install command. You can also add this package as a repository in Installation Manager and use the package to update Packaging Utility.

The fix pack package for Packaging Utility is pu.update_version.zip. The fix pack contains files for all supported platforms. You can add this fix pack as a repository to update Packaging Utility. You cannot install Packaging Utility or Installation Manager with this fix pack.

Packaging Utility is available in 64-bit mode. Review information information about bit mode for installation or updates: Packaging Utility bit mode information [https://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.auth.ui.doc/topics/r_pu_bit_mode.html].

For more information about Packaging Utility and Installation Manager, Review the Installation Manager Knowledge Center [http://www.ibm.com/support/knowledgecenter/SSDV2W/im_family_welcome.html].

INSTALL OR UPDATE PACKAGING UTILITY WITHOUT DOWNLOADING FILES
You must have Internet access and Installation Manager must be installed to install or update Packaging Utility without downloading files. The Packaging Utility repository located on www.ibm.com contains the latest version of Packaging Utility.

You must have an IBM user name and password to access the repository. To register for these credentials, go to: http://www.ibm.com/account/profile.

IBM Knowledge Center topics that are specified by operating system for installing and updating Packaging Utility. The installation topics contain information about downloading the Installation Manager installation files.

Operating System Action Packaging Utility topic located in the IBM Installation Manager Knowledge Center Windows
Linux
UNIX
Mac OS X operating system Installation Installing Packaging Utility in wizard mode [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.auth.ui.doc/topics/r_pu_wm.html] Installing Packaging Utility by using console mode [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_console_install.html] Installing or updating Packaging Utility by using imcl commands [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_install_imcl.html] Update Updating Packaging Utility in wizard mode [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.auth.ui.doc/topics/t_pu_update.html] Updating Packaging Utility by using console mode [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_console_update.html] Installing or updating Packaging Utility by using imcl commands [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_install_imcl.html] IBM z/OS Installation Installing Packaging Utility by using console mode [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_console_install.html] Installing or updating Packaging Utility by using imcl commands [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_install_imcl.html] Update Updating Packaging Utility by using console mode [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_console_update.html] Installing or updating Packaging Utility by using imcl commands [http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_pu_install_imcl.html]
Back to top

DOWNLOAD PACKAGE

The following sections provide detailed information related to this release.

Click the FC link below to obtain the release from Fix Central.

HOW CRITICAL IS THIS FIX?

Impact Assessment Impact Description Recommended This is a service release. It contains new features as well as fixes for client-reported and internally found defects.

Test Results

Close [x]

DEFINITIONS
Regression: An error in the Maintenance Delivery Vehicle [http://www.ibm.com/support/docview.wss?uid=swg27008656] (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

 * Coding errors that cause a regression
 * Documentation or packaging problems that cause a regression
 * Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

 * Fixed APARs which did not solve the original problem but did not break anything new
 * APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression

Notes:  * Regression and incomplete APARs are considered fix-in-error or MDV-in-error
 * Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
 * Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

Back to top

PROBLEMS SOLVED

Defects resolved Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

KNOWN SIDE EFFECTS

Review the following list of known issues and open defects: There are no known issues report.

OPEN DEFECTS
Review the following list of open defects for IBM Installation Manager and Packaging Utility [https://www-947.ibm.com/support/entry/myportal/search_results/rational/ibm_installation_manager?sn=spe&q=%22APAR%20status%22%20OPEN&prod=N340276G72802P18&filter=language:en&productContext=864296863#q%3D%22APAR%20status%22%20OPEN%26filter%3DDC.Type%3ACT748%2Blanguage%3Aen%26prod%3DN340276G72802P18] on the IBM Support Portal.

Review technote 1461170: Open APARs for Rational products available on the Web [http://www.ibm.com/support/docview.wss?uid=swg21461170] for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Back to top

CHANGE HISTORY

What's new No new features or functions.

Back to top

Click the link in the Download Options column:

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central(FC)? [https://www.ibm.com/support/fixcentral/help?page=swfaqs] Packaging Utility downloads (1.8) 11 Sep 2014 English 1 FC [http://www.ibm.com/support/fixcentral/swg/quickorder?parent=ibm%7ERational&product=ibm/Rational/IBM+Packaging+Utility&release=All&platform=All&function=all&source=fc] [ ]
TECHNICAL SUPPORT

TAB NAVIGATION
 * General Support Information- selected tab,
 * Support Resources [http://www.ibm.com/support/docview.wss?uid=swg27020747]- selected tab,

IBM Rational Software Support Communities

 * Visit the IBM Support Portal [http://www.ibm.com/support/entry/portal/Overview/Software/Rational/product] to configure your support portal experience and review FAQs, lists of known problems, fixes, and a wealth of important support information.

 * Visit developerWorks [http://www.ibm.com/developerworks/rational/] to access an online collection of tutorials, sample code, standards, forums and other resources provided by experts at IBM to assist software developers using Rational tools including access to the IBM RFE Community [http://www.ibm.com/developerworks/rfe/].

 * Visit the Jazz Community [http://jazz.net/] if you use a Rational product created using the Jazz platform to interact directly with the Jazz development team and other community members, download product trials and betas and track developement progress.

HELPFUL HINTS FOR OBTAINING TECHNICAL ASSISTANCE:
Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

 * What software versions were you running when the problem occurred?
 * Do you have logs, traces, or messages that are related to the problem?
 * Can you reproduce the problem? If so, what steps do you take to reproduce it?
 * Is there a workaround for the problem? If so, be prepared to describe the workaround.

If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support [http://www.ibm.com/software/support/exchangeinfo.html].

Follow IBM Rational Client Support on Twitter [http://twitter.com/rationalsupport] | Facebook [http://facebook.com/rationalsupport] | YouTube [http://www.youtube.com/ibmrationalsupport] | devWorks Blog [https://www.ibm.com/developerworks/mydeveloperworks/blogs/nfrsblog/?lang=en]

 Back to top

Question: How to install Packaging utility? How to install Packaging utility?

Answer: Use Installation Manager to install and update Packaging Utility.


IBM License features incorporated in "Tools and Utilities" key while generating Rational Rhapsody licenses - United States Tools and Utilities; License Feature TECHNOTE (FAQ)

QUESTION
 What are the features incorporated with the "Tools and Utilities" License key for IBM Rational Rhapsody?

CAUSE
You would like to know all the features of the Tools and Utilities license key

ANSWER
The license features that come incorporated with IBM Rational Rhapsody Tools & Utilities Add on keys are as follows:

 * ReporterPro
 * Reporter
 * RPGetConnected
 * RPGetConnectedWind
 * RPGetConnectedVxw
 * RPGetConnectedSol
 * RPGetConnectedN
 * RPGetConnectedG
 * RPUNCS
 * RPTcSEAddon
 * RPGraphPanel
 * RPRG
 * RPRG_DOORS
 * RPRG_X2TXT
 * RPRG_REQPRO
 * RPRG_RP
 * RPRG_SIMULINK
 * RPRG_TAGGER
 * RPRG_CALIBERRM
 * RPUSimulink
 * RPXMI
 * RPTAUXMI

Note: Important functionalities of Rational Rhapsody such as Gateway [ RPRG], Import and Export of XMI files in Rhapsody [RPXMI], Panel Diagrams [RPGraphPanel] and Reporter Plus [ReporterPro] among others are covered

RELATED INFORMATION
 Rational DOORS license features [http://www-01.ibm.com/support/docview.wss?uid=swg21607708]
Rational TAU License features [http://www-01.ibm.com/support/docview.wss?uid=swg21608087]
Rational Build Forge features [http://www-01.ibm.com/support/docview.wss?uid=swg21608803]
Rational Dashboard [http://www-01.ibm.com/support/docview.wss?uid=swg21608812]

Question: Can you enable the reporter feature with IBM Rational Rhapsody Architect Software Floating license? Can you enable the reporter feature with IBM Rational Rhapsody Architect Software Floating license?

Answer:
The license features that come incorporated with IBM Rational Rhapsody Tools & Utilities Add on keys are as follows:

 * ReporterPro
 * Reporter


IBM PI53566: ON DEMAND ROUTER MEMORY LEAK WHEN UPGRADING APPLICATIONS UNDER LOAD - United States   FIXES ARE AVAILABLE
PI53566:on demand router memory leak when upgrading applications under load [http://www-01.ibm.com/support/docview.wss?uid=swg24041964]
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9 [http://www-01.ibm.com/support/docview.wss?uid=swg24041819]
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10 [http://www-01.ibm.com/support/docview.wss?uid=swg24042150]
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11 [http://www-01.ibm.com/support/docview.wss?uid=swg24043005]
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12 [http://www-01.ibm.com/support/docview.wss?uid=swg24043844]
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13 [http://www-01.ibm.com/support/docview.wss?uid=swg24044479]

SUBSCRIBE
You can track all active APARs for this component.

APAR STATUS
 * CLOSED AS PROGRAM ERROR.

ERROR DESCRIPTION
 *  The On Demand Router (ODR) has a memory leak related to
   HttpRouteAction objects such that when the system is under load
   and there are configuration changes such as uninstalling and
   installing applications it is possible that multiple, redundant
   HttpRouteAction objects can be created with registered
   listeners for ODC tree changes but never removed.  This will
   eventually fill up the available heap space and cause an Out Of
   Memory issue on the ODR.  Restarting the ODR will correct the
   problem.

LOCAL FIX
 *  Restart the ODR.

PROBLEM SUMMARY
 *  ****************************************************************
   * USERS AFFECTED:  All users of IBM WebSphere Application      *
   *                  Server Intelligent Management using the     *
   *                  java On Demand Router (ODR).                *
   ****************************************************************
   * PROBLEM DESCRIPTION: An Out Of Memory error can be seen on   *
   *                      the On Demand Router because            *
   *                      HttpRouteAction objects can             *
   *                      accumulate.                             *
   ****************************************************************
   * RECOMMENDATION:                                              *
   ****************************************************************
   There is a code bug where HttpRouteAction objects can
   accumulate because they are not freed. This is particularly
   noticeable when there are routing rules present, many
   applications installed, and multiple configuration changes
   happening on the system (such as installing or removing
   applications). Over time this can cause exhaustion of the
   available heap and an Out Of Memory error for the On Demand
   Router.

PROBLEM CONCLUSION
 *  The area of code was corrected to release the HttpRouteAction
   objects. This fix supercedes PI51978 [http://www-01.ibm.com/support/docview.wss?uid=swg1PI51978].

   The fix for this APAR is currently targeted for inclusion in
   fix pack 8.5.5.9.  Please refer to the Recommended Updates
   page for delivery information:
   http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980 [http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980]

TEMPORARY FIX

COMMENTS

APAR INFORMATION
 * APAR NUMBER
   PI53566

 * REPORTED COMPONENT NAME
   WEBSPHERE APP S

 * REPORTED COMPONENT ID
   5724J0800

 * REPORTED RELEASE
   850

 * STATUS
   CLOSED PER

 * PE
   NoPE

 * HIPER
   NoHIPER

 * SPECIAL ATTENTION
   NoSpecatt / Xsystem

 * SUBMITTED DATE
   2015-12-04

 * CLOSED DATE
   2016-01-22

 * LAST MODIFIED DATE
   2016-03-23

 * APAR IS SYSROUTED FROM ONE OR MORE OF THE FOLLOWING:

 * APAR IS SYSROUTED TO ONE OR MORE OF THE FOLLOWING:

FIX INFORMATION
 * FIXED COMPONENT NAME
   WEBSPHERE APP S

 * FIXED COMPONENT ID
   5724J0800

APPLICABLE COMPONENT LEVELS
 * R700 PSY
   UP

 * R850 PSY
   UP

Question: ODR OOM issue I got ODR OOM after upgrading the WAS to v8553. No configuration or traffic load changing. Do I need a fix pack?

Answer:
The fix for this APAR is currently targeted for inclusion in
   fix pack 8.5.5.9.


IBM Download Parascript FieldScript for IBM Datacap Taskmaster Capture V8.0.1, V8.1.0, and IBM Datacap V9.0.0. - United States  DOWNLOADABLE FILES

ABSTRACT
 This document contains information about obtaining Parascript FieldScript for IBM Datacap Taskmaster Capture Versions 8.0.1 and 8.1.0, and for IBM Datacap Version 9.0.0.

DOWNLOAD DESCRIPTION
Parascript FieldScript for IBM Datacap Versions 8.0.1, 8.1.0, and 9.0.0, and the associated data disk that contains the United States Postal Service (USPS) database are available for download only through Passport Advantage.

The address information in the USPS database on the data disk is automatically disabled 105 days after the date of issue. IBM refreshes the data disk on the 14th day of every month, or the previous business day. You must ensure that you obtain the refreshed data from Passport Advantage on a regular schedule so that you avoid issues that are associated with disabled address information.

PREREQUISITES
See the following website for detailed system requirements.

URL LANGUAGE SIZE(Bytes) Hardware and software requirements [http://www.ibm.com/support/docview.wss?uid=swg27043811] English 15234
INSTALLATION INSTRUCTIONS
See the Parascript(R) FieldScript(R) for IBM Datacap Taskmaster Capture Version 8.0.1 Guide for installation instructions.

Click on the other links for related information.

URL LANGUAGE SIZE(Bytes) Parascript FieldScript for Taskmaster Guide [http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss?CTY=US&FNC=SRX&PBL=GC19-3374-00] English 55555 IBM Datacap Publication Library [http://www.ibm.com/support/docview.wss?uid=swg27043856] English 1000 Parascript FieldScript with Datacap V8.1.0 & V9.0.0 [http://www.ibm.com/support/docview.wss?uid=swg27035840] English 1000
DOWNLOAD PACKAGE
To download Parascript FieldScript, sign in to Passport Advantage [http://www.ibm.com/software/howtobuy/passportadvantage/pao_customers.htm] by using your IBM ID. If you are not a returning customer or you do not have an IBM ID, you can register to obtain an IBM ID.

After you sign in to Passport Advantage, you can select the software to which you are entitled to download.

Click the HTTP link to go to the Passport Advantage Online website.

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options Passport Advantage Online 16 Dec 2011 English 1024 HTTP [http://www.ibm.com/software/howtobuy/passportadvantage/pao_customers.htm]
TECHNICAL SUPPORT
 Passport Advantage Online support:
https://www.ibm.com/software/howtobuy/passportadvantage/paocustomer/docs/en_US/ecare.html [https://www.ibm.com/software/howtobuy/passportadvantage/paocustomer/docs/en_US/ecare.html]

IBM Datacap Taskmaster Capture V8.0.1 and V8.1.0 support: http://www.ibm.com/support/entry/portal/Overview/Software/Information_Management/Datacap_Taskmaster_Capture [http://www.ibm.com/support/entry/portal/Overview/Software/Information_Management/Datacap_Taskmaster_Capture]

Cross reference information Segment Product Component Platform Version Edition Enterprise Content Management Datacap Taskmaster Capture

Question:
Problem with Postal database in Parascript  Hi

i am working with Parascript and i have installed successfully in my local system by folloing this guide [ Parascript FieldScript for Taskmaster Guide ]

here i can able to create vocabulary file, but storing multiple values into this the values are overridden and i do not understand how to create a postal database and access it

is that postal database is separate component ,,?? do we need to get somewhere and install ,,? they just mention in Guide the use of actions only

and does this parascript really helps to get better recognize.

Answer: The address information in the USPS database on the data disk is automatically disabled 105 days after the date of issue. IBM refreshes the data disk on the 14th day of every month, or the previous business day. You must ensure that you obtain the refreshed data from Passport Advantage on a regular schedule so that you avoid issues that are associated with disabled address information.


IBM Including long descriptions in the Maximo Enterprise Adapter - United States long description; ldkey; hasld; MEA; TPAEINTEGRATION TECHNOTE (FAQ)

QUESTION
 How do I include long descriptions when sending data in using the Maximo Enterprise Adapter (MEA) or Maximo Integration Framework (MIF)?

ANSWER

Maximo 6.x MEA

1. Go To Integration -> Integration Object

On the Persistent Fields tab, exclude HASLD
On the Non-Persistent Fields tab, include DESCRIPTION_LONGDESCRIPTION

Maximo 7.x MIF

1. Go To Integration -> Object Structures

Click Select Action -> Exclude/Include Fields

On the Persistent Fields tab, exclude HASLD
On the Non-Persistent Fields tab, include DESCRIPTION_LONGDESCRIPTION

Maximo 6.x/7.x XML

Add the long description tag to the inbound XML:

<DESCRIPTION_LONGDESCRIPTION>xxxxx</DESCRIPTION_LONGDESCRIPTION>

Do not include the HASLD tag. This column will be set automatically.

The same process will work for sending data in using flat files and interface tables, however, you must use an alias for DESCRIPTION_LONGDESCRIPTION on DB2 and SQL Server since the column name is longer than 18. If your object structure has multiple MBOs with long descriptions, you will have to use an alias to identify each column name uniquely.

Cross reference information Segment Product Component Platform Version Edition Systems and Asset Management Maximo Enterprise Adapter Not Applicable

Question: Jobtask long description How do I modify the JP sheet to include the JOBTASK Long description in the query.  I have tried JOBTASK.DESCRIPTION.DESCRIPTION_LONGDESCRITION and other combinations but they do not seem to work.

Answer:
Maximo 6.x MEA

1. Go To Integration -> Integration Object

On the Persistent Fields tab, exclude HASLD
On the Non-Persistent Fields tab, include DESCRIPTION_LONGDESCRIPTION

Maximo 7.x MIF

1. Go To Integration -> Object Structures

Click Select Action -> Exclude/Include Fields

On the Persistent Fields tab, exclude HASLD
On the Non-Persistent Fields tab, include DESCRIPTION_LONGDESCRIPTION

Maximo 6.x/7.x XML

Add the long description tag to the inbound XML:

<DESCRIPTION_LONGDESCRIPTION>xxxxx</DESCRIPTION_LONGDESCRIPTION>

Do not include the HASLD tag. This column will be set automatically.


IBM CWWIM1011E during PUMA lookup using SAML Trust Association Interceptor - United States SAML; SSO; TAI; PUMA; CWWIM1011E; InvalidUniqueNameException TECHNOTE (TROUBLESHOOTING)

PROBLEM
After configuring the Security Assertion Markup Language (SAML) SAML Trust Association Interceptor (TAI) in WebSphere Application Server, you attempt to access WebSphere Portal after authenticating to your Identity Provider (IdP), but you are unable to view the Portal page.

SYMPTOM
- Portal page is blank

- SystemOut.log contains the following error at the time of the problem occurrence:

com.ibm.websphere.wim.exception.InvalidUniqueNameException: CWWIM1011E
The '<userId>' unique name is not valid.

CAUSE
SAML TAI parameter sso_<n>.sp.idMap = is configured to use "idAssertion" which results in the userid instead of the fully distinguished name of the user to be set in the JAAS subject. Portal then uses this value to query Virtual Member Manager (VMM) via findUserByIdentifier() and the failure occurs since the value is not formatted as a distinguished name.

DIAGNOSING THE PROBLEM
- Collect Portal Login troubleshooting data [http://www-01.ibm.com/support/docview.wss?uid=swg21592791]

- Look for the following in security.xml:
<interceptors xmi:id="TAInterceptor_<identifier>" interceptorClassName="com.ibm.ws.security.web.saml.ACSTrustAssociationInterceptor">
...
<trustProperties xmi:id="Property_<identifier>" name="sso_1.sp.idMap" value="idAssertion"/>

Note: There may be more than one sso_<n>.sp.idMap property (for example, sso_1.sp.idMap, sso_2.sp.idMap, etc).

RESOLVING THE PROBLEM

Option #1:

The idAssertion value means that no entry is necessary for the user in the user registry, which is not supported in WebSphere Portal by default. Update the sso_<n>.sp.idMap property via the Integrated Solutions Console to use the value "localRealm" instead of "idAssertion."

The localRealm value ensures that WebSphere Application Server will complete the JAAS Subject with the full distinguished name for the user by querying the user registry and thus Portal will pass the correct format to VMM.

Option #2:

Transient user support [http://www-01.ibm.com/support/knowledgecenter/SSHRKX_8.5.0/mp/overview/new_cf08.dita?lang=en] has been introduced for SAML TAI [http://www-01.ibm.com/support/knowledgecenter/SSHRKX_8.5.0/mp/wcm/wcm_secure_int_tai_auth.dita?lang=en] starting with Cumulative Fix (CF) #8 for 8.5. Refer to the WebSphere Portal Security blog [https://www.ibm.com/developerworks/community/blogs/8f2bc166-3bdc-4a9d-bad4-3620dbb3e46c/entry/portal_transient_user_support_with_was_saml_tai_business_case_clarification?lang=en] for more details regarding the business case and implementation details.

Note: WebSphere Portal also provides transient user support when configured with OpenId authentication [http://www-01.ibm.com/support/knowledgecenter/SSHRKX_8.5.0/mp/security/use_openid.dita?lang=en].

RELATED INFORMATION
 Understanding the SAML Trust Association Interceptor [http://www.ibm.com/developerworks/websphere/techjournal/1307_lansche/1307_lansche.html]
WebSphere Portal Support Statement [http://www-10.lotus.com/ldd/portalwiki.nsf/dx/WebSphere_Portal_Support_Statement_wp8]

Question: Is transient user support available for SAML integration with WebSphere Portal 8.0? I am looking to leverage the SAML TAI provided by WebSphere Application Server for my WebSphere Portal 8.0 environment. Is transient user support available so that I do not have to maintain a local account in my Portal user registry for every external user which is verified and trusted by my identity provider?

Answer: Transient user support [http://www-01.ibm.com/support/knowledgecenter/SSHRKX_8.5.0/mp/overview/new_cf08.dita?lang=en] has been introduced for SAML TAI [http://www-01.ibm.com/support/knowledgecenter/SSHRKX_8.5.0/mp/wcm/wcm_secure_int_tai_auth.dita?lang=en] starting with Cumulative Fix (CF) #8 for 8.5. Refer to the WebSphere Portal Security blog [https://www.ibm.com/developerworks/community/blogs/8f2bc166-3bdc-4a9d-bad4-3620dbb3e46c/entry/portal_transient_user_support_with_was_saml_tai_business_case_clarification?lang=en] for more details regarding the business case and implementation details.


IBM ADMIN_CMD('load from ...') using JDBC in XA transaction gets SQL30090N - United States  TECHNOTE (FAQ)

QUESTION
 Why does ADMIN_CMD('load from ...') using JDBC in XA transaction get SQL30090N?

CAUSE
It is an known current limitation of DB2.

ANSWER
Here is an example message from a jdbctrace.log

-------------------
[jcc] BEGIN TRACE_DIAGNOSTICS
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03] java.sql.SQLWarning
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] DB2 SQLCA from server
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlCode = 20397
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlErrd = { 0, 2, 0, 0, 0, 0 }
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlErrmc = SYSPROC.ADMIN_CMD;SQL30090;^@
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlErrmcTokens = { SYSPROC.ADMIN_CMD, SQL30090, ^@ }
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlErrp = DB2LOAD
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlState = 01H52
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03][Sqlca@f3177864] SqlWarn =
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03] SQL state = 01H52
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03] Error code = 20397
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03] Tokens = SYSPROC.ADMIN_CMD;SQL30090;^@
[jcc][Thread:WebContainer : 0][SQLWarning@2cab0b03] Stack trace follows
com.ibm.db2.jcc.am.SqlWarning: DB2 SQL Warning: SQLCODE=20397, SQLSTATE=01H52,
SQLERRMC=SYSPROC.ADMIN_CMD;SQL30090;^@, DRIVER=4.19.49
-------------------

Symptoms:
- It does not throw any exception and the application finished without any problem but
the data is not actually loaded into the table.
- If the same operation without XA transaction, it is succeeded and loaded data.
- From jdbctrace, SQL20397W and SQL30090N are logged.

The reason why:
The cause of the problem is LOAD does internal commit near the beginning of
operation. The load internal commit got back SQL30090 error is standard
behavior in XA environment. So ADMIN_CMD + LOAD does not work on XA.

Workaround:
Unfortunately, there is no way to do ADMIN_CMD + LOAD on XA.

RELATED INFORMATION
 LOAD command using the ADMIN_CMD procedure [https://www.ibm.com/support/knowledgecenter/en/SSEPGG_10.5.0/com.ibm.db2.luw.sql.rtn.doc/doc/r0023577.html ]
SQL30090N [https://www.ibm.com/support/knowledgecenter/en/SSEPGG_10.5.0/com.ibm.db2.luw.messages.sql.doc/doc/msql30090n.html ]
A Japanese translation is available [http://www.ibm.com/support/docview.wss?uid=swg21996128]

Question:
Are there any known issue or limitation to LOAD data using ADMIN_CMD stored procedure? Hello,

We have JDBC applications on WebShpere, LOAD data using ADMIN_CMD. Now, we are planning to use them under XA environment. Are there any known issue or limitation to LOAD data using ADMIN_CMD under XA environment?

Answer: It is an known current limitation of DB2.


IBM 'Save and Close' and 'Save' buttons grayed out in desktop configuration - United States ICN; Content Navigator; Save; Save and Close; Button TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 In IBM Content Navigator, when configuring a desktop, the 'Save and Close' and 'Save' buttons may be disabled.

CAUSE
One of the required fields in the configuration does not have a value

RESOLVING THE PROBLEM
IBM Content Navigator configuration tabs that contain required fields are flagged with a red asterisk to the side of the tab label. For a desktop configuration, General, Repositories, Layout, and Menus tabs contain required fields. Make sure all these fields have a value. The following screen shot provides an illustration of the tabs that contain required fields.

[/support/docview.wss?uid=swg21975568&aid=1] [/support/docview.wss?uid=swg21975568&aid=1]

Question: 'Save and Close' and 'Save' buttons grayed out in desktop configuration In IBM Content Navigator, when configuring a desktop, the 'Save and Close' and 'Save' buttons may be disabled.

Answer: One of the required fields in the configuration does not have a value


IBM Tivoli Netcool/OMINbus Java Gateway for ServiceNow (nco_g_servicenow-3_0) - United States release notice; downloads; Netcool/OMNIbus Java Gateway for ServiceNow; nco_g_servicenow NEWS

ABSTRACT
 This new gateway will be ready for downloading on November 24, 2016.

CONTENT

This version addresses the following enhancement requests:

 * RFE 85941: Enhancement to add HTTP proxy support. New property updated to specify the HTTP proxy with optional port.
 * RFE 88118: Enhancement to allow the gateway to accommodate a change in REST API behavior between ServiceNow versions Eureka/Fiji compared to Geneva.

You can download the installation package from the IBM Passport Advantage website:
www.ibm.com/software/howtobuy/passportadvantage/pao_customers.htm [http://www.ibm.com/software/howtobuy/passportadvantage/pao_customers.htm]

You can access the latest version of the guide written for this gateway on the IBM Knowledge Center:

www.ibm.com/support/knowledgecenter/SSSHTQ/omnibus/gateways/snowgw/wip/concept/snowgw_intro.html [https://www.ibm.com/support/knowledgecenter/SSSHTQ/omnibus/gateways/snowgw/wip/concept/snowgw_intro.html]

Netcool/OMNIbus V8.1

If you are running Netcool/OMNIbus V8.1, a single package contains versions of the gateway for all supported Operating Systems. To obtain this new package, use the Find by part number field to search for part number: CNFT1EN

 Note: The Netcool/OMNIbus V8.1 version of this gateway supports the following Operating Systems: AIX, Linux, Solaris, Windows and zLinux.

Netcool/OMNIbus V7.4.0

If you are running Netcool/OMNIbus V7.4.0, a separate package is supplied for each Operating System. To obtain this new package, use the Find by part number field to search for the part number that corresponds to your Operating System as shown in the table below.

Part number Operating System CNFQ2EN AIX CNFQ3EN HP-UX Integrity CNFQ4EN Linux for zSeries CNFQ5EN Linux CNFQ6EN Solaris CNFQ7EN Windows Note: Some versions of some web browsers can introduce random characters into text copied from web pages to the clipboard. In such cases, if you copy and paste part numbers from this release notice into Passport Advantage search fields, the search engine might not return the correct result. If you are encountering problems locating packages in Passport Advantage, remove any characters generated by the copy-paste operation before searching, or manually enter the part numbers into the search field.

If, for any other reason, you cannot find installation packages in Passport Advantage, contact eCustomer care using the contact information on the following website: https://www-112.ibm.com/software/howtobuy/passportadvantage/paocustomer/docs/en_US/ecare_emea.html [https://www-112.ibm.com/software/howtobuy/passportadvantage/paocustomer/docs/en_US/ecare_emea.html]

Question: Does the IBM Netcool Omnibus ServiceNow Gateway support Geneva Release ? Users of this gateway are asking if we support the latest release of ServiceNow Geneva instance?

Answer: Enhancement to allow the gateway to accommodate a change in REST API behavior between ServiceNow versions Eureka/Fiji compared to Geneva.


IBM SPSS Student Version and Graduate Pack Resources - United States SPSS Support Acquisition Statistics Stats Grad Pack Student TECHNOTE (FAQ)

QUESTION
 Where do I get support for IBM SPSS Student Version or Graduate Pack software?

ANSWER
Step 1:
For installation & licensing issues on Student version and Graduate pack, contact your vendor.

 * Hearne [http://www.hearne.software/Software/SPSS-Grad-Packs-for-Students-by-IBM/FAQ]
 * On the Hub [http://onthehub.com/]
 * StudentDiscounts.com [http://studentdiscounts.com/contact-us.aspx]
 * JourneyEd [https://www.journeyed.com/contact]
 * thinkEDU [https://thinkedu.desk.com/]
 * Studica [http://www.studica.com/technical-support]

Cross reference information Segment Product Component Platform Version Edition Business Analytics SPSS Amos Windows Not Applicable Grad Pack, Shrinkwrap, Campus Business Analytics SPSS Modeler Platform Independent Not Applicable Business Analytics SPSS Text Analytics for Surveys Windows Not Applicable Business Analytics SPSS Statistics Platform Independent Not Applicable Campus Edition, Grad Pack, Student Version

Question: Hello - I recently installed SPSS 20, my temporary period for running spss has expired, I am in need of the actual license code to fully install. my Lock code is: 4-20C30 Hello - I recently installed SPSS 20, my temporary period for running spss has expired, I am in need of the actual license code to fully install. my Lock code is: 4-20C30 . please help!

Answer: For installation & licensing issues on Student version and Graduate pack, contact your vendor.


IBM Unable to login to StoredIQ Dataserver and Gateway using ssh - United States StoredIQ ssh TECHNOTE (FAQ)

QUESTION
 Why I am not able to login to StoredIQ Dataserver and Getway using ssh?

CAUSE
Restriction in remote login using ssh

ANSWER

 1. Review the file /etc/ssh/sshd_config on the specific server using console
 2. Make sure PermitRootLogin is set to yes
 3. Save the change in the file
 4. Restart the appliance

Question: Why I am not able to login to StoredIQ Dataserver and Getway using ssh? Why I am not able to login to StoredIQ Dataserver and Getway using ssh?

Answer: Restriction in remote login using ssh


IBM Some versions of IBM Business Process Manager (BPM) and IBM Business Monitor do not support certain Java versions running with WebSphere Application Server Network Deployment V8.5 - United States ibpma85relnotes; ibpms85relnotes; ibpme85relnotes; iid85relnotes; ibpma8501relnotes; ibpms8501relnotes; ibpme8501relnotes; iid8501relnotes TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 Java 6™ on WebSphere Application Server V8.5 reaches end of service (EOS) in April 2018. For more information, see the "Software withdrawal and service discontinuance: IBM WebSphere Application Server V7 and V8 and select IBM WebSphere products and part numbers - Some replacements available" announcement (http://www.ibm.com/common/ssi/ShowDoc.wss?docURL=/common/ssi/rep_ca/3/897/ENUS916-143/index.html&request_locale=en [http://www.ibm.com/common/ssi/ShowDoc.wss?docURL=/common/ssi/rep_ca/3/897/ENUS916-143/index.html&request_locale=en]).

Extended support is not offered for Java 6, so you should use Java 7 or Java 8 instead. If Java 7 is not supported on your current version, you must upgrade to IBM Business Process Manager (BPM) V8.5.7 and IBM Business Monitor V8.5.7. If Java 8 is not supported on your current version, you must upgrade to IBM BPM V8.6.

IBM BPM zOS V8.5.0.2 supports Java 7.1 (IBM WebSphere Application Server V8.5.5.5 as a prerequisite).

IBM Process Designer in IBM BPM V8.5.7.0 CF 2017.03 or later versions is bundled with Java 7.

RESOLVING THE PROBLEM
Use the appropriate Java version for the version of IBM BPM or IBM Business Monitor you are using:

Product version Supported Java version IBM BPM V8.6 Java 8* IBM BPM V8.5.7.0 Java 6 or Java 7* IBM BPM V8.5.6.0 Java 6 or Java 7* IBM BPM V8.5.5.0 Java 6 IBM BPM V8.5.0.x Java 6 [/support/docview.wss?uid=swg21639640&aid=1] [/support/docview.wss?uid=swg21639640&aid=1] IBM Business Monitor V8.5.7.0 Java 6 or Java 7* Business Monitor V8.5.6.0 Java 6 or Java 7* Business Monitor V8.5.5.0 Java 6 [/support/docview.wss?uid=swg21639640&aid=1] [/support/docview.wss?uid=swg21639640&aid=1] *Java snippets, Java conditions, and Java expressions in BPEL processes must use Java 6 constructs instead of Java 7 or Java 8 constructs.
For more information, see the following resources:
 * Verify Java SDK version shipped with IBM WebSphere Application Server fix packs [http://www.ibm.com/support/docview.wss?uid=swg27005002]
 * Support for Java 6 with Business Process Manager and Business Monitor ending April 2018 [http://www.ibm.com/support/docview.wss?uid=swg21999583]

Cross reference information Segment Product Component Platform Version Edition Business Integration IBM Business Process Manager Standard Installation / Configuration AIX, Linux, Solaris, Windows 8.5.7, 8.5.6, 8.5.5, 8.5.0.2, 8.5.0.1, 8.5 Business Integration IBM Business Process Manager Express Installation / Configuration Linux, Windows 8.5.7, 8.5.6, 8.5.5, 8.5.0.2, 8.5.0.1, 8.5 Business Integration IBM Business Monitor Installation AIX, Linux, Solaris, Windows, z/OS 8.5.7, 8.5.6, 8.5.5 Business Integration IBM Business Process Manager Advanced Installation / Configuration AIX, Linux, Solaris, Windows, z/OS 8.5.7, 8.5.6, 8.5.5, 8.5.0.2, 8.5.0.1, 8.5 Business Integration IBM Business Process Manager Family Installation / Configuration AIX, Linux, Windows 8.6.0.0 IBM Business Process Manager Server Express
PRODUCT ALIAS/SYNONYM
 BPM
Monitor

Question:
Is Java 8 supported for BPM?

I understand that support for Java 6 on WebSphere Application Server is ending April 2018, see: http://www-01.ibm.com/support/docview.wss?uid=swg21999583

Now I can switch to Java 7. But what about Java 8? Does BPM 8.5.6 support Java 8?

Answer: IBM BPM V8.5.6.0 Java 6 or Java 7*


IBM Is using a monitored JBoss Application Server with ITCAM for J2EE supported in a Windows service? - United States J2EE JBoss server Windows service LA2 fix TECHNOTE (FAQ)

THIS DOCUMENT APPLIES ONLY TO THE FOLLOWING LANGUAGE VERSION(S):
 US English

QUESTION
 Is using a monitored JBoss Application Server with ITCAM for J2EE supported in a Windows service?

ANSWER
When you configure the JBoss Application Service to run as a Windows service, you will download the JBoss native connectors [http://jbossweb.jboss.org/downloads/jboss-native-2-0-10] and modify the service.bat file.

The JBoss service is not available to run as a Windows service when configured with the ITCAM for J2EE agent/DC because this involves changes to the JBoss native connector files and this is currently not supported. Additionally, there's no option to specify the Service name when configuring the JBoss server during the configuration steps.

If you are using JBoss AS 7.1 or JBoss EAP 6.1.0 or 6.2.0 or 6.3.0, then you will need the to use the latest patch first, [https://developer.ibm.com/answers/questions/208313/how-do-i-download-the-new-itcam-for-j2ee-711-la-if.html]then run the standalone.bat (or domain.bat) program from the command-line after successful configuration.

Note: If you have a Tomcat server, then you will be able to use that server in a Service, the technote is here. [http://www.ibm.com/support/docview.wss?uid=swg21961542]

PRODUCT ALIAS/SYNONYM
 ITCAM for J2EE

Question: Is using a monitored JBoss server with ITCAM supported in a Windows Service? Is using a monitored JBoss server with ITCAM supported in a Windows Service?

Answer: The JBoss service is not available to run as a Windows service when configured with the ITCAM for J2EE agent/DC because this involves changes to the JBoss native connector files and this is currently not supported.


Question:
Is Java 8 supported for BPM?

I understand that support for Java 6 on WebSphere Application Server is ending April 2018, see: http://www-01.ibm.com/support/docview.wss?uid=swg21999583

Now I can switch to Java 7. But what about Java 8? Does BPM support Java 8?

Answer: IBM BPM V8.5.6 and V8.5.7 support Java 6 and Java 7, but do not support Java 8.


IBM The FileNet Content Engine Health Page may report the Fixed Content Device and Storage Areas as unavailable - United States ce health page; storage areas unavailable TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 The Content Engine Health Page (http://<CEserver>:<port>/P8CE/Health ) provides the status for different areas of the FileNet P8 system. When viewing the page, both the Fixed Content Devices and the Storage Areas may display red icons instead of checkmark green icons.

SYMPTOM
Red icons are displayed next to the Fixed Content Devices and Storage Areas even though users can add and access content.

DIAGNOSING THE PROBLEM
The p8_server_error log may contain the following E_ACCESS_DENIED error:

yyyy-mm-ddThh:mm:ss nnnnnn ENG FNRCE0241E - ERROR method name: postLoadSecurity principal name: <username> Global Transaction: false User Transaction: false Exception Info: The requester has insufficient access rights to perform the requested operation.
com.filenet.api.exception.EngineRuntimeException: E_ACCESS_DENIED: The requester has insufficient access rights to perform the requested operation.
at com.filenet.engine.retrieve.IndependentClassRetriever.postLoadSecurity(IndependentClassRetriever.java:1390)
at com.filenet.engine.retrieve.RetrieverClassBase.loadNonScalarProperties(RetrieverClassBase.java:633)
at com.filenet.engine.retrieve.IndependentClassRetriever.loadNonScalarProperties(IndependentClassRetriever.java:1298)
at com.filenet.engine.retrieve.IndependentClassRetriever.loadObject(IndependentClassRetriever.java:1119)
...

RESOLVING THE PROBLEM

 1. Verify the Content Engine Bootstrap User has Full Control on the Object Store and all associated Storage Areas.

 2. Inspect Storage Area security by right-clicking on the Object Store

 3. Choose Properties

 4. Select the All Properties radio button and view the Storage Area property name

 5. Click on the drop down list to select the Storage Area.

 6. The Storage Area properties screen will appear.

 7. Verify the Security tab allows the Content Engine Bootstrap User has Full Control.

Question: Content Engine System Health Page page doesn't reflect correctly, Fixed Content Advise and Storage Area showing unavailable. Content Engine System Health Page page doesn't reflect correctly, Fixed Content Advise and Storage Area showing unavailable.

Answer:
Verify the Content Engine Bootstrap User has Full Control on the Object Store and all associated Storage Areas.

 2. Inspect Storage Area security by right-clicking on the Object Store

 3. Choose Properties

 4. Select the All Properties radio button and view the Storage Area property name

 5. Click on the drop down list to select the Storage Area.

 6. The Storage Area properties screen will appear.

 7. Verify the Security tab allows the Content Engine Bootstrap User has Full Control.


IBM FileNet Content Manager object store addon creation fails on IBM DB2 pureScale - United States  TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 Excessive lock duration during FileNet CM object store addon creation may result in SQL lock timeouts that will cause addon installation to fail.

SYMPTOM
DB transactions are rolled back due to SQL timeout.

CAUSE
When multiple DB2 pureScale members are active during FileNet CM addon creation, excessive SQL locking may occur, resulting in a potential lock timeout. This can result in transactions being rolled back, thereby resulting in the addon installation failing.

DIAGNOSING THE PROBLEM
Examine both the P8 error log and the DB2 diagnostic logs for each active member for lock timeout error messages similar to the following:

DB2 (db2diag.log):
FUNCTION: DB2 UDB, lock manager, sqlplWaitOnWP, probe:999

 MESSAGE : ZRC=0x80100044=-2146435004=SQLP_LTIMEOUT
"LockTimeOut - tran rollback Reason code 68

P8 (p8_server_error.log):
com.filenet.api.exception.EngineRuntimeException: FNRCE0019E: E_DEADLOCK_ERROR: The operation could not be completed due to a deadlock error. A retry might be appropriate.
Caused by: com.ibm.db2.jcc.am.SqlTransactionRollbackException: DB2 SQL Error: SQLCODE=-911, SQLSTATE=40001, SQLERRMC=68, DRIVER=4.15.82

Note: The SQLERRMC=68 suggests that the root cause is a SQL lock timeout even though the P8 error message and SQLCODE suggest a deadlock occurred.

RESOLVING THE PROBLEM
The lock timeouts can be avoided by only having a single DB2 pureScale member active during FileNet CM addon installation. Once addon installation has completed successfully, the other members can be brought back online.

Question: Does the BPM internal Document Store work with IBM DB2 pureScale? I use IBM DB2 pureScale with my BPM installation. During startup of the server and initialization of the internal document store I see hanging threads in the systemOut.log and the process will not finish. How can this be solved?

Answer: The lock timeouts can be avoided by only having a single DB2 pureScale member active during FileNet CM addon installation. Once addon installation has completed successfully, the other members can be brought back online.