IC74986: DATA SERVER CANNOT BE RESTARTED IF ANY TPC DATA OR FABRIC AGENT REGISTERS WITH A NULL GUID VALUE.

4.2.1 Interim Fix 1 (November 2011) for Tivoli Storage Productivity Center

APAR status

• Closed as program error.

Error description

• DETAIL OF PROBLEM:
  The TPC Data server process will not start correctly and will
  not open port 9549 if any legacy TPC data and/or fabric agents
  register with the TPC server using a null GUID value.  The first
  symptom of this problem is not being able to log into the TPC
  GUI after restarting the OS or manually re-starting the TPC Data
  server process.  A pop-up window displaying "Status 12" and
  GUI00023M will appear.  Connectivity testing will reveal that
  port 9549 is not listening, though the TPC Data server process
  does appear to start and stay running.
  To diagnose this problem, examine the server_0000x.log files
  located in <tpc_install_dir>\data\log.  The following messages
  will appear in that log file:
  Exception in thread "main" java.lang.NullPointerException
          at
  com.tivoli.itsrm.server.AgentManager.init(AgentManager.java:258)
          at com.tivoli.itsrm.server.Server.main(Server.java:727)
  RECREATE STEPS:
  N/A
  ________________________________________________________________
  DB2 Version used for Server:    N/A
  The defect is against component:   5608TC300 TPC Data server
  Server/Manager build/release (TPC):   4.2.1 GA
  Agent build/release (TPC):    Any supported legacy CAS-based TPC
  Data or Fabric agent
  Server/Manager (OS):     All supported server Operating Systems
  Agent (OS):       N/A
  ________________________________________________________________
  Problem as described by customer:   Unable to log into TPC
  Initial customer impact (low/med/high): high
  

Local fix

• Contact IBM customer technical support; manual steps required.
  To expedite resolution, export the contents of the T_RES_HOST
  table from the DB2 TPCDB Database, to a text file.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: TPC 3.3.2, 4.1.0 and 4.1.1 users who         *
  *                 have uninstalled the tivguid                 *
  *                 application from the computers where         *
  *                 TPC Agents are installed.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: TPC Data Server cannot be restarted.    *
  *                      TPC/data/log/server_0000x.log           *
  *                      contains following error message:       *
  *                      Exception in thread "main"              *
  *                      java.lang.NullPointerException at       *
  *                      com.tivoli.itsrm.server.AgentManager    *
  *                      .init(AgentManager.java:258)            *
  *                      at com.tivoli.itsrm.server.Server       *
  *                      .main(Server.java:727)                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  -
  

Problem conclusion

• TPC Data Server will reject agents registration requests
  having a null GUID.
  
  Those agents that have already registered with a null GUID
  will not be displayed in Data Agent/SRA list panel and in job
  definitions until they re-register with a valid GUID.
  
  
  APAR is targeted for the following maintenance
  packages:
  
  | fix pack | 4.2.1-TIV-TPC-FP0003 - target June  2011
  | fix pack | 4.1.1-TIV-TPC-FP0006 - target April 2011
  
  http://www-01.ibm.com/support/docview.wss?&uid=swg21320822
  
  The target dates for future fix packs do not represent a formal
  commitment by IBM. The dates are subject to change without
  notice.
  

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

  TPC FOR DATA

• Fixed component ID

  5608TC300

Applicable component levels

• R33A PSY

     UP

• R33H PSY

     UP

• R33L PSY

     UP

• R33S PSY

     UP

• R33W PSY

     UP

• R41A PSY

     UP

• R41H PSY

     UP

• R41L PSY

     UP

• R41S PSY

     UP

• R41W PSY

     UP

• R42A PSY

     UP

• R42H PSY

     UP

• R42L PSY

     UP

• R42S PSY

     UP

• R42W PSY

     UP