This documentation relates to uPortal 4.0
If you are using a different version, please click on "Click for all versions" on the left side of the page and select the relevant version.

Sybase SQL Server

Skip to end of metadata
Go to start of metadata
All Versions
Page not found
Table of Contents
Page not found

Step 1: Obtain the Driver

Since the Sybase JDBC driver is not available in the central Maven repository, it must be placed into the local repository of each machine on which you wish to build uPortal. As an alternative, you could set up a maven repository for use by multiple machines.

The first step is to download the JDBC driver for your database. The Sybase jConnect for JDBC product is available from Sybase at It is available as a download separate from the Sybase database product.

To install the JAR into your local maven repository, use the following command:

mvn install:install-file -DgroupId=com.sybase -DartifactId=sybase-jconnect -Dversion=<version> -Dpackaging=jar -DgeneratePom=true -Dfile=jconn2.jar

The latest version looks to be jconn4.jar in version 7.07

The groupId, artifactId and version specified in this command are up to you, but they should match the JAR vendor, name and version to avoid confusion down the road.

Step 2: Add the Dependency

From the uPortal source directory, open the uPortal-4.x.x/pom.xml file, there is a section about 110 lines down that reads:

<!-- The JDBC Driver used by uPortal -->

Modify this to use the MSSQL driver, using the group, artifact and version information from the mvn install:install-file command above.

<!-- The JDBC Driver used by uPortal -->

Step 3: Configure the Database Filter     

     1. In the filters folder, locate the default file under uPortal-4.0.x/filters/ and configure the Database Connection Settings

# HSQL Configuration

# Database Connection Settings (Uncomment the Maven Filters section in  (latest version should be com.sybase.jdbc4.jdbc.SybDriver)

Step 4: Test the Configuration

Running the dbtest ant target will tell you if you have configured the database connection properly.

ant dbtest

Step 5: Build and Deploy 

Following a successful test, you can execute the command below to build the database tables and copy files to your servlet container. 

Note: Executing the command "ant clean initportal" will drop and recreate the database tables and all existing data will be lost. This will result in a clean uPortal database structure. If you want to keep the contents of your existing database, use "ant clean deploy-war"

ant clean initportal

Step 6: Restart Tomcat


Having problems with these instructions?

Please send us feedback at

  • No labels