Table of Contents

Einrichten des Aident LocalLink-Agents

In diesem Artikel erfahren Sie, wie Sie einen neuen Aident LocalLink-Agent einrichten.

Voraussetzungen

  • Windows 10 Version 1607 oder höher, Windows Server 2016 oder höher.
  • .NET8 auf Ihrem Server installiert.

Installation

Es gibt zwei verschiedene Möglichkeiten, um Aident LocalLink zu installieren. Entweder automatisch über einen Paketmanager (Chocolatey) oder manuell durch Kopieren der Installationsdateien.

  • Installationspfad: C:\Program Files\Aident\LocalLink\
  • Lizenz- und Konfigurationspfad: C:\ProgramData\Aident\LocalLink\

Automatische Installation

  1. Chocolatey einrichten (einmalig pro Maschine)

Installieren Sie den Paketmanager entweder manuell oder nutzen Sie folgendes PowerShell Skript:

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
  1. Privaten Feed registrieren

Kopieren und führen Sie das folgende PowerShell Skript aus.

Note

Die private NuGet feed URL und das Zugriffstoken, welche in den kommenden Schritten benötigt werden, erhalten Sie vom Aident Customer Service. Ersetzen Sie die Platzhalter <private-feed-url> und <PAT> durch die bereitgestellten Werte.

# Installiert den Azure DevOps / NuGet credential provider (wird für PAT Authentifizierung benötigt)
choco install nuget-credentialprovider-vss -y

# Registriert den Aident feed für LocalLink
choco source add `
    --name=AidentLocalLinkFeed `
    --source="<private-feed-url>" `
    --user="AzureDevOps" `
    --password="<PAT>" `
    --priority=1
  1. Installieren des LocalLink Agenten

Kopieren und führen Sie das folgende PowerShell Skript aus, um Aident LocalLink zu installieren.

choco install LocalLinkAgent --source=AidentLocalLinkFeed

Manuelle Installation

Note

Die Installationsdateien sowie die Lizenzdatei, welche in den kommenden Schritten benötigt werden, erhalten Sie vom Aident Customer Service.

Entpacken Sie die Installationsdatei und verschieben Sie den Inhalt nach C:\Program Files\Aident\LocalLink\.

4. Lizenzinstallation

Kopieren Sie license.json und publickey.pem in das Verzeichnis C:\ProgramData\Aident\LocalLink.

5. Dienstkonfiguration

Navigieren Sie im Windows Explorer in das Verzeichnis C:\Program Files\Aident\LocalLink\ und führen Sie die setup.exe aus, um den Aident LocalLink Dienst zu konfigurieren.

  • Navigieren Sie zu Add Endpoints und drücken Sie die Enter-Taste.
  • Geben Sie die Endpoint URL ein und drücken Sie die Enter-Taste.
  • Geben Sie den Endpoint Port ein und drücken Sie die Enter-Taste.

Geben Sie weitere Endpoint URLs und Ports ein, wenn sie diese konfigurieren möchten. Andernfalls geben Sie e ein und drücken Sie die Enter-Taste, um das Menü zu verlassen.

  • Geben Sie den API Benutzernamen ein und drücken Sie die Enter-Taste.
  • Geben Sie das API Passwort ein und drücken Sie die Enter-Taste.
  • Drücken Sie die Enter-Taste, um zum Hauptmenü zurückzukehren.

Navigieren Sie zu Start Single instance und drücken Sie die Enter-Taste, um die Dienstinstanz zu starten. Der Aident LocalLink Dienst ist ab sofort bereit für Verbindungen. Sie können den Status jederzeit einsehen, indem Sie zu Status navigieren und die Enter-Taste drücken. Alternativ können Sie einen Web Browser öffnen und die vollständige Endpoint URL inklusive Port eingeben und die Ping-Methode der API abfragen (standardmäßig: http://localhost:5000/api/ping).

Nächster Schritt

Einrichten einer neuen Verbindung in Ihrer Microsoft Dynamics 365 Business Central Umgebung.