Install the CONNECT to PI Agent

To download the CONNECT to PI Agent, you need at least a Tenant Member role in CONNECT data services. To install the CONNECT to PI Agent, you need the administrator rights on the host computer.

To download and install the CONNECT to PI Agent:

1. In the left pane of the CONNECT data services portal, select Data Collection > PI Agents.

2. Select CONNECT to PI Agents from the agents dropdown selector.

3. Select Download Agent.

4. On the Agent Installer Download window, select Download. When the download completes, select Cancel to close the window.

5. Open the downloaded CONNECT to PI Agent installation file.

   The Welcome page of the CONNECT to PI Agent window opens.

6. On the Welcome page, select Next.

   The Configuration page opens.

7. Make changes to the default installation folder and port, if needed, and select Next.

   Note: The port is used for agent configuration and administration tasks.

8. Select Install.

9. After the agent is installed, select Finish.

   The CONNECT to PI Configuration Utility opens. See Run the CONNECT to PI Configuration Utility for instructions.

   Note: If the data storage region of the namespace in which your agent will be registered is North Europe ("euno") or East Australia ("auea"), you will need to create a PowerShell script with the following commands and execute it on the machine where the agent is installed. If you are unsure which region your namespace is associated with, navigate to Developer Tools > API Console in CONNECT data services and find the prefix of the Full Path.

   North Europe

   $DataSourceUri = "http://localhost:5590/api/v1/configuration/CloudLink/DataSource";

   $response = Invoke-WebRequest -Uri $DataSourceUri

   $updatedContent = $response.Content.Replace("//uswe.", "//euno.")

   Invoke-RestMethod -Uri $DataSourceUri -Method PUT -Body $updatedContent -ContentType "application/json"

   Australia East

   $DataSourceUri = "http://localhost:5590/api/v1/configuration/CloudLink/DataSource";

   $response = Invoke-WebRequest -Uri $DataSourceUri

   $updatedContent = $response.Content.Replace("//uswe.", "//auea.")

   Invoke-RestMethod -Uri $DataSourceUri -Method PUT -Body $updatedContent -ContentType "application/json"

Data privacy with Microsoft Edge WebView2

The CONNECT to PI installation kit makes use of Microsoft Edge WebView2. AVEVA has not disabled Microsoft Defender SmartScreen as part of use of Microsoft Edge WebView2 in this release.

The Microsoft Defender SmartScreen feature collects and transmits user information to Microsoft, as detailed in Microsoft’s statement on Data and Privacy in WebView2 and the Microsoft Edge Privacy Whitepaper.

Customers can disable the Microsoft Defender SmartScreen feature before installing CONNECT to PI. Instructions for disabling this feature are available in the support documentation for Microsoft Edge.