Using TIBCO Cloud™ Integration - Hybrid Agent to Connect TIBCO Flogo® Apps to On-premises Databases

You can set up hybrid connectivity between TIBCO Flogo® apps and on-premises or private cloud databases using the Database connector design-time service (or DB Service). DB Service is a singleton user app you run per subscription of your organization. It enables the activities of a Database connector to be connected to your on-premises or private cloud database through the TIBCO Cloud Integration - Hybrid Agent. The database service is accessible only by the users that belong to the organization.

The DB Service requires that you enable the service using the TIBCO Cloud™ - Command Line Interface, TIBCO Cloud™ Integration API, or Web UI, run the TIBCO Cloud Integration - Hybrid Agent on-premises, and enable the on-premises DB Service in your connectors, as follows:

  1. Log in to TIBCO Cloud™ Integration.
  2. Download the TIBCO Cloud™ - Command Line Interface, as described in Downloading TIBCO Cloud™ Integration Tools.
  3. Install the CLI as described in Installing the TIBCO Cloud™ - Command Line Interface.
  4. Download and configure the TIBCO Cloud Integration - Hybrid Agent for Hybrid Connectivity as described in Downloading, Configuring, and Running the Hybrid Agent. Do not start the agent yet.
  5. Make sure your access to the on-premises or private cloud database is ready.
  6. At the command line, run the following commands, replacing <keyname> with the access key name, <keyvalue> with the key secret, and <newprofile> with a new profile name:
     tibcli login
     tibcli org dbservice enable --accessKey <keyname>
    
    Tip: You can also enable or disable the DB Service from the Web UI. Instead of running the second line above, go to Environment & Tools > Hybrid Connection in the Web UI, click the DB Services Enable toggle, and select an access key.
  7. Run the command to start the TIBCO Cloud Integration - Hybrid Agent for Hybrid Connectivity as described in Using the Agent for Hybrid Connectivity with a spec for the database connection. For example:
     tibagent start agent --spec 3306:10.97.170.85:3306 <agentname>
    
  8. Once the Agent starts, create or edit a app in the TIBCO Cloud Integration Web UI and create a MySQL connection. In the connection, set On Premise DB Service to true. This enables the activities of a TIBCO Flogo® Database connector to be routed to your on-premises database through the TIBCO Cloud Integration - Hybrid Agent instance now running. For step-by-step instructions, see Creating an Oracle MySQL Connection.
    Note: This procedure showcases the DB Service configuration for an Oracle MySQL Server connection to an on-premises database, but these steps also apply to Microsoft SQL Server, and PostgreSQL Server connections.
  9. Click Push in the Web UI to push the app after it has been designed. The app is not running. Do not scale up the app yet.
  10. In the TIBCO Cloud Integration Web UI, click the app to go the associated App Details page, then click Environmental controls > Hybrid Connectivity.
  11. Choose the access key that you created earlier.
  12. Click Push updates in the Web UI again to repush the app.
  13. Scale up the app to start it running.

The app works in design time as well as runtime.

Related Topics

Installing the TIBCO Cloud™ - Command Line Interface

Downloading, Configuring, and Running the Hybrid Agent

Creating or Deleting Access Keys

Using the Agent for Hybrid Connectivity