IT38250: A CORRECTION TO THE STEPS REQUIRED TO CONFIGURE THE DATA PROTECTION FOR SAP HANA MANUALLY

APAR status

• Closed as documentation error.

Error description

• In the user's guide below:
  https://www.ibm.com/docs/fr/spferp/8.1.11?topic=hana-manually-c
  onfiguring-data-protection-sap
  
  6. Finally, adjust the SAP HANA configuration to use Data
  Protection for SAP HANA. Run the following commands:
  A. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'log_backup_parameter_file') =
  '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/init<SID>.utl'"
  B. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'log_backup_using_backint') = 'true'"
  C. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'catalog_backup_parameter_file')=
  '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/init<SID>.utl'"
  D. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'catalog_backup_using_backint') = 'true'"
  E. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'data_backup_parameter_file') =
  '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/init<SID>.utl'"
  
  
  For these ALTER SYSTEM ALTER CONFIGURATION Statements, the
  parameter "WITH RECONFIGURE" is necessary to be attached at the
  end to make the configuration changes taking effect, i.e.,
  
  
  
  6. Finally, adjust the SAP HANA configuration to use Data
  Protection for SAP HANA. Run the following commands:
  A. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'log_backup_parameter_file') =
  '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/init<SID>.utl'"
  WITH RECONFIGURE
  B. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'log_backup_using_backint') = 'true'" WITH RECONFIGURE
  C. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'catalog_backup_parameter_file')=
  '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/init<SID>.utl'"
  WITH RECONFIGURE
  D. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'catalog_backup_using_backint') = 'true'" WITH RECONFIGURE
  E. hdbsql -U <hdb_keystore_entry> -j "ALTER SYSTEM ALTER
  CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup',
  'data_backup_parameter_file') =
  '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/init<SID>.utl'"
  WITH RECONFIGURE
  
  WITH RECONFIGURE Specifies that the configuration changes are
  directly applied to the running SAP HANA database instance. When
  WITH RECONFIGURE is not specified the configuration, the changes
  are written to the required ini file, however, the modified
  values are not applied to the current running system. The
  changes are only applied during a restart of the SAP HANA
  database or a subsequent configuration change with WITH
  RECONFIGURE. In this case, there can be inconsistencies between
  the ini file contents and the actual configuration value that
  the SAP HANA database is currently using.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Enterprise Resource Planning Data   *
  * Protection for SAP HANA User's guide affects all 8.1  levels *
  * of the users guide.                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See "ERROR DESCRIPTION"                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the IBM Spectrum      *
  * Protect for Enterprise Resource Planning Data Protection for *
  * SAP HANA User's guide 8.1.11 on                              *
  * https://www.ibm.com/docs/fr/spferp/8.1.11?topic=hana-manuall *
  * y-configuring-data-protection-sap. This  is subject to       *
  * change at the discretion of IBM.                             *
  ****************************************************************
  

Problem conclusion

• The commands in the User's guide step 6  "adjust the SAP HANA
  configuration to use Data Protection for SAP HANA" are updated
  by adding the word "WITH RECONFIGURE"
  
  Updated document link-
  https://www.ibm.com/docs/en/spferp/8.1.11?topic=hana-manually-co
  nfiguring-data-protection-sap
  

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