This is the silent killer. If you recently upgraded your application or your database version, your old JDBC drivers might be obsolete.
xqe-jdb-0001 is an identifier commonly returned by JDBC-based middleware or custom database access wrappers to indicate a failure to establish a connection to the database. It’s not a standard JDBC code but a local/error-bundle label; the underlying cause is one of:
Before attempting fixes, diagnose the underlying cause. The error is generic, but the roots fall into six categories:
psql -U your_user -d your_db -h localhost mysql -u your_user -p -h 127.0.0.1 This is the silent killer
If the server is down: Start the service and verify that it binds to the expected IP/port.
A very specific scenario causes this error frequently during development:
The Scenario: You develop a report on your laptop. You use a connection string pointing to localhost or 127.0.0.1. Everything works fine.
The Problem: You deploy that report to the production server. The connection string still says localhost. The production server tries to connect to "localhost," looking for a database on the production server itself, which doesn't exist. If the server is down: Start the service
The Fix: Ensure your connection strings use the actual IP address or Fully Qualified Domain Name (FQDN) of the database server, never localhost.
Action: Log into the database server machine (or use a monitoring tool) and confirm:
# Linux - check if DB process is running
systemctl status postgresql (or mysql / oracle / mssql)
Navigate to cognos_install/location/bin/jdbc/.
Ensure the correct driver JAR is present. For example: After adding/updating a driver, restart the Cognos service
After adding/updating a driver, restart the Cognos service.
| Symptom | Likely Fix |
|---------|-------------|
| Connection refused | DB not running, wrong port, or firewall block |
| Authentication failed | Wrong user/password or user lacks remote privilege |
| No suitable driver | Missing JDBC driver JAR |
| Timeout | Network latency, DB overload, or incorrect host |
| SSL required | Append ?useSSL=true&requireSSL=true or disable SSL if allowed |