IT36611: FILE RESTORE WEB GUI DOES NOT HONOR CHANGE IN DEFAULT PORT SETTINGS

APAR status

• Closed as program error.

Error description

• When attempting to change the default port settings for File
  Restore web GUI in the IBM Spectrum Protect for Backup Archive
  client, the web GUI will fail to start correctly if ports other
  than the default are used. For example, to start a web user
  interface session for file-restore operations with port number
  19081 other than the default port number 9081 will fail.
  
  1.
  Edit boostrap.properties file and set the ports(for Linux it is
  /opt/tivoli/tsm/tdpvmware/common/webserver/usr/servers/veProfile
  /bootstrap.properties):
  
  veProfile.http.port=19080 <====Change
  the default http port 9080 to 19080
  ve.Profile.https.port=19081
  <====Change the default https port 9081 to 19081
  (leave
  veProfile.keystore.pswd unchanged)
  
  2. Restart webserver(For
  Linux, it is to run ?/etc/init.d/webserver restart?).
  3. Failed
  to explore the web GUI with https://<ba_client>:19081/bagui/
  and the error of ?404 Not Found" is seen.
  

Local fix

• As a quick fix one can edit server.xml(for Linux it is under /op
  t/tivoli/tsm/tdpvmware/common/webserver/usr/servers/veProfile/)
  file and replace
  
   <!-- HTTPs session secure -->
   <httpSession
  cookieSecure="true"/>
   <virtualHost id="default_host">
  
  <hostAlias>*:9081</hostAlias>
   </virtualHost>
  
  block at the end
  of the file with
  
   <!-- HTTPs session secure -->
   <httpSession
  cookieSecure="true"/>
   <virtualHost id="default_host">
  
  <hostAlias>*:${veProfile.https.port}</hostAlias>
  
  </virtualHost>
  
  After the above edit, restart the webserver.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Data Protection for VMware GUI version 8.1.12 running on all *
  * Windows and Linux platforms.                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available.                           *
  * This issue is projected to be fixed in the Data Protection   *
  * for VMware GUI version 8.1.13 on all Microsoft Windows x64   *
  * and Linux x64 platforms.                                     *
  *                                                              *
  * Note 1: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• SSL Port can not be changed using the procedure described in the
  documentation.
  The problem appears due to hard-coded default value in the
  WebSphere server configuration file.
  The value was replaced with the corresponding variable, so the
  client is able to change that.
  

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:

Modules/Macros

• webui
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels