3688832 - Testing HANA JDBC connection for troubleshooting

For some reason a JDBC connection to your HANA database fails.

For example after entering password for SYSTEM user in SUM (Software Update Manager) SUM validates the password and fails with:

>>> HDB_VALIDATE_PASSWORD.LOG

SAPup> Starting subprocess with PID 5393 in phase 'SUMASK' at 20251108163951
    ENV: DIR_LIBRARY=/usr/sap/AAA/SUM/abap/../jvm/jre/bin
    ENV: LD_LIBRARY_PATH=/usr/sap/AAA/SUM/abap/../jvm/jre/bin:/usr/sap/AAA/SYS/exe/run:/usr/sap/AAA/SYS/exe/uc/linuxx86_64:/usr/sap/AAA/hdbclient
    ENV: PATH=/usr/sap/AAA/SUM/abap/../jvm/jre/bin:/bin:/usr/bin:/sbin:/usr/sbin:/usr/local/bin:/usr/lib/mit/bin:/usr/sap/AAA/SYS/exe/uc/linuxx86_64:/usr/sap/AAA/SYS/exe/run:/usr/sap/AAA/home:/usr/sap/AAA/hdbclient
    ENV: RSEC_SSFS_DATAPATH=/usr/sap/AAA/SYS/global/security/rsecssfs/data
    ENV: RSEC_SSFS_KEYPATH=/usr/sap/AAA/SYS/global/security/rsecssfs/key
    ENV: SAPSYSTEMNAME=AAA
    ENV: dbms_type=HDB
 *DBENV: dbs_hdb_schema=SAPHANADB
    ENV: rsdb_ssfs_connect=0
 *DBENV: (auth_shadow_upgrade)
    PWD: /usr/sap/AAA/SUM/abap/tmp

EXECUTING /usr/sap/AAA/SUM/abap/../jvm/jre/bin/java -cp /usr/sap/AAA/SUM/abap/bin/com.sap.hdb.sl.lib.jar:/usr/sap/AAA/SUM/abap/bin/com.sap.hdb.core.jar com.sap.hdb.core.main.cmd.HdbCmdMain 
HDB_CMD_CLAZZ_NAME=IS_CONNECT_POSSIBLE 
DATABASE_SID=BBB 
DATABASE_HOSTNAME=hana.srv.com 
INSTANCE_NUMBER=00 
READ_FROM_STDIN=TRUE 
JDBC_PATH=/usr/sap/AAA/SUM/abap/bin 
DATABASE_MODE=MULTIPLE 
SYSTEMDB_PORT=30013
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.core.main.cmd.HdbCmdMain | Start new command section
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.core.main.cmd.HdbCmdMain | Version of com.sap.hdb.core.jar | Changelist: 216580 | Release: lmts_026_REL | API-Version: 00
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.core.main.cmd.HdbCmdMain | Version of com.sap.hdb.sl.lib.jar | Changelist: 217074 | Release: lmts_026_REL | API-Version: 35
class com.sap.hdb.sl.lib.utils.cmd.clazz.CmdClazzParameterFactory, parameters received. Start execution. Check HdbCmdOut.log and HdbStdout.txt for further information.
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.core.main.cmd.HdbCmdMain | Name of HdbCmdClazz: class com.sap.hdb.sl.lib.utils.cmd.clazz.IsConnectPossible
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.sl.lib.connection.sql.JdbcDriver | URI: file:/usr/sap/AAA/SUM/abap/bin/ngdbc.jar
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.sl.lib.connection.sql.JdbcConnection | Instance is a multiple-container system.
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.sl.lib.connection.sql.JdbcConnection | Start new connection with connect URL: jdbc:sap://hana.srv.com:30013/?databaseName=BBB connect user: SYSTEM
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.sl.lib.utils.cmd.clazz.IsConnectPossible | HDBSLLIB Exception: [INVALID_USER_PASSWORD] com.sap.db.jdbc.exceptions.SQLInvalidAuthorizationSpecExceptionSapDB: [10]: authentication failed
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.core.main.cmd.HdbCmdMain | End of HdbCmdClazz section: class com.sap.hdb.sl.lib.utils.cmd.clazz.IsConnectPossible
Sat Nov 08 16:39:51 GMT-03:00 2025 | com.sap.hdb.core.main.cmd.HdbCmdMain | *************************************************************

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental. 

SAP HANA, platform edition

jdbc, connection, ngdbc.jar, java , KBA , HAN-DB-CLI , SAP HANA Clients (JDBC, ODBC) , How To