Sybase SQL Server
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 http://www.sybase.com/products/middleware/jconnectforjdbc. 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 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: Configure the Database Filter
1. In the filters folder, locate the default local.properties file under uPortal-4.0.x/filters/local.properties and configure the Database Connection Settings
# HSQL Configuration environment.build.hsql.port=8887 # Database Connection Settings (Uncomment the Maven Filters section in rdbm.properties) environment.build.hibernate.connection.driver_class=com.sybase.jdbc2.SybDriver environment.build.hibernate.connection.url=jdbc:sybase:Tds://my.school.edu/uPortal environment.build.hibernate.connection.username=user environment.build.hibernate.connection.password=password environment.build.hibernate.dialect=org.hibernate.dialect.SybaseDialect
Step 3: Add the database driver
NEW: Open uportal-db/pom.xml file, uncomment the Sybase driver below and modify as needed
- Add the appropriate version properties to the root pom.xml file or enter the appropriate version below
...
<dependencies>
<!-- Add any db drivers that are applicable to *any* of your environments -->
<dependency>
<groupId>org.hsqldb</groupId>
<artifactId>hsqldb</artifactId>
<version>${hsqldb.version}</version>
<scope>compile</scope>
</dependency>
<!--
| The following db drivers should be uncommented and/or modified as needed for server
| deployments. (Add all thaat are needed.) Don't forget to add appropriate .version
| properties to the root pom.xml, or simply enter the appropriate version below.
+-->
<!--
<dependency>
<groupId>postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>${postgres.version}</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>com.ibm.db2</groupId>
<artifactId>db2-jdbc</artifactId>
<version>${db2.version}</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>sqljdbc4</artifactId>
<version>${mssql.version}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<dependency>
<groupId>com.oracle</groupId>
<artifactId>ojdbc6_g</artifactId>
<version>${oracle.version}</version>
</dependency>
-->
<dependency>
<groupId>org.sybase</groupId>
<artifactId>sybase-jconnect</artifactId>
<version>${sybase.version}</version>
</dependency>
</dependencies>
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.
ant clean initportal
Step 6: Restart Tomcat