IT31812: IBM SPECTRUM CONTROL INSTALLATION MAY FAIL WHEN THE HOSTNAME CONTAINS AN UNDERSCORE.

IBM Spectrum Control 5.3.7 (May 2020)

APAR status

• Closed as program error.

Error description

• The installation of IBM Spectrum Control fails if there is an
  underscore ( _ ) in the hostname, i.e. MySC_server
  The installation failes during the Storage Resource Agent
  installation with error seen in the lax file:
  2020-02-10 15:00:00.130+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall command = [cmd.exe, /C,
  C:\SPECTRUM_CONTROL_SVR_5.3.5.1_WIN\SC\data\sra\windows\bin\inst
  allSRA.bat, C:\Program Files\IBM\TPC, MySC_server.ibm.com, 9549,
  9567]
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall exit value = 0
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall
  C:\Users\db2admin.MySC_server\AppData\Local\Temp\I1578914567\Win
  dows>echo off
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall AGT0466I Cannot connect to IBM Spectrum
  Control Server.
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall 5 possible reasons:
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall 1. Server IP(s) MySC,server.ibm.com cannot be
  resolved
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall 2. IBM Spectrum Control Data Server port
  number 9549 incorrect
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall 3. IBM Spectrum Control Data Server not
  running
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall 4. Certificates on the IBM Spectrum Control
  Data Server and agent do not match
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall 5. Firewall blocks communication
  2020-02-10 15:00:00.131+0200 INFO InstallOrUpgradeSRAAgentTask
  executeSRAInstall AGT0384E Install failed, return code 118
  
  The underscore character is not a valid character for the
  hostname.
  The Spectrum Control code will be enhanced to improve the host
  name validation.
  
  In case only a partial roll back is done during the Spectrum
  Control  installation (meaning all is installed except the SRA),
  other symptoms have been noted:
  - adding storage systems fails with message "Can't connect to
  the xxxxxxxxx storage systems"
  - creating report fails with message "Cannot connect to Device
  Server"
  

Local fix

• install Spectrum Control on a machine where the hostname doesn't
  contain an underscore.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Control users installing the product on a       *
  * server with an underscore in the hostname                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The installation of IBM Spectrum Control may fail if there   *
  * is                                                           *
  * an underscore ( _ ) in the hostname. ie.  "MySC_server"      *
  *                                                              *
  * The installation fails during the Storage Resource Agent     *
  * installation. The underscore character is not a valid        *
  * character for the hostname.                                  *
  *                                                              *
  * The Spectrum Control code will be enhanced to improve the    *
  * hostname validation.                                         *
  *                                                              *
  * In the case this occurs, only a partial rollback is done     *
  * during                                                       *
  * the Spectrum Control  installation (meaning all is installed *
  *                                                              *
  * except the SRA), other symptoms have been noted:             *
  *                                                              *
  *  - adding storage systems fails with message "Can't connect  *
  * to the xxxxxxxxx storage systems"                            *
  *                                                              *
  *  - creating report fails with message "Cannot connect to     *
  * Device Server"                                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fix maintenance when available                         *
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is targeted for the following release:
  
  IBM Spectrum Control 5.3.7   [ 5.3.7-IBM-SC ]
  
  ( release target 2Q 2020 / May )
  
  http://www.ibm.com/support/docview.wss?&uid=swg21320822
  
  The target dates for future releases do not represent a formal
  commitment by IBM. The dates are subject to change without
  notice.
  

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

• Fixed component name

  TPC

• Fixed component ID

  5608TPC00

Applicable component levels