IBM Support

PH24845: WEB AGENT-RELAY IS NOT STARTING WHEN AGENTRELAY.KEYSTORE IS MODIFIED.

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • For web Agent Relays, if the relay's keystore properties are
    changed, it can cause the the relay to fail on startup with the
    following exception:
    java.io.IOException: Keystore was tampered with, or password was
    incorrect
    
    This can be reproduced with the following steps:
    
    1. Install the relay and Communication Type as "WEB".
    
    2. Create the keystore by using below command on path
    $Relay_Install/conf/jms-relay
    
    $JAVA_HOME\jre\bin\keytool -genkey -alias mykey -keyalg RSA
    -keysize 2048 -sigalg SHA256withRSA -validity 365 -keypass
    privatepassword -keystore agentrelay.keystore -storepass
    password
    
    3. Change the below parameters in agentrelay.properties
    
    agentrelay.keystore.password=password
    
    agentrelay.cert.alias=mykey
    
    agentrelay.cert.password=privatepassword
    
    4. Restart relay. Below error occurrs
    
    2020-04-28 17:13:36,981 IST INFO AgentWorkerThread
    com.urbancode.air.agentrelay.AgentRelay - Connecting to servers:
    java.lang.RuntimeException: java.io.IOException: Keystore was
    tampered with, or password was incorrect
    

Local fix

  • Add the below parameter in agentrelay.properties
    agentcomm.keystore.password=password
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All end users on all supported browsers.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * For web Agent Relays, if the relay's keystore properties are *
    * changed, it can cause the the relay to fail on startup with  *
    * the                                                          *
    * following exception:                                         *
    * java.io.IOException: Keystore was tampered with, or password *
    * was                                                          *
    * incorrect                                                    *
    *                                                              *
    * This can be reproduced with the following steps:             *
    *                                                              *
    * 1. Install the relay and Communication Type as "WEB".        *
    *                                                              *
    * 2. Create the keystore by using below command on path        *
    * $Relay_Install/conf/jms-relay                                *
    *                                                              *
    * $JAVA_HOME\jre\bin\keytool -genkey -alias mykey -keyalg RSA  *
    * -keysize 2048 -sigalg SHA256withRSA -validity 365 -keypass   *
    * privatepassword -keystore agentrelay.keystore -storepass     *
    * password                                                     *
    *                                                              *
    * 3. Change the below parameters in agentrelay.properties      *
    *                                                              *
    * agentrelay.keystore.password=password                        *
    *                                                              *
    * agentrelay.cert.alias=mykey                                  *
    *                                                              *
    * agentrelay.cert.password=privatepassword                     *
    *                                                              *
    * 4. Restart relay. Below error occurrs                        *
    *                                                              *
    * 2020-04-28 17:13:36,981 IST INFO AgentWorkerThread           *
    * com.urbancode.air.agentrelay.AgentRelay - Connecting to      *
    * servers:                                                     *
    * java.lang.RuntimeException: java.io.IOException: Keystore    *
    * was                                                          *
    * tampered with, or password was incorrect                     *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Fixed in version 7.1.0.1                                     *
    ****************************************************************
    

Problem conclusion

  • Fix is provided in IBM UrbanCode Deploy 7.1.0.1
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH24845

  • Reported component name

    UC DEPLOY

  • Reported component ID

    5725M5400

  • Reported release

    705

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-04-28

  • Closed date

    2020-07-23

  • Last modified date

    2020-07-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

    UC DEPLOY

  • Fixed component ID

    5725M5400

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS4GSP","label":"IBM UrbanCode Deploy"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"705"}]

Document Information

Modified date:
24 July 2020