Table of Contents

Set up the Aident LocalLink agent

In this article you will learn how to set up a new Aident 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 Aident LocalLink. Either automatically via package manager (Chocolatey) or manually by copying the binaries.

  • Installation path: C:\Program Files\Aident\LocalLink\
  • License and 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 Aident 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 Aident 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 Aident LocalLink.

choco install LocalLinkAgent --source=AidentLocalLinkFeed

Manual Installation

Note

The Installation binaries as well as the license file required in the steps below are supplied by Aident Customer Service.

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

4. License installation

Put the license.json and publickey.pem into C:\ProgramData\Aident\LocalLink.

5. 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 Aident 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.