IBM Support

PI84888: KC_HOME PROPERTY MISSING AFTER MIGRATING STANDALONE WEBSPHERE APPLICATION FULL PROFILE ON Z/OS FROM V8 TO V9

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After upgrading a standalone WebSphere Application Server from
    v8 to v9 on z/OS, the following error appears in the Servant
    Region at startup:
    
    Trace: 2017/04/20 13:23:30.246 02 t=8CC620 c=UNK key=P8 tag=
    (13007004)
      SourceId:
    com.ibm.ws.session.WASSessionCore.SessionContextRegistry.
      getSessionContext
      ExtendedMessage: BBOO0222I: SESN0176I: Will create a new
    session
      context for application key default_host/ibm/kc
    04/20/17 13:23:30:485 JST [tartup : 1] INFO  [ibm.kc.Instance]-
    Starting KC instance...
    04/20/17 13:23:30:490 JST [tartup : 1] WARN  [ibm.kc.Instance]-
    Variable KC_HOME is not defined.
    java.lang.RuntimeException: Variable KC_HOME is not defined.
    

Local fix

  • Manually create the missing WebSphere Variable.  The value
    should be the directory path of the "help" directory within the
    installed Admin Console war directory, for example:
    
    Name: KC_HOME
    Value: /<WAS_HOME>/systemApps/isclite.ear/isclite.war/help
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users who use IBM WebSphere Application *
    *                  Server V9.0 on z/OS and are trying to       *
    *                  access                                      *
    *                  the Knowledge Center pages through the      *
    *                  Administrative Console.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: The KC_HOME property wasn't defined for *
    *                      the 'Servant' process in the            *
    *                      server.xml,                             *
    *                      which causes the KC pages not to load.  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When the KC_HOME property isn't properly defined in the the
    server.xml the Knowledge Center pages will not load in the
    Administrative Console. The fix will ensure that the KC_HOME
    property is defined correctly in the server.xml.
    

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    PI84888

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-07-21

  • Closed date

    2018-02-05

  • Last modified date

    2018-02-05

  • 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 FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

  • R900 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"900","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
19 October 2021