PH57620: THE ACTIVATION OF ROCE CARDS DOES NOT WORK IF UPPER-CASE CHARACTERS ARE USED IN THE HEX-VALUES OF THE CORRESPONDING FIDS

APAR status

• Closed as documentation error.

Error description

• After adapting the JSON configuration file for use of RoCE-cards
  in a multi-node cluster of the accelerator, the Network
  Connections-panel of the Admin UI shows the new devices, however
  with a red light (instead of a green one). This means: the
  system assumes that the RoCE cards are not 'online'.
  The reason for such a failure could be the use of upper-case
  characters in the hexdecimal values of the FIDs specified for
  the RoCE-cards. See the "FID"-values "000A" and "000B" in the
  following example:
        {
          "name": "roce",
          "ipv4": "192.168.100.1/24",
          "bond_settings": {
            "mode": "balance-rr",
            "slaves": {
              {
                "FID": "000A"
              },
              {
                "FID": "000B"
              },
              {
                "FID": "0016"
              },
              {
                "FID": "0017"
              }
            }
          }
        },
  As a workaround the customer needs to use lower-case characters
  in the RoCE-FIDs as shown in the following example:
            {
              "name": "roce",
              "ipv4": "192.168.100.1/24",
              "bond_settings": {
                "mode": "balance-rr",
                "slaves": {
                  {
                    "FID": "000a"
                  },
                  {
                    "FID": "000b"
                  },
                  {
                    "FID": "0016"
                  },
                  {
                    "FID": "0017"
                  }
                }
              }
            },
  
  A fix for this issue will be provided with Accelerator
  maintenance level 7.5.12.
  
  Additional keywords:
  TS013973038 RoCE FID #idaa7512 upper-case lower-case json-file
  multi-node Admin-UI DT244596
  GH/.../Customer-Cases/issues/591
  

Local fix

• As a workaround the customer needs to use lower-case characters
  in the RoCE-FIDs as shown in the following example:
            {
              "name": "roce",
              "ipv4": "192.168.100.1/24",
              "bond_settings": {
                "mode": "balance-rr",
                "slaves": {
                  {
                    "FID": "000a"
                  },
                  {
                    "FID": "000b"
                  },
                  {
                    "FID": "0016"
                  },
                  {
                    "FID": "0016"
                  },
                  {
                    "FID": "0017"
                  }
                }
              }
            },
  

Problem summary

• Problem Summary:
  See Error Description.
  
  Users Affected:
  Users of Db2 Analytics Accelerator of IBM Z in a multi-node
  deployment.
  
  Problem Sceanrio:
  See Error Description.
  
  Problem Symptoms:
  See Error Description.
  

Problem conclusion

• The issue has been fixed with Accelerator maintenance level
  7.5.12. Upgrade your accelerator environments accordingly.
  

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

Applicable component levels