Testing your Database Setup

Celoxis uses JDBC to connect to the database. There could be various reasons for the connection to fail. To help you debug the problem, we have written a simple program that will help you to understand the problem.

Downloading the program

Download the jdbctest.zip file from http://download.celoxis.com/jdbctest/jdbctest.zip and unzip it. This will create a directory containing the following:

drivers : this contains database drivers from Oracle, Microsoft and Postgresql
jdbctest.java : this is a simple program that tries to connect to your database using JDBC and prints a success or a failure message
jdbctest.class : the compiled version of jdbctest.java

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

Running the test program

Open a terminal window on Unix/Linux or Command prompt in Windows
Go to the directory jdbctest
On Microsoft Windows run the program (substituting values according to your configuration) as:
NOTE: Type the words in bold AS IS. Words in italics needs to be substituted.
```
java -cp .;drivers/* jdbctest product=oracle name=celoxis user=scott password=tiger host=localhost
```

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

java -cp '.:drivers/*' jdbctest product=oracle name=celoxis user=scott password=tiger host=localhost

Note

product	one of the following: oracle (for Oracle), postgresql_90 (for Postgresql 9.0), mssql_2008 (for SQL Server 2008), mssql_2012 (for SQL Server 2012) or mssql_2014 (for SQL Server 2014)
name	Name of your database
user/password	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.

Debugging your database setup

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

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