Configuring the Runtime

 To run Flogo apps, you must first add a runtime environment.
    Procedure
  1. Select the icon in Activity Bar.
  2. In the Runtime Explorer, click Add a New Runtime or if a runtime exists click +.
  3. In the input field on the top, select the runtime type:
    • Local Runtime
    • TIBCO Platform
    • TIBCO Cloud™ Integration (TCI)

Creating Local Runtime

In the New runtime dialog, specify the following details: 

  • Name: name for the runtime
  • Runtime type is Local Runtime by default.
  • EMS Home: path to EMS Installation directory.
  • IBM MQ Home: path to IBM MQ Installation directory.

Creating a Runtime for TIBCO Platform

In the New runtime dialog, specify the following details: 

  • Name: name for the runtime
  • Platform URL: URL of the Control Plane

After entering the Platform URL, click Authenticate. This redirects to the TIBCO Platform URL where you need to sign in. After a successful sign-in, you will be redirected to Visual Studio Code.

Note:

You must select the TIBCO End User Agreement checkbox to proceed. If you do not select this checkbox, you cannot deploy apps.

  • Data Plane: Select the desired data plane from the dropdown menu to which you want to connect.
  • Capability Base URL: This is the Capability Public Base URL, which is present in the Capability that is provisioned in a data plane.
  • TIBCO Developer Hub URL (Optional): Enter the URL of the TIBCO Developer Hub which you want to connect. Developer Hub URL is auto-populated if you have provisioned Developer Hub in the Data Plane.
  • Template tags (Optional): Enter the tags to filter the TIBCO Developer Hub templates.
  • Documentation URL (Optional): URL for platform documentation.

If you use custom certificates for the TIBCO Control Plane setup, you must perform one of the following procedures:

  • Configuring the root CA certificate

  • Disabling certificate validation

Configuring the Root CA Certificate

If you have access to root CA certificate, perform the following steps:

  1. Set the NODE_EXTRA_CA_CERTS environment variable to point to the root CA file. For example, NODE_EXTRA_CA_CERTS=C:\Users\flogouser\Documents\projects\test\mkcerts\rootCA.pem.

  2. Restart Flogo Extension for Visual Studio Code.

If you are using leaf or intermediate certificates, then perform the following steps to chain these certificates with the Root CA certificate:

  1. Combine the certificates into a single file, placing the leaf certificate first, followed by any intermediate certificates, and finally the root certificate at the end.

  2. Then set the NODE_EXTRA_CA_CERTS environment variable to point to the file you just created.

  3. Restart Flogo Extension for Visual Studio Code.

Disabling Certificate Validation

This is not a best practice. However, if you do not have access to root CA certificate, perform the following steps:

  1. Set the value of the NODE_TLS_REJECT_UNAUTHORIZED environment variable to 0.

  2. Restart Flogo Extension for Visual Studio Code

Creating a Runtime for TIBCO Cloud Integration (TCI)

To access TIBCO Cloud Integration apps, you must enable platform APIs from the Cloud APIs for the organization.

Note: To connect to TIBCO Cloud Integration, ensure platform API access is enabled by the organization administrator.

In the New runtime dialog, specify the following details: 

The following Advanced fields are populated by default:

  • Homepage URL: https://cloud.tibco.com/
  • Documentation URL: https://integration.cloud.tibco.com/docs/index.html
  • Designtime URL: https://integration.cloud.tibco.com/applications/details/flows/@{APPID}?applicationType=flogo
  • Default App Export File: The default name with which you want to export an app

After connection to TIBCO Cloud Integration runtime is established, you can see the list of all the apps present in your org by opening the tree dropdown. You can take the following actions for these apps present in your Visual Studio Code org by hovering over the apps:

  • Add app to favorites: Click to set an app as your favorite app that shows under the Favorite Remote Apps section.
  • Export and open JSON: Click to export the app.flogo file of the app and download it in your workspace.
  • Open in Browser: Click to open the app details page, you need to log in to TCI to view this page.
  • Export Binary: Click to create a binary of the app and download it in your workspace.
  • Export and Run Binary: Click to create, download, and run the binary of the app.

How to generate an OAUTH Token?

To create a runtime configuration, you need to first generate an OAUTH token.

    Procedure
  1. Navigate to Settings under your user account icon on TIBCO Cloud Integration.
  2. On the left pane, click OAUTH Access Tokens
  3. Click Generate token to enter the Generate OAuth 2 token dialog.
  4. Specify the following details:
    1. Name: name of your token
    2. Valid for duration: number of days
    3. Can be used by these domains:
      • Integration
      • Connected Intelligence Cloud


  5. Click Generate to create the access token that can be copied from the subsequent window.