Versions Compared


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


  1. Download the Database Connector Standalone bundle.
  2. Unzip the file to a location of your choice. We will refer to this directory as <db-home>
  3. Install the JDBC Driver
  4. Choose one of these methods to start the connector:

    • Method 1: Using java in a command window
      1. Navigate to <db-home>\database-connector-2.5.x .Type java -jar database.war
    • Method 2: for Windows OS
      1. Double click the <db-home>\database-connector-2.5.x\Install-Service.bat file to install the connector as a Windows service. Click the Start-DBConnector-Service.bat to start it

        titleClick to see standalone bundle content details


        The Standalone Database Connector bundle includes the files shown in the image:

        Note the files in the database-connector-2.5.x directory that are used to manage the Database Connector as services on *nix and Windows operating systems: These files should be run as an administrator.

        • Install-Service.bat - installs the Database Connector on a Windows system as a service named frevvo Database Connector.

        • Uninstall-service.bat - uninstalls the frevvo Database Connector on a Windows operating system

        • Start-DB Connector-Service.bat - starts the frevvo Database Connector on a Windows operating system

        • - starts the frevvo Database Connector as a *nix console instance.

        • Restart-DBConnector-Service.bat - restarts the frevvo Database Connector on a Windows operating system

        • - restarts the frevvo Database Connector as a *nix console instance.

        • Stop-DBConnector-Service.bat - stops the frevvo Database Connector on a Windows operating system.

        • - stops the frevvo Database Connector *nix console instance.

    • Method 3: for *nix OS
      1. Execute the  DB shell script for Unix/Linux operating systems.
    • Method 4: for Linux
      1. The Database Connector can also run as a service under Linux systemd

    titleClick here for the details

    It is possible to manage the Database Connector using systemd ‘service’ scripts.

    1. Copy the sample service file located in /bin/dbconnector.service to /etc/systemd/system
    2. Review its contents and
    3. Make sure it is executable.

    You can now use systemd to manage the dbconnector service:

    • systemctl start dbconnector.service

    • systemctl stop dbconnector.service

    • systemctl restart dbconnector.service

    • systemctl status dbconnector.service

    To flag the service to start automatically on system boot use the following command:

    Code Block
    systemctl enable dbconnector.service

    Consult the service unit configuration page for more details.

  5. When the status returns Passed for each queryset, your installation is complete
  6. Cloud customers must also verify connector connectivity to the frevvo Cloud Server.



You MUST use a JDBC4 type driver, version 5.1.26 or later.

  1. Install the Driver
    1. If your database uses a preinstalled drive, you can skip this step. The preinstalled drivers are


    1. :
      1. MS SQL driver - This is embedded in the database.war file with standalone bundle, however it is not embedded in the frevvo-tomcat bundle.
      2. DERBY driver
    2. If your database driver is not


    1. preinstalled, you will have to locate a compatible driver from the internet. Try these locations.
      1. Oracle
      2. MySQL
  1. Locate the driver (i.e. mysql-connector-java-<version>-bin.jar or ojdbc6.jar) among the files that were installed. For example, on the location may be: Windows C:\Program Files (x86)\MySQL\MySQL Connector J\mysql-connector-java-8.0.19-bin.jar.
  2. Copy your driver to
    • Tomcat Bundle <frevvo-home>/tomcat/lib


    • , or 
    • Standalone Bundle <db-home>\database-connector-2.5.x\


    • lib 

  • You MUST copy the MS SQL (sqljdbc.jar) to the <frevvo-home>/tomcat/lib directory when running the connector in the frevvo-tomcat bundle AND using MS SQL as your external database
  • The jTDS driver requires an adidtional property, Refer to Datasource Definition Examples  for information
  • You can copy the driver into any location that is in the CLASSPATH of the tomcat installation. Another location would be <CATALINA_HOME>/lib