IBM Support

PH26316: URBANCODE DEPLOY WEB AGENT INTERMITTENTLY FAILS TO CONNECT TO SERVER OR RELAY

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

  • UrbanCode Deploy (UCD) Web Agent intermittently fails to
    connect to Server. The following exception shows in the
    agent log:
    com.urbancode.air.agent.comm.AgentPublicKeyPinHandler - SSL
    handshake failed: ch=XXX local=/XXX remote=XXX
    java.nio.channels.ClosedChannelException
    
    This is known to affect multi-node UCD Server setups with
    one or more nodes inactive, and especially network topologies
    containing a load balancer or other middle-box between the relay
    and servers.
    

Local fix

  • There are three known ways to workaround this issue:
    1. Remove Agent configuration properties which points the Agent
    to Servers and Relays which are known to be offline
    2. Ensure middle-man or loadbalancer is not accepting
    connections to offline servers
    3. Restart the agent until it shows online. (This works because
    the agent will shuffle its connection path list on startup,
    allowing valid connection paths to be reshuffled to the top.)
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All end users on all supported browsers.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * UrbanCode Deploy (UCD) Web Agent intermittently fails to     *
    * connect to Server. The following exception shows in the      *
    * agent log:                                                   *
    * com.urbancode.air.agent.comm.AgentPublicKeyPinHandler - SSL  *
    * handshake failed: ch=XXX local=/XXX remote=XXX               *
    * java.nio.channels.ClosedChannelException                     *
    *                                                              *
    * This is known to affect multi-node UCD Server setups with    *
    * one or more nodes inactive, and especially network           *
    * topologies                                                   *
    * containing a load balancer or other middle-box between the   *
    * relay                                                        *
    * and servers.                                                 *
    ****************************************************************
    * 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

    PH26316

  • 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-06-10

  • Closed date

    2020-08-12

  • Last modified date

    2020-08-12

  • 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","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
13 August 2020