IBM Support

PI51601: AGENT RELAY CANNOT BE UPDATED WHEN KEYSTORE PROPERTIES ARE SET

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If the agentrelay.codestation.cert_alias property is defined in
    the agent relay's conf/agentrelay.properties file, attempts to
    upgrade the relay will fail with the error:
    
    ReferenceError: "AGENTRELAY_CERT_ALIAS" is not defined
    
    Similar failures will occur with the
    agentrelay.codestation.keystore_password property and the
    agentrelay.codestation.cert_password property.
    

Local fix

  • Change the name of the agentrelay.codestation.cert_alias
    property to agentrealy.cert.alias, leaving the value the same.
    Do the same with the agentrelay.codestation.cert_password and
    agentrelay.codestation.keystore_password, changing them to
    agentrelay.cert.password and agentrelay.keystore.password. For
    example, the line:
    agentrelay.codestation.cert_password=pbe{xxxxxxx\=}
    should be changed to:
    agentrelay.cert.password=pbe{xxxxxx\=}
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All                                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * If the agentrelay.codestation.cert_alias property is defined *
    * in                                                           *
    * the agent relay's conf/agentrelay.properties file, attempts  *
    * to                                                           *
    * upgrade the relay will fail with the error:                  *
    *                                                              *
    * ReferenceError: "AGENTRELAY_CERT_ALIAS" is not defined       *
    *                                                              *
    * Similar failures will occur with the                         *
    * agentrelay.codestation.keystore_password property and the    *
    * agentrelay.codestation.cert_password property.               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Upgrade to UCD version 6.2.0.2                               *
    ****************************************************************
    

Problem conclusion

  • Fixed in UCD version 6.2.0.2
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI51601

  • Reported component name

    UC RELEASE

  • Reported component ID

    5725M5500

  • Reported release

    611

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-10-30

  • Closed date

    2015-12-18

  • Last modified date

    2015-12-18

  • 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

    UC RELEASE

  • Fixed component ID

    5725M5500

Applicable component levels

  • R600 PSN

       UP

  • R600 PSY

       UP

  • R601 PSN

       UP

  • R601 PSY

       UP

  • R610 PSN

       UP

  • R610 PSY

       UP

  • R611 PSN

       UP

  • R611 PSY

       UP

  • R612 PSN

       UP

  • R612 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS4GCC","label":"IBM UrbanCode Release"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1.1","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
14 October 2021