Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Section
Column

This page describes how to upgrade your Database Connector to the latest released version of the Database Connector that is compatible with this version of . This upgrade requires you to move your datasource configuration out of configuration.xml and into the <frevvo-home>\tomcat\conf\frevvo-configdbconnector.properties file.

Info

frevvo only supports/certifies the Database Connector running in the Apache Tomcat container. Refer to our Supported Platforms for the list of Application Servers and databases supported/certified by frevvo.

 

Expand
titleClick to review the release notes compatibility matrix before continuing.

Insert excerpt
Database Connector Release Notes
Database Connector Release Notes
nopaneltrue

Column
width400px

 On This Page:

Table of Contents

...

  1. Stop
  2. Create a folder named <frevvo-home>\config i.e. c:\frevvo\config. Copy your configuration.xml to this location
  3. Locate & Delete your previous database resource definition(s)
    1. Edit configuration.xml
    2. Delete all lines between and including <resource-def></resource-def> for all querysets

      To help locate this, here is a example of a Datasource definition in configuration.xml

      Code Block
      <resource-def>
          <url>YOUR database Url HERE</url>   
          <driver>YOUR driver HERE</driver>
          <user>YOUR database user HERE</user>
          <password>YOUR password HERE</password>
      </resource-def>
    3. Delete all lines between and including <resource-ref></resource-ref>. You would have <resource-ref> definitions in your configuration.xml if you chose to define the database connection in the application container (Tomcat if you are using the frevvo-tomcat bundle) instead of inside the database connector.

      To help locate this, here is an example of a Datasource definition using <resource-ref>.

      Code Block
      <resource-ref>
          <description>MySQL Customers</description>
          <res-ref-name>jdbc/mystore_ds</res-ref-name>
          <res-type>javax.sql.DataSource</res-type>
          <res-auth>Container</res-auth>
      </resource-ref>
    4. Remove the queryset attributes for date/dateTime/timestamp formats from all querysets. It is no longer necessary to add them. Refer to Defining SQL Queries - Dates andTime stamps for more information
      Here is an example:

      Code Block
      <queryset name="myStore" timeStampFormat="yyyy-MM-dd HH:mm:ss" dateFormat="yyyy-MM-dd" xmlDateFormat="yyyy-MM-dd">
      
      Should be
      <queryset name="myStore">
  4. Setup your v2.5.3+ database resource definition(s)
    1. Create <frevvo-home>\tomcat\conf\frevvo-configdbconnector.properties (if it does not already exist in your v7.3.2 frevvo server)
    2. For each deleted <resource-def> lines, Add these lines

      Code Block
      dbconnector.queryset@<your queryset name>.resource-def.url=<the url to your database>
      dbconnector.queryset@<your queryset name>.resource-def.user=<your database username>
      dbconnector.queryset@<your queryset name>.resource-def.password=<your database password>
    3. For each deleted <resource-ref> lines, Add this line

      Code Block
      dbconnector.queryset@mystore.resource-ref.name=jdbc/<name of your resource>
      Expand
      titleClick here for more information

      If you prefer to define your datasources on the container level, the recommended approach is to define the datasource in the container and then use a resource-ref in the Database Connector properties file to reference it..  

      Info

      Using <Resource-ref> to define datasources is not supported if you are running the Database Connector in Standalone mode. Use <Resource-def> instead.

      Follow these steps:

      1. Edit the <frevvo-home>\tomcat\conf\Catalina\localhost\context.xml.default file 

               a,  Add the Resource name parameter. An example is shown below:

      Code Block
      <Resource name="jdbc/<your database name>"
                auth="Container"         
                driverClassName="com.mysql.jdbc.Driver"
                username="<your database user>"
                password="<your database password>"
                type="javax.sql.DataSource"
                url="jdbc:mysql://localhost/<your queryset name>?autoconnect=true"/>

      2. Edit frevvo\tomcat\conf\frevvo-configdbconnector.properties file. Verify that the frevvo.connectors.database.configuration property has been set and add the dbconnector.resource-ref.name property as shown below:

      Code Block
      dbconnector.queryset@<queryset name>.resource-ref.name=jdbc/<name of your resource>

      .

  5. Copy the sample frevvo.connectors.database.configuration property and add it to the frevvo-configdbconnector.properties file.

  6. Edit the frevvo.connectors.database.configuration line to be the path to your configuration.xml file.

    Code Block
    titleSample frevvo.connector.datqbase.configuration property
    frevvo.connectors.database.configuration=file:///C:/frevvo/config/configuration.xml
    
    dbconnector.queryset@<your queryset name>.resource-def.url=<the url to your database>
    dbconnector.queryset@<your queryset name>.resource-def.user=<your database username>
    dbconnector.queryset@<your queryset name>.resource-def.password=<your database password
  7. Start Live Forms
  8. Browse http:<your server>:<port>/database/status Verify that the query validation page is loaded with status Passed


  9.  Log into your tenant  and test your forms and flows that interact with your database.

...