Testing your Database Setup

Celoxis JDBC Probe is a java program that helps to understand connection issues with your database server.

Download

Click here to download the jdbc-probe.zip file.

IMPORTANT
This test needs to be run on the server where Celoxis is installed; NOT on the database server.

Usage

Unzip the jdbc-probe.zip file. It should create a folder with the file JDBCProbe.class in it.
Open a command prompt and cd to the folder that contains the JDBCProbe.class file.

On Microsoft Windows run the program (substituting values according to your configuration) as:

java -cp .;drivers/* JDBCProbe product=oracle name=celoxis user=tim password=fox host=localhost

On Linux or Mac OS run the program (substituting values according to your confiuration) as:

java -cp '.:drivers/*' JDBCProbe product=oracle name=celoxis user=tim password=fox host=localhost

You will receive a success message if the connection was successful. If the connection fails, the message returned by the driver is printed. This error message will give you a clue about the possible causes as explained later in this document.

Options:

product	one of the following: oracle (for Oracle), pgsql (for Postgresql 9.0), mssql (for SQL Server 2008, 2012, 2014)
name	The name of your database
user/password	The username and Password to be used to connect to the database. NOTE: In case of SQL server, the login and database must be configured to use the SQL Authentication mode (or Mixed mode), not Windows authentication mode only.
host	The machine name of the server where the database is running
port	The port of the database server. This is an optional field and when unspecified the default port will be used.

You will receive a success message if the connection was successful. If the connection fails, the message returned by the driver is printed. If you don't understand the output simply send us the output.

Understanding the Error Messages

Common errors for Oracle

ERROR MESSAGE	POSSIBLE CAUSES
The Network Adapter could not establish the connection	The host name cannot be resolved by the DNS server. Database server is not running on the host. The database port on the database server is inaccessible because of a firewall
Invalid username/password; logon denied	Username or password is incorrect
Connection refused(DESCRIPTION=(TMP=) (VSNNUM=153092352)(ERR=12505) (ERROR_STACK=(ERROR=(CODE=12505)(EMFI=4))))	The database name is incorrect The user doesn't have privileges to logon to the database
FAILURE: Listener refused the connection with the following error: ORA-12505, TNS:listener does not currently know of SID given in connect descriptor. [java.sql.SQLException]	One of the parameter you are passing is incorrect or the database does not exist on the connection properties you are specifying.

Common errors for MSSQL

ERROR MESSAGE	POSSIBLE CAUSES
Error establishing socket.	The host name cannot be resolved by the DNS server. Database server is not running on the host. The database port on the database server is inaccessible because of a firewall
Login failed for user	Username or password is incorrect.
Cannot open database requested in login	The database name is incorrect. The user doesn't have privileges to logon to the database
Not Associated with a trusted SQL Server Connection	This occurs typically when Microsoft Sql Server installation is configured to use only Windows authentication and not SQL Server authentication. To solve the problem: Change the Authentication change the authentication mode to sql server authentication.
The TCP/IP port is disabled or not accepting connections	Go to Microsoft SQL Server 2008, 2012, 2014> Configuration Tools > SQL Server Configuration Manager In the SQL Server Configuration Manager select the node SQL Server Network Configuration > Protocols for MSSQLSERVER Right-click on the TCP/IP node and select Enable Restart the SQL Server (SQLEXPRESS) service (In Control Panel > Adminstrative Tools > Services, right-click on the SQL Server (SQLEXPRESS) service and select Restart) Also, check that the firewall is not blocking the connection.

Common errors for Postgresql

ERROR MESSAGE	POSSIBLE CAUSES
The connection attempt failed	The host name cannot be resolved by the DNS server. Database server is not running on the host. The database port on the database server is inaccessible because of a firewall
Connection rejected: FATAL: password authentication failed for user	Username or password is incorrect
Backend start-up failed: FATAL: database "celoxis" does not exist	The database name (abc) is incorrect. The user doesn't have privileges to logon to the database