Information for creating JDBC connections

Use default values when you create JDBC connections if specific values are not provided. For more information, see the application server documentation.

Note: If you are not using the default port setting for your database, make sure that you change it to the correct value.

WebLogic

Use the following values if your application server is WebLogic:

SQLServer

  • Database Driver: Microsoft™ MS SQL Server Driver (Type 4) Versions: 2012, 2012 SP1 and SP3, 2014, 2014 SP1, 2016 SP1

  • Default port: 1433

  • Driver class: com.microsoft.sqlserver.jdbc.SQLServerDriver

  • Driver URL: jdbc:sqlserver://<your_db_host>[\\<named_instance>]:<your_db_port>;databaseName=<your_db_name>

  • Properties: Add user=<your_db_user_name>

Oracle

  • Driver: Other

  • Default port: 1521

  • Driver class: oracle.jdbc.OracleDriver

  • Driver URL: jdbc:oracle:thin:@<your_db_host>:<your_db_port>:<your_db_service_name>

    Enter the driver URL by using the format that is shown. HCL Unica applications do not allow the use of Oracle's RAC (Real Application Cluster) format for JDBC connections.

  • Properties: Add user=<your_db_user_name>

DB2®

  • Driver: Other

  • Default port: 50000

  • Driver class: com.ibm.db2.jcc.DB2Driver

  • Driver URL: jdbc:db2://<your_db_host>:<your_db_port>/<your_db_name>

  • Properties: Add user=<your_db_user_name>

MariaDB
  • Database type: MYSQL
  • Driver: mariadb-java-client-2.5.1.jar
  • Default port: 3306
  • Driver class: org.mariadb.jdbc.Driver
  • Driver URL: jdbc:mariadb://<your_db_host>:<PORT>/<Your_DB_user_name>
  • Properties: Add user=<your_db_user_name>
  • Password=<your_db_user_password>

WebSphere®

Use the following values if your application server is WebSphere:

SQLServer

  • Driver: N/A

  • Default port: 1433

  • Driver class: com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource

  • Driver URL: N/A

In the Database Type field, select User-defined.

After you create the JDBC Provider and data source, go to the Custom Properties for the data source, and add, modify properties as follows.

  • serverName=<your_SQL_server_name>
  • portNumber =<SQL_Server_Port_Number>
  • databaseName=<your_database_name>

Add the following custom property:

Name: webSphereDefaultIsolationLevel

Value: 1

Datatype: Integer

Oracle

  • Driver: Oracle JDBC Driver

  • Default port: 1521

  • Driver class: oracle.jdbc.OracleDriver

  • Driver URL: jdbc:oracle:thin:@<your_db_host>:<your_db_port>:<your_db_service_name>

    Enter the driver URL by using the format that is shown. HCL Unica applications do not allow the use of Oracle's RAC (Real Application Cluster) format for JDBC connections.

DB2

  • Driver: JCC Driver Provider

  • Default port: 50000

  • Driver class: com.ibm.db2.jcc.DB2Driver

  • Driver URL: jdbc:db2://<your_db_host>:<your_db_port>/<your_db_name>

Add the following custom property:

Name: webSphereDefaultIsolationLevel

Value: 2

Datatype: Integer

MariaDB

  • Database Driver: MariaDB JDBC Driver
  • Default Port: 3306
  • Driver Class: org.mariadb.jdbc.MySQLDataSource
  • Driver URL: org.mariadb://<your_db_host> [\\<named_instance>]:<your_db_port>;databaseName=<your_db_name>, valid-connection-checker class name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"

    For example: /subsystem=datasources/data-source=UnicaPlatformDS:add(jndi-name="java:/UnicaPlatformDS",connection-url="jdbc:mariadb:// localhost:3306/plat11",driver-name=MariaDBDriver,user-name=root,password=test123,valid-connection-checker-class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker")

JBoss

Specify the native library path of the database driver JAR file on your server. For example: db2jcc4.jar/ojdbc8.jar/sqljdbc4.jar/mariadb-java-client.jar/ifxjdbc.jar.

Use the following values if your application server is JBoss:

SQLServer

  • Database Driver: Microsoft MS SQL Server Driver (Type 4) Versions: 2012, 2012 SP1 and SP3, 2014, 2014 SP1, 2016 SP1
  • Default port: 1433
  • Driver class: com.microsoft.sqlserver.jdbc.SQLServerDriver
  • Driver URL: jdbc:sqlserver://<your_db_host>[\\<named_instance>]:<your_db_port>;databaseName=<your_db_name>,valid-connection-checker-class-name =org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker

For example :/subsystem=datasources/data-source=UnicaPlatformDS:add(jndi-name="java:/UnicaPlatformDS",connection-url="jdbc:sqlserver://localhost:1433;databaseName=plat11",driver-name=sql,user-name=sa,password=test1234,valid-connection-checker-class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker")

Oracle

  • Driver: Oracle JDBC Driver
  • Default port: 1521
  • Driver class: oracle.jdbc.OracleDriver
  • Driver URL: jdbc:oracle:thin:@<your_db_host>:<your_db_port>:<your_db_service_name>

For example

DB2

  • Driver: JCC Driver Provider
  • Default port: 50000
  • Driver class: com.ibm.db2.jcc.DB2Driver
  • Driver URL: jdbc:db2://<your_db_host>:<your_db_port>/<your_db_name>

MariaDB

  • Database Driver: MariaDB JDBC Driver
  • Default Port: 3306
  • Driver Class: org.mariadb.jdbc.MySQLDataSource
  • Driver URL: org.mariadb://<your_db_host> [\\<named_instance>]:<your_db_port>;databaseName=<your_db_name>, valid-connection-checker class name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"

    For example: /subsystem=datasources/data-source=UnicaPlatformDS:add(jndi-name="java:/UnicaPlatformDS",connection-url="jdbc:mariadb:// localhost:3306/plat11",driver-name=MariaDBDriver,user-name=root,password=test123,valid-connection-checker-class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker")

Tomcat

Specify the native library path of the database driver JAR file on your server. For example: db2jcc4.jar/ojdbc8.jar/sqljdbc4.jar. to create a datasource under Tomcat Interact Instance, add folder hierarchy as <Tomcat_Home>/conf/ Catalina/localhost, create a xml file with the name interact.xml under localhost folder. Add data source pointing to Runtime, Test, Production and learning database in interact.xml, refer platform or Campaign xml file which is created through installers under there respective Tomcat instance directory. You will need to create these Data source entry in Campaign Tomcat instance too.

Note: If you want to encrypt password, then run utility encryptTomcatDBPasswords.sh from <PLATFORM_HOME>/tools/bin. To know more about utility, see the Unica Platform Administrator Guide > Unica Platform utilities and SQL scripts > Platform Utilities > encryptTomcatDBPassword.

Use the following values if your application server is Tomcat:

SQLServer

  • Database Driver: Microsoft MS SQL Server Driver (Type 4) Versions: 2012, 2012 SP1 and SP3, 2014, 2014 SP1, 2016 SP1
  • Default port: 1433
  • Driver class: com.microsoft.sqlserver.jdbc.SQLServerDriver
  • Driver type: javax.sql.DataSource
  • Driver URL: jdbc:sqlserver://<your_db_host>[\\<named_instance>]:<your_db_port>;databaseName=<your_db_name>

Oracle

  • Driver: Oracle JDBC Driver
  • Default port: 1521
  • Driver class: oracle.jdbc.OracleDriver
  • Driver URL: jdbc:oracle:thin:@<your_db_host>:<your_db_port>:<your_db_service_name>

DB2

  • Driver: JCC Driver Provider
  • Default port: 50000
  • Driver class: com.ibm.db2.jcc.DB2Driver
  • Driver URL: jdbc:db2://<your_db_host>:<your_db_port>/<your_db_name>

MariaDB

  • Database Driver: MariaDB JDBC Driver
  • Default Port: 3306
  • Driver Class: org.mariadb.jdbc.MySQLDataSource
  • Driver URL: org.mariadb://<your_db_host> [\\<named_instance>]:<your_db_port>;databaseName=<your_db_name>, valid-connection-checker class name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"

    For example: /subsystem=datasources/data-source=UnicaPlatformDS:add(jndi-name="java:/UnicaPlatformDS",connection-url="jdbc:mariadb:// localhost:3306/plat11",driver-name=MariaDBDriver,user-name=root,password=test123,valid-connection-checker-class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker")