Skip to content
English
Submit a ticket https://go.bluware.com/
Contact us
  • There are no suggestions because the search field is empty.

InteractivAI Data Connector

Installation Guide V 1.1

InteractivAI Data Connector — Installation Guide

Last Updated: April 2026  |  Applies To: InteractivAI-Connectors 1.1.x

Overview

The InteractivAI Connectors installer bundles the InteractivAI Data Connector application and optional Petrel plugins into a single setup file so you only have to run one installer.

Components

Component What It Does
InteractivAI Data Connector Desktop application that connects Petrel to InteractivAI, DataHub, and optionally FAST for seismic data processing and visualization
Petrel 2023 Plugin Integrates InteractivAI into Schlumberger Petrel 2023 Workstation (optional)
Petrel 2024 Plugin Integrates InteractivAI into Schlumberger Petrel 2024 Workstation (optional)

Dependencies

Dependency Why It Is Needed
.NET Framework 4.7.2 Microsoft runtime required by the installer bootstrapper and Petrel plugins

System Requirements

Requirement Minimum
Operating System Windows 11 or Windows Server 2019
GPU Memory 24 GB
CPU Memory (RAM) 128 GB
Disk 1 TB SSD
Petrel Petrel 2023 or Petrel 2024 (required only for Petrel plugin features)
Privileges Administrator rights required (installer is per-machine only)
Note: GPU memory, CPU memory, and disk space requirements may vary depending on the size of your datasets, the workflows you run, and any additional software in your environment. The values listed above are minimum recommendations for typical workloads.

Before You Begin

Before starting the installer, make sure you have the following ready:

  • Petrel 2023 and/or Petrel 2024 already installed (if you want the plugins)
  • Administrator rights (the installer always installs per-machine for all users)
  • BLUWARE_LICENSE environment variable set to your license server (e.g. 5053@license_server)
  1. Check that Petrel is installed. The Petrel plugins require Petrel 2023 or Petrel 2024. The installer detects which versions are present and enables the corresponding plugin checkboxes automatically. If no Petrel installation is found, the plugin checkboxes will be disabled.
  2. Check for previous installations. If you have an older version of InteractivAI Data Connector, the installer will upgrade it in place automatically. No manual uninstall is required.
  3. Make sure you have administrator rights. The installer requires administrator privileges. If Windows asks "Do you want to allow this app to make changes to your device?", click Yes.
  4. Set up the BLUWARE_LICENSE environment variable. Before you can launch the InteractivAI Data Connector, set the BLUWARE_LICENSE environment variable to your license server address in the format port@hostname. Open System Properties > Environment Variables and add a new System variable named BLUWARE_LICENSE with the value provided by your IT administrator.
  5. Know your environment URLs. After installation, the InteractivAI Data Connector needs the URLs for InteractivAI, DataHub, and optionally FAST services. Ask your IT administrator for these values if you do not have them.

Interactive Installation

This is the recommended method for most users. Follow the steps below to install using the graphical installer.

  1. Launch the installer. Double-click InteractivAI-Connectors-<version>-<revision>.exe. If Windows prompts for permission, click Yes. The License Agreement screen will appear.
  2. Accept the license agreement. Read through the terms, then tick I agree to the license terms and conditions. The Install and Options buttons will become active.
  3. Configure your settings. Click Options to open the settings dialog and select which optional Petrel plugins to install.
    • Install Petrel 2023 Plugin (optional) — enabled only if Petrel 2023 is detected
    • Install Petrel 2024 Plugin (optional) — enabled only if Petrel 2024 is detected
  4. Save your settings. Click OK in the Options dialog to return to the Welcome screen.
  5. Start the installation. Click Install. A progress bar will show the status of each component. This typically takes a few minutes.
  6. Finish. When installation is complete, click Close to exit the installer.
Note: Petrel plugin checkboxes are only enabled when the corresponding Petrel version is detected. If a checkbox is grayed out, install Petrel first, then re-run this installer.

Upgrades

When the installer detects a compatible existing installation, it upgrades each component in place and preserves your previous configuration automatically. No manual uninstall is required. If a newer version is already installed, the installer will show Repair and Uninstall options instead of the Install page.

Default Install Paths

Component Default Path
InteractivAI Data Connector C:\Program Files\Bluware\InteractivAI-Connectors
Petrel 2023 Plugin <Petrel 2023 install>\Extensions\Installers\<ProductCode>
Petrel 2024 Plugin <Petrel 2024 install>\Extensions\Installers\<ProductCode>

Getting Started After Installation

Launch the InteractivAI Data Connector

Open the Start Menu and search for InteractivAI Data Connector, or double-click the desktop shortcut. The application will start and appear in your system tray.

Open Petrel with the Plugin

If you installed the Petrel plugin, launch Petrel as usual. The InteractivAI plugin will load automatically — you should see the InteractivAI menu or toolbar in Petrel.

Configure the InteractivAI Data Connector

On first launch, the installer creates a default configuration file at:

%APPDATA%\Bluware\DataConnector\DataConnectorConfig.ini
Important: The default configuration assumes InteractivAI and DataHub are running on the same machine (localhost). If either service runs on a different machine or a Kubernetes (K8s) cluster, you must update interactivai_url and datahub_url to point to the correct server addresses. The connector will not be able to connect unless the URLs are correct.

Key Configuration Settings

Setting Default Description
interactivai_url http://localhost:3090 InteractivAI server URL. Change if running on a remote server or K8s cluster.
datahub_url http://localhost:9000 DataHub server URL. Change if running on a remote server or K8s cluster.
datahub_user_id <Windows username> User ID for DataHub. Defaults to current Windows username.
fast_url http://localhost:27182 FAST server URL (optional)
petrel_grpc_url localhost:50000 Petrel plugin gRPC address
zgy_output_path %TEMP%\ZGY Output directory for ZGY files
connector_grpc_url localhost:50001 InteractivAI Data Connector gRPC address
connector_log_level 20 (INFO) DEBUG=10, INFO=20, WARNING=30, ERROR=40, CRITICAL=50

Verify Your Installation

  1. InteractivAI Data Connector — Search for it in the Start Menu and launch it. The application should appear in the system tray.
  2. Petrel GUI — Launch Petrel 2023 or 2024 and open a project. Look for the InteractivAI data connector icon in the toolbar. You can also verify via Petrel Plugin Manager.
  3. Configuration file — Open a command prompt and run: 
    dir "%APPDATA%\Bluware\DataConnector\DataConnectorConfig.ini"

If any of these checks fail, see the Troubleshooting section below.

What the Installer Configures (IT Administrators)

If you installed using the interactive method, everything in this section was set up automatically and you can skip it.

Registry Entries

Key Value Content
Software\Bluware\InstalledProducts\InteractivAI-Connectors InstallLocation InteractivAI Data Connector install path
HKCU\Software\Bluware\InteractivAI-Connectors installed Set to 1 when installed
HKCU\Software\Bluware\InteractivAI-Connectors folder Start Menu folder created

Shortcuts Created

Shortcut Location
InteractivAI Data Connector Desktop
InteractivAI Data Connector Start Menu > Bluware
Note: The configuration file at %APPDATA% is not removed during uninstall, preserving your settings if you reinstall later.

Uninstallation

Interactive Uninstall

  1. Open Windows Settings > Apps > Installed apps.
  2. Find InteractivAI Data Connector in the list and click Uninstall.
  3. Alternatively, re-run the original installer .exe — it will detect the existing installation and offer Repair and Uninstall options.

Command-Line Uninstall

InteractivAI-Connectors-<version>-<revision>.exe /uninstall /quiet /norestart

What Gets Removed

  • The InteractivAI Data Connector application and all installed files
  • All Petrel plugins that were installed
  • Desktop and Start Menu shortcuts
  • Registry entries under Software\Bluware\InstalledProducts\InteractivAI-Connectors
Note: .NET Framework 4.7.2 is a shared component and is not removed during uninstall. Configuration files in %APPDATA% are also preserved.

Troubleshooting

Viewing Logs

The installer writes log files to %TEMP%. To write the log to a specific location:

InteractivAI-Connectors-<version>-<revision>.exe /install /log C:\Logs\iai-connector.log

Common Issues

Problem What to Do
Petrel plugin checkbox is grayed out Install Petrel 2023 or 2024 first, then re-run the installer
Petrel does not show the InteractivAI plugin Restart Petrel after installation. Check that the plugin was selected during install.
InteractivAI Data Connector fails to connect Edit DataConnectorConfig.ini in %APPDATA%\Bluware\DataConnector and verify all URLs
UAC prompt appears Click Yes — administrator rights are required for per-machine installation
Installation fails with error code Check the log file in %TEMP% for details. See Exit Codes below.

Exit Codes

Exit Code Meaning
0 Success
1602 User cancelled installation
1641 Success, reboot initiated
3010 Success, reboot required (use with /norestart)
1603 Fatal error during installation
Note for SCCM/Intune deployments: Configure both 0 and 3010 as success codes to avoid false failure reports.

Getting Help

  • Petrel plugin integration issues — Contact your IT administrator
  • Installer issues — Contact Bluware Support at support@bluware.com
  • U.S. Headquarters — 11740 Katy Freeway, Suite 1350, Houston, TX 77079
  • Europe Regional Office — Nedre Vollgate 5, 4th Floor, 0158 Oslo, Norway