Skip to main content

​
Before you start

1

Check the server requirements

Check the server requirements for the connector.
2

Verify connector capabilities

Make sure the connector has these capabilities in a Cognite Data Fusion (CDF) project.
3

Create configuration file

Create a configuration file according to the configuration settings in the working directory of the folder where the connector is installed. The file must be in YAML format.

​
Connect to PROSPER simulator

The connector uses COM to connect to the PETEX OpenServer protocol, which establishes the connection with the PROSPER simulator. In case of connection errors, it can retry. The retry parameters can be defined in the configuration file: 
 automation:
     simulator-retries:
         max-tries: 12
         max-delay: "60s"
This configuration enables retry attempts to the simulator for up to 5 minutes before failing. The retries follow an exponential backoff strategy, starting with shorter delays and gradually increasing to a maximum interval of one minute.
Retry attemptDelay duration before attempt
1░░ (0.5s)
2░░░░ (1s)
3▓▓▓▓▓ (2s)
4██████ (4s)
5██████████ (8s)
6██████████████ (16s)
7██████████████████ (32s)
8████████████████████████ (60s limit)
9████████████████████████ (60s limit)
10████████████████████████ (60s limit)

​
Run as a Windows service

1

Download the installer

Download the prosper-setup-{VERSION}.exe file via the download links available from Data management > Integrate > Extractors in CDF.
2

Run the installer

Run the installer on a Windows operating system. A wizard guides you through the installation process.
3

Select installation folder

Select the destination folder where the connector will be installed. By default, this is C:\Cognite\. Inside this folder, the ProsperConnector working directory is created. The connector expects a config.yml file as the configuration in the same directory.
You’ll find templates for the configuration file in the config folder.
4

Open Windows Services

Open the Services app in Windows and find the Cognite PROSPER Connector service.
5

Start the service

Right-click the service and select Start.

​
Uninstall and update the connector

Run the same MSI installer to uninstall the connector. The installer deletes installed binaries, removes the service, and cleans the application registry. The installation is not deleted and still contains the configuration file, logs, and application data generated by the connector. If the connector is re-installed, it resumes the operation using the saved state. When a new version of the PROSPER connector is available, run the MSI installer for the new version to upgrade the connector to the new version. After the upgrade, you must manually restart the service.