IV55010: IMPROVEMENTS TO THE RELIABILITY OF TEXT SEARCH INDEXING

8.0.0.3-WS-WSRR-ZOS-IFIV65487_IV79085_IV87422_IV87429_IV89477
8.0.0.3-WS-WSRR-MultiOS-IFIV65487_IV79085_IV87422_IV87429_IV89477
WebSphere Service Registry and Repository V8.0.0 Fix Pack 3
WebSphere Service Registry and Repository V8.5.6 Fix Pack 1

APAR status

• Closed as program error.

Error description

• Improvements to the reliability of text search indexing
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of WebSphere Service Registry and Repository v7.5 and
  v8.0
  
  ****************************************************************
  PROBLEM SUMMARY:
  A number of problems have been encountered when running the
  REINDEX_ALL and REINDEX_MISSING commands against the WSRR text
  search index. Some of these problems are caused by race
  conditions that occur when running in a cluster. As such it is
  possible that sometimes a reindex command might not persist the
  changes to search index or the changes might be immediately
  overwritten by an untimely occurrence of the TextSearch
  scheduled task.
  

Problem conclusion

• To make the reindex commands more reliable, all the work of
  running the text search utility actions, such as reindex, has
  been deferred to the TextSearch task. The means of invoking the
  text search utility actions, usually via the
  textSearchUtils.jacl script provided with WSRR is unchanged. The
  behaviour is now slightly different. The textSearchUtils.jacl
  script will now return promptly after connecting to the WSRR
  system. It's purpose is now to request that a text search action
  is run rather than to actually invoke that action. Once an
  action has been requested and the jacl script has returned, the
  next time the TextSearch task runs it will pick up the action
  request(s) and run the action. In a clustered environment this
  means that the actual utility action might run on a different
  cluster member to that which the wsadmin process which runs the
  jacl script connected.
  
  To provide information about the status of the utility actions
  some new messages have been introduced.
  
  On the system where the wsadmin process used to invoke
  textSearchUtils.jacl was connected you will see messages such as
  these in the SystemOut.log:
  
  GSR9504I: The text search utility action "REINDEX_ALL" has been
  requested.
  GSR9507I: The requested text search utility action "REINDEX_ALL"
  will be run by the TextSearch scheduled task next time it runs.
  Please ensure the TextSearch scheduled task is enabled.
  
  On the process where the scheduled tasks are running you see a
  flow of messages such as this in the SystemOut.log when the
  action is being executed.
  
  GSR9502I: The text search utility action "REINDEX_ALL" has
  started.
  GSR9510I: WSRR Text Search service: objects processed = 0
  GSR9510I: WSRR Text Search service: objects processed = 5000
  GSR9510I: WSRR Text Search service: objects processed = 10000
  GSR9511I: WSRR Text Search service: Total objects processed =
  10050
  GSR9503I: The text search utility action "REINDEX_ALL" has
  completed.
  GSR9508I: The text search index is being saved.
  GSR9509I: The text search index has been saved.
  
  This fix is targeted for inclusion in WSRR v7.5.0.5 and v8.0.0.3
  

Temporary fix

Comments

APAR Information

• 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

  SERVICE REGISTR

• Fixed component ID

  5724N7200

Applicable component levels

• R750 PSY

     UP