IBM Support

IT36339: BACKUPS FAIL WITH CTGGA2649 IF HOSTNAMES CONTAIN THE UNDERSCORE CHARACTER.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Backups will fail with the following message if the IBM
    Spectrum Protect Serverhostname contains the underscore '_'
    character:
    CTGGA2649,Backup of VM SSKO8PTWN02 failed due to an
    unexpected error.
    
    The issue is the result of the underscore
    '_' character not being a validcharacter for DNS entries which
    causes problems with the kubernetes serviceintroduced in
    10.1.6.
    
     Initial impact: Medium
    
    Versions affected: 10.1.6 -
    10.1.7
    

Local fix

  • Do the following to change the hostname of the IBM Spectrum
    Protect Plus Server appliance:
    1. Login to the SPP Server CLI
    via SSH.
    2. Run this command, fully replacing <new-hostname>
    with a new name that does not include underscore characters.:
    
    sudo hostnamectl set-hostname <new-hostname>
    3. Reboot the IBM
    Spectrum Protect Plus Server appliance.
    4. Make sure that the
    rest of the IBM Spectrum Protect Plus environment can resolve
    the new hostname correctly.
    5. Update the /etc/hosts files of
    any IBM Spectrum Protect Plus Servers, vSnaps, or VADP Proxies
    that reference the old hostname with the new hostname and
    reboot them.
    
    Once the hostname has been updated and the
    hostname resolves correctly in the environment, create a new
    SLA for the failing backups.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * IBM Spectrum Protect Plus levels 10.1.6 and 10.1.7.          *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See Error Description.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply the fixing level when available. This problem is       *
    * projected to be fixed in IBM Spectrum Protect Plus level     *
    * 10.1.8. Note that this is subject to change at the           *
    * discretion of IBM.                                           *
    ****************************************************************
    

Problem conclusion

  • The format of the path to the selected site for the SLA will
    automatically be fixed even if the hostname contains invalid
    characters.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT36339

  • Reported component name

    SP PLUS

  • Reported component ID

    5737SPLUS

  • Reported release

    A16

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-03-24

  • Closed date

    2021-04-13

  • Last modified date

    2021-04-13

  • 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

    SP PLUS

  • Fixed component ID

    5737SPLUS

Applicable component levels

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNQFQ","label":"IBM Spectrum Protect Plus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A16","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
31 January 2024