2214890 - Deployment of a delivery unit in SAP HANA fails with error message "At least HALM Version 1.x.0 is required to run this command"

Symptom

Deployment of a delivery unit / content in SAP HANA using hdbalm client tool fails with the below error message stating that a particular HALM (HANA Application Lifecycle Management) version 1.x.0 is required:

At least HALM Version 1.4.0 is required to run this command

At least HALM Version 1.3.0 is required to run this command

...

Environment

SAP HANA Application Lifecycle Management
SAP HANA Database as of SPS 08

Reproducing the Issue

You attempt to import a delivery unit / HANA content using the hdbalm client tool, e.g.:

E:\usr\sap\TST\hdbclient\hdbalm.bat -u SYSTEM -h hdbnode01 -p 8000 install 51049632_HBA_SAP_ECC_100.ZIP

See also Installing and Updating Add-On Products and Software Components.

Cause

The hdbalm tool checks the version of the HANA_XS_LM delivery unit (containing the SAP HANA Application Lifecycle Management) installed, the problem might be caused now by one of the two issues:
1) Different SPS version used for HANA Client and Database: The hdbalm tool is not downward compatible. This means that if you use a SPS 10 HANA Client, the hdbalm also expects the HANA_XS_LM version shipped with SPS 10 (which is 1.4.x) on HANA Database side. If the HANA database runs on SPS09 and HANA SPS10 Client is used, the version of HANA_XS_LM is older (1.3.x) than expected by hdbalm.
2) Outdated HANA_XS_LM delivery unit:  HANA Client and Database are on the same SPS, but the version of delivery unit HANA_XS_LM installed in the SAP HANA Database is outdated (i.e. runs on an older version than expected).

Resolution

1) Different SPS version used for HANA Client and Database: In general the HANA Client is downwards compatible, the hdbalm binary is the only exception to this rule. In order to resolve the problem, the HANA Client used for import and the HANA database installed should be on the same SPS (e.g. both should be on SPS 9) by re-installing older HANA Client.
2) Outdated HANA_XS_LM delivery unit: Usually the HANA_XS_LM delivery unit is updated automatically during HANA database upgrade. In order to identify the root cause why the DU version did not get updated, please provide the below information:

1. Which HANA database revision are you currently running on, does the database run in Single or Multiple container mode (MultiDb)?
2. Has the database on HANA SPS09 been restored recently with an older SPS08 backup?
3. Have there been any errors/warnings during upgrade to HANA SPS09, can you please provide the corresponding hdblcm.log & hdbupd.log in /var/tmp? Search for phase "Importing delivery units".
4. What is the output of the SQL Statement executed in the database (choose the correct user/database), it will show the current version of HANA_XS_LM:

select * from "_SYS_REPO"."DELIVERY_UNITS" where delivery_unit = 'HANA_XS_LM';

In case there were problems during database upgrade causing the version update of the "auto_content" (where the DU HANA_XS_LM is part of) to be skipped or the content got overwritten by database restore, please repeat this phase by:

1. Connecting to the OS level of the HANA appliance with <SID>adm user
2. Executing the command below to re-do the repository upgrade:

/usr/sap/<SID>/SYS/global/hdb/install/bin/hdbupdrep --content_directory=/usr/sap/<SID>/SYS/global/hdb/auto_content

Its log will then show a similar output to:

Importing delivery units...
Importing delivery unit HANA_DT_BASE
Importing delivery unit HANA_IDE_CORE
Importing delivery unit HANA_TA_CONFIG
...
Importing delivery unit HANA_XS_LM...

Importing delivery unit HANA_ADMIN

Update Repository done
Log file written to '/var/tmp/hdbupdrep.log'

Alternatively you may also re-import the HANA_XS_LM using HANA Studio:

File > Import > Import Source: "Delivery Unit" > Choose the right target system > Select from "server" file: "/usr/sap/<SID>/SYS/global/hdb/auto_content/HANA_XS_LM.tgz" > Finish.

If no errors have been reported and the DU version was successfully imported/upgraded, the import of the delivery unit using hdbalm should succeed.

Keywords

HDBALM, HALM

Header Data

Released On	09.09.2015 13:23:13
Release Status	Released to Customer
Component	HAN-LM-APP SAP HANA Application Lifecycle Management
Priority	Normal
Category	Problem
Database	HDB 1.0