Table of Contents

Set up the Innovis LocalLink agent

In this article you will learn how to set up a new Innovis LocalLink agent.

Prerequisites

  • Windows 10 Version 1607 or higher, Windows Server 2016 or higher
  • Minimum .NET8 SDK installed on your server

Installation

There are two possible ways to install Innovis LocalLink. Either automatically via package manager (Chocolatey) or manually by copying the binaries.

  • Installation path: C:\Program Files\Aident\LocalLink\
  • Config path: C:\ProgramData\Aident\LocalLink\

Automatic Installation

  1. Prepare Chocolatey (once per machine)

Either install the package manager manually or use the following PowerShell script:

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
  1. Register the private feed

Copy and run the following script to your PowerShell session.

Note

The private NuGet feed URL and access token required in the steps below are supplied by Innovis Customer Service. Replace the placeholders <private-feed-url> and <PAT> with the values you receive.

# Install the Azure DevOps / NuGet credential provider (needed for PAT auth)
choco install nuget-credentialprovider-vss -y

# Register the Innovis feed for LocalLink
choco source add `
    --name=AidentLocalLinkFeed `
    --source="<private-feed-url>" `
    --user="AzureDevOps" `
    --password="<PAT>" `
    --priority=1
  1. Install the LocalLink Agent package

Copy and run the following script in your PowerShell session in order to install Innovis LocalLink.

choco install LocalLinkAgent --source=AidentLocalLinkFeed

Manual Installation

Note

The installation binaries required in the steps below are supplied by Innovis Customer Service.

Unzip the binaries and place the contents to C:\Program Files\Aident\LocalLink\.

4. Service configuration

In Windows explorer navigate to C:\Program Files\Aident\LocalLink\ and run setup.exe to configure the LocalLink service.

  • Navigate to Add Endpoints and press Enter.
  • Input Endpoint URL and press Enter.
  • Input Endpoint port and press Enter.

Continue entering your endpoint URL and port if you want to configure more endpoints. Otherwise enter e and press Enter to exit.

  • Input API username and press Enter.
  • Input API password and press Enter.
  • Press Enter to return to main menu.

Navigate to Start Single instance and press Enter to start the service instance. The Innovis LocalLink service is now ready for connections. You can check the status by navigating to Status and pressing enter. Alternatively you can open a web browser and enter your full endpoint url with port and request the ping method of the api (default: http://localhost:5000/api/ping).

Next step

Set up a new connection in your Microsoft Dynamics 365 Business Central environment.