How to connect to Advantage Database Server (ADS)

Document created by mallika_velu350985 Employee on May 1, 2017Last modified by Adam Arrowsmith on May 15, 2017
Version 3Show Document
  • View in full screen mode

This article describes how to configure the Database Connection component and required Custom Libraries to connect to Advantage Database Server via JDBC.




Setting up a database connection to Advantage Database Server can be challenging if you are not aware that the version of the ADS JDBC driver much match the server version. Below are instructions for setting up the custom database connection for ADS.



  1. Obtain ADS drivers and connectivity information
  2. Upload drivers to your AtomSphere account
  3. Create and deploy Custom Library component for drivers
  4. Create new Database Connection component
  5. Test connectivity



  1. Obtain the following ADS server information
    1. Host Name or IP Address (fully qualified DNS name of the ADS server or IP Address)
    2. Port Number 
    3. Path (the shared folder path for the database) 
    4. ADS Server version
  2. Download the JDBC driver matching the server version from ADS Devzone. For example, if the server version is 10.1, you must download the JDBC driver for 10.1. 
  3. Upload the downloaded JDBC driver to your AtomSphere account. Go to Setup > Account Libraries:
    1. Click "Upload a File" and browse to where you saved the adsjdbc.jar file.
    2. Click "Upload". Add a Description for future reference.
  4. In the Build tab, create a Custom Library component for the ADS driver.
    1. Custom Library Type: Connector
    2. Connector Type: Database
    3. Included JAR files: select the adsjdbc.jar from your Account Libraries:
  5. Deploy the Custom Library component..
    1. After saving the component, click "View Deployment".
    2. Attach and deploy the component to the desired Environment.
  6. After the deployment, the jar file should be available in userlib/database folder on the Atom attached to the environment where the custom library component was deployed
    1. You can validate the jar file is available in userlib/database by going into Atom Management > Environment > Atom > Installed Libraries
  7. Create a new Database Connection component for your ADS server.
    1. Driver Type: Custom
    2. User Name and Password: as required
    3. Class Name: com.extendedsystems.jdbc.advantage.ADSDriver
    4. Connection URL: The connection URL consists of the following, for more information click here:
      1. Class Path: jdbc:extendedsystems:advantage
      2. Host Name: Fully qualified host name of IP address for the ADS server
      3. Port: TCP port of ADS server
      4. Path: Path to the data source directory (UNC path) and data dictionary name
  8. Example Connection Parameters
    1. Host Name:
    2. Port Number: 6262
    3. Path: /shared/data/adsdata.add (Data Source = /shared/data, data dictionary name = adsdata.add)
    4. UserName: testuser
  9. Test the connection to make sure the connection is established successfully.