Installing Birst Cloud Agent

  1. Navigate to Modeler Connect.
  2. Select the SQL Databases connector or click +Create and select SQL Databases from the Select the connector list.
  3. Specify a Connection Name.
  4. Click Download Local Agent to download the zipped file for the agent.
    You can retrieve the zipped file for the Birst Cloud Agent from your download directory.
  5. Extract the contents of the zipped file to the desired location (on your local machine or to a remote dedicated server).
  6. Open the BirstCloudAgent directory.
  7. Open the bin directory and double-click the Agent For Windows Batch File, Mac XXX file to run it. For Windows: execute the "Agent.bat", for Mac/UNIX/Linux, run the "Agent" script).
    Mac users may get a security pop up saying, "Agent is a Unix application downloaded from the Internet". If this occurs, click Open on this dialog box, or go to your Mac System Preferences > Security and Privacy > General Tab to open the application from there. Alternatively, you can run the Agent by opening a Terminal window, navigating to the /bin directory in the folder in which you unzipped the Agent files, and run the command: "./Agent" without the quotes.
    Note: Birst Connect requires the installation of Java JDK 11 on the machine where the Agent is running. Users must point both Birst Connect 1 and Birst Connect 2 to Java 11 and use Amazon Corretto 11.x or greater for Java 11.
  8. With the Agent running, select your local agent from the Create Connection panel.
    Note: By default, the agent name is inherited from the machine name where the agent is running. You can rename the agent if desired. Agent name should be unique in case of multiple agents on the same machine.
    To close the Local Agent Selection box, click the drop-down arrow.

Birst can delete unwanted or duplicate Birst Cloud Agents.

Note: Users can only be able to delete their own Birst Cloud Agents unless they are an Account Administrator. Account Administrators have permissions to delete any Birst Cloud Agent.

Select to show online agents only to filter out inactive agents.

Select to show selected agents only to reduce the number of displayed cloud agents.