Setting Up JDBC Connections in a Catalog

Logi Report supports most of the relational databases which support JDBC drivers. Via specific JDBC drivers, you can create connections which connect catalogs to different relational databases. This topic describes how you can set up JDBC drivers for the Logi Report products and create connections in a catalog via the JDBC drivers.

This topic contains the following sections:

Setting Up the JDBC Driver
Creating a Connection via the JDBC Driver

Setting Up the JDBC Driver

Before you can retrieve data from a relational database in Logi Report, you should first set up the JDBC driver.

Install the JDBC driver according to the instructions provided by the JDBC driver supplier and understand the URL format required by the driver.
Append the class path of the JDBC driver's jar files with full path into Logi Report's environment configuration file by editing setenv.bat for Windows or setenv.sh for UNIX/Linux in <designer_install_root>\bin.
For example, if you are using the Oracle JDBC driver ojdbc7.jar, append it as follows:
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;c:\oracle\lib\ojdbc7.jar;
The step for appending the class path is very important. The same changes made to Designer’s class path must be made to the class path for Server too. A missing JDBC driver in the Logi Report startup batch file or command line results in a "ClassNotFoundError" message when you try to run a report. If you want to use the Preview as Page/Web Report Result feature in Designer, you also need to append the class path for the JDBC driver to setenv.bat/setenv.sh in <designer_install_root>\server\bin.
Add the driver into Designer's driver template file jdbcdrivers.properties in <designer_install_root>\bin in the following format:
jdbc.drivers=JDBCDriverName:JDBCDriverName:...
Where, JDBCDriverName is the JDBC driver name that Logi Report can automatically load when it starts up, and ":" is the delimiter between two driver names.
The following example specifies an Oracle thin driver and an Interbase thin driver:
jdbc.drivers=oracle.jdbc.driver.OracleDriver:interbase.interclient.Driver
Once you have added the drivers in jdbcdrivers.properties, later when you set up JDBC connections in Designer, you do not need to provide the driver name manually. Designer can search from the beginning of the class path and find one that contains the specified class.

Creating a Connection via the JDBC Driver

To set up a JDBC connection in a catalog to retrieve data via JDBC driver, take the following steps:

In Designer, create a catalog or open a catalog.
In the Catalog Manager, right-click the node of a data source and select New JDBC Connection from the shortcut menu. Select JDBC in the Select Connection Type dialog box.
If you want to set up the connection in a new data source in the catalog, select any of the existing catalog data sources, select New Data Source on the Catalog Manager toolbar, then in the New Data source dialog box, specify the name of the data source, select the JDBC connection type and select OK.
In the Get JDBC Connection Information dialog box, provide the necessary information to connect with the database.
You have four ways to set up a JDBC connection:
- Setting up by adding an existing connection
  1. From the Connection List drop-down list, select the connection. This list contains previously added connection information. The format of the connection information is JDBC URL/(JDBC Driver Name), for example:
    jdbc:odbc:jinfonet/(sun.jdbc.odbc.JdbcOdbcDriver)
  2. The JDBC URL and JDBC driver name then appear in the corresponding text boxes.
- Setting up a new JDBC connection
  1. In the Driver text box, specify the driver. If you have added the driver into jdbcdrivers.properties when setting up the JDBC driver, you can leave this empty. Designer can find the correct driver from the file.
  2. In the URL text box, specify the URL of the JDBC driver. The URL format is regulated by the driver itself.
  3. Specify the user name and password used to connect to the database.
- Setting up an ODBC connection
  1. Clear Driver and select Use ODBC Data Source.
  2. In the DSN Name text box, type the ODBC data source name.
  3. Specify the user name and password to enable accessing the database through the ODBC data source.
  - The ODBC-JDBC bridge is not included in Java JDKs after version 7, therefore, for JDK 8 or later, you get an error that "No suitable driver found for jdbc:odbc". To resolve this issue, you need to add the path information of the ODBC-JDBC bridge to the class path during installation or by editing the file setenv.bat (setenv.sh on UNIX/Linux) in <designer_install_root>\bin.
  - The JDK that Designer uses must match the ODBC data source that the operating system uses. For example, 32-bit ODBC data source can be connected by 32-bit JDK only.
- Setting up a connection via the WebLogic 6.1 connection pool
  1. Select Use Connection Pool. Designer then automatically displays the string weblogic.jinfonet.pool.Driver in the Driver text box.
  2. In the URL text box, specify the URL of the JDBC driver.
  3. Specify the user name and password respectively.
If your database has some special requirements, you can select More Options to modify the options according to your requirements.
Select Test Connection to test whether the information you provide is available.
Select OK to set up the connection. Designer then displays a message box, showing the status of connecting to the database.
Upon finishing setting up the connection, Designer displays the Add Tables/Views/Synonyms dialog box, prompting you to add tables from the database to the catalog. If you want to add tables later, select Done.

You can also use the connection plug-ins Designer provides to connect to the Oracle, MySQL, SQL Server, InterSystems IRIS, and PostgreSQL databases in an easy way.

Note icon If you want to use the DB2 app connection, you need to install the client and configure the net address first.

The following presents examples of connecting to specific relational databases:

Example 1: Connecting to Amazon RDS

Assume that:

You have already installed the JDBC driver (com.mysql.jdbc.Driver), and have appended the archive files of the driver to the ADDCLASSPATH variable in the file setenv.bat in <designer_install_root>\bin.
The RDS database server has the following information:
Host name: jrdbtest.c4fb8hiicidz.us-west-2.rds.amazonaws.com
Port number: 3306
Database name: sampledb1110
Database user & password: dbadmin, test1234

Take the following steps to set up a connection which connects a catalog in Designer to a database via Amazon RDS:

Open a catalog in Designer.
In the Catalog Manager, right-click the node of an existing data source and select New JDBC Connection from the shortcut menu. Select JDBC in the Select Connection Type dialog box.
In the Get JDBC Connection Information dialog box, type the JDBC driver class name com.mysql.jdbc.Driver in the Driver text box.
In the URL text box, specify the URL in the format jdbc:mysql://<hostname>:<port>/<database>. In this example, type jdbc:mysql://jrdbtest.c4fb8hiicidz.us-west-2.rds.amazonaws.com:3306/sampledb1110. The URL is dynamically generated when you apply an instance.
Type the user name dbadmin and password test1234 respectively.
Select OK to set up the connection.

Note icon

You should not use RDS for small data queries since it takes a long time in the cloud.
The RDS MySQL database is case sensitive for table names and column names, which may result in that the Logi Report sample reports cannot run.

Example 2: Connecting to RedShift

Assume that:

You have already installed the PostgreSQL JDBC driver (org.postgresql.Driver), and have appended the archive files of the driver to the ADDCLASSPATH variable in the file setenv.bat in <designer_install_root>\bin.
The RedShift database server has the following information:
Host name: jinfonet-rsdw-demo.cfcn5ogc14yr.us-east-1.redshift.amazonaws.com
Port number: 5439
Database name: sampledb
Database user & password: dbadmin, test1234

Take the following steps to set up a connection which connects a catalog in Designer to a database via RedShift:

Open a catalog in Designer.
In the Catalog Manager, right-click the node of an existing data source and select New JDBC Connection from the shortcut menu. Select JDBC in the Select Connection Type dialog box.
In the Get JDBC Connection Information dialog box, type the JDBC driver class name org.postgresql.Driver in the Driver text box.
In the URL text box, specify the URL in the format jdbc:postgresql://<hostname>:<port>/<database>. In this example, type jdbc:postgresql://jinfonet-rsdw-demo.cfcn5ogc14yr.us-east-1.redshift.amazonaws.com:5439/sampledb. The URL is dynamically generated when you apply an instance.
Type the user name dbadmin and password test1234 respectively.
Select OK to set up the connection.

Note icon

Redshift does not support the Double data type and it uses Decimal or Double Precision instead.
Redshift does not support the Bytea, Bit(N), or Bit varying (N) data type, and so far there is no alternative data type for that, therefore Logi Report binary data fields like photos stored in the demo database cannot be imported to Redshift.
For more information about the features, functions, and data types that are not supported in Redshift, see http://docs.aws.amazon.com/redshift/latest/dg/c_redshift-and-postgres-sql.html.

Example 3: Connecting via WebLogic 6.1 Connection Pool

Set up the WebLogic Connection Pool.
1. Assume that you have started the WebLogic Server, access the console through a web browser (http://host:7001/console). Then, go to the left panel, and expand the JDBC node.
2. Select the Connection Pools node. Designer displays all the defined connection pools in the right panel.
3. Select the Configure a New JDBC Connection Pool link.
4. In the Configuration tab, define the connection pool as follows. Then, select Create.
  Name: jinfonet
  URL: jdbc:odbc:jinfonet
  Driver Classname: sun.jdbc.odbc.JdbcOdbcDriver
Check the Connection Pool.
In the Monitoring tab, select the link Monitor all Active Pools to check if the pool is active. You can see the connection pool that you just created appear in the Monitoring tab.
Select the Targets tab, and add examplesServer to the Chosen column (in order to assign the connection pool to the server). Then, select Apply to save your changes.
Set up the data source.
1. Select the Data Sources node in the JDBC node. In the right panel, select the Configure a New JDBC Data Source link.
2. In the Configuration tab, specify the values in the following text boxes.
  Name: jinfonetDS
  JNDI Name: jinfonetDS
  Pool Name: jinfonet
3. Select Create. Designer adds the new data source in the Data Sources node in the left panel.
Select the Targets tab and add examplesServer in the Available column to the Chosen column. Select Apply to save the changes.
Add weblogic.jar to setenv.bat.
To connect via the WebLogic Connection Pool in Designer, you first need to add weblogic.jar in <weblogic_install_root>\wlserver6.1\lib to the ADDCLASSPATH variable of setenv.bat. In this example, supposing that you have installed Designer in C:\LogiReport\Designer, and WebLogic in C:\bea, modify setenv.bat in C:\LogiReport\Designer\bin to add C:\bea\wlserver6.1\lib\weblogic.jar to the ADDCLASSPATH variable as follows:
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\bea\wlserver6.1\lib\weblogic.jar;
Set up the connection in Designer.
1. Open a catalog.
2. In the Catalog Manager, right-click the node of an existing data source and select New JDBC Connection from the shortcut menu. Select JDBC in the Select Connection Type dialog box.
3. In the Get JDBC Connection Information dialog box, select Use Connection Pool. Designer automatically displays the string weblogic.jinfonet.pool.Driver in the Driver text box.
4. Type in the URL jdbc:weblogic:jinfonet:@<hostname>:7001:jinfonetDS, where <hostname> is the host name or IP address of the WebLogic Server, 7001 is the port to which the WebLogic Server listens, and jinfonetDS is the JNDI Name of the data source. Select OK.

Note icon Designer does not support the data types longbarbinary and BigDecimal when you use a WebLogic Connection Pool.

Previous Topic Next Topic