Anveo Mobile App / Installation / Anveo Server Installation (Typ B und C)

Anveo Server Installation (Typ B und C)

Es gibt verschiedene Varianten der Anveo Mobile App Installation: Als managed Variante mit Anveo Mobile App Cloud Service und als self-managed Variante mit dem Anveo Server. Einen Überblick über die verfügbaren Varianten finden Sie in den Systemanforderungen. Diese Installationsanleitung beschreibt Anveo Typ B und C: self-managed.

Wann sollte ich managed oder self-managed Installation verwenden?
Die managed Variante ist die deutlich schnellere und einfachere Variante. Anveo bietet den App Service und den Delta Service als SaaS-Lösung an. Wenn Sie keinen eigenen Anveo-Server betreiben wollen, wählen Sie bitte die Installationsvariante Anveo Typ A (managed).

Der Anveo Server stellt den Anveo App Service sowie den Delta Service (für Anveo B Installationen) zur Verfügung. Sowohl der Anveo Server als auch die PostgreSQL-Datenbank sind mehrinstanzfähig, so dass sie für mehrere Systeme wie Produktions- und Sandbox-Umgebungen verwendet werden können.

Der Anveo App Service ist die Verbindung zwischen der auf mobilen Geräten installierten Anveo Mobile App und Microsoft Dynamics System. Es dient der Authentifizierung und Sicherheit und kann vor einer Firewall installiert werden, um Ihr System zu schützen.

Der Anveo Server wird für die Anveo Infrastrukturvarianten Anveo B und C benötigt. Sie können es einfach mit einem Setup installieren. Alternativ kann der Anveo Mobile App Cloud Service verwendet werden, um den Anveo Server zu installieren. Weitere Informationen über den Anveo Mobile App Cloud Service finden Sie hier.

Die Anveo-Infrastrukturvariante B erfordert außerdem die Installation einer PostgreSQL-Datenbank. Die PostgreSQL-Datenbank stellt den Anveo Delta Server zur Verfügung, der für den Anveo Delta Service obligatorisch ist. Diese Installation wird im Folgenden beschrieben. In Anveo Infrastruktur Variante C wird der Delta Server direkt in der SQL-Datenbank installiert, in der sich die Microsoft Dynamics-Datenbank befindet. Daher ist der Delta-Service für diese Installationsvariante nicht erforderlich.

Anveo Server installieren

Installieren Sie den Anveo Server, indem Sie die Anveo Server Setup.exe ausführen. Wählen Sie die Sprache und das Zielverzeichnis.

Danach werden Sie aufgefordert, einen Port und ein Passwort auszuwählen. Das Kennwort wird später für die Einrichtung in Microsoft Dynamics benötigt. Aus Sicherheitsgründen sollte es nur dem Administrator bekannt sein.

Aufgrund der verschlüsselten Übertragung von Daten zwischen dem Anveo Server und dem Anveo Mobile App Client empfehlen wir die Verwendung eines SSL-Zertifikats. Weitere Informationen über die Verwendung eines Zertifikats finden Sie in unserer Knowledge Base hier. Für Testumgebungen können Sie dieses Feld leer lassen und es wird ein selbstsigniertes Zertifikat erstellt


Wo kann ich den Thumbprint meines SSL-Zertifikats finden?

Sie können den Thumbprint Ihres SSL-Zertifikats wie folgt finden:
Geben Sie in der Windows-Suche „Zertifikate“ oder „certlm.msc“ ein. Sie erhalten das folgende Fenster:

Unter der Registerkarte „Details“ finden Sie den Thumbprint :


Nach Eingabe des Thumbprint können Sie Ihre Einstellungen überprüfen und die Installation starten.

Bitte beachten Sie: Beim Kopieren und Einfügen aus diesem Feld werden je nach Windows-Version unsichtbare Sonderzeichen am Anfang oder Ende eingefügt. Diese sollten durch Löschung entfernt werden.

Nachdem die Installation abgeschlossen ist, können Sie überprüfen, ob der Anveo Server erfolgreich gestartet wurde.

Im Falle eines Fehlers überprüfen Sie bitte die Fehlermeldungen. Mögliche Ursachen können ein falscher Thumbprint des SSL-Zertifikats oder ein bereits zugewiesener TCP-Port sein.

Installation der PostgreSQL-Datenbank

Um den Anveo Server im Rahemn der Anveo Variante B zu verwenden, wird die PostgreSQL-Datenbank benötigt. Sie können es über diesen Link herunterladen .

Bitte beachten Sie, dass bei der Anveo Variante C die PostgresSQL Datenbank nicht erforderlich ist und dieser Abschnitt übersprungen werden kann. Bitte fahren Sie mit „Windows-Firewall-Einrichtung“ fort.

Für Testumgebungen empfehlen wir, die PostgreSQL-Datenbank auf demselben Server wie den Anveo Server zu installieren.

Für Live-Systeme empfehlen wir die Verwendung separater Server. So kann der Anveo-Server als Frontent-Server in der DMZ stehen, während PostgreSQL in einer gesicherten Umgebung installiert ist. Bei der Installation auf einem anderen Server müssen zusätzliche Sicherheitseinstellungen in PostgreSQL vorgenommen werden, die hier nicht dokumentiert sind. Ausführlichere Informationen finden Sie unter diesem Link

Im ersten Schritt wählen Sie den Installationsort.

Installieren Sie die standardmäßig ausgewählten Komponenten. Der Stack Builder ist nicht erforderlich. Sie können sie also aus den zu installierenden Komponenten entfernen.

Im nächsten Schritt können Sie das Zielverzeichnis der Datenbank ändern.

Bitte setzen Sie das Passwort für die Datenbank. Dieses Passwort sollte sich deutlich von dem des Anveo-Servers unterscheiden und auch nur dem Administrator bekannt sein.

Der nächste Schritt besteht darin, den Port für die PostgreSQL-Datenbank festzulegen. Wenn möglich, sollte der Standardport (5432) von PostgreSql verwendet werden. Falls erforderlich, können Sie sie jedoch ändern.

Sie können die Sprache/den Ort im nächsten Schritt anpassen. Wir empfehlen Ihnen, die Standardeinstellung beizubehalten.

Bevor Sie mit der Installation beginnen, können Sie noch alle Einträge überprüfen.

Schließlich wird die Installation gestartet:

Windows-Firewall-Einrichtung

Für die Kommunikation zwischen dem Anveo Server, der Anveo Mobile App und Dynamics müssen die entsprechenden Ports in der Windows Firewall eingerichtet werden.  

Kommunikation Anveo Server mit Microsoft Dynamics

Der Anveo Server kommuniziert mit dem Microsoft Dynamics Web Service über den Anveo Server Konfigurationsport. Standardmäßig ist dies Port 8888, kann aber bei der Installation von Anveo Server anders eingestellt werden. Dieser Port muss nur für die Kommunikation mit Microsoft Dynamics Web Services geöffnet werden. Es wird nicht empfohlen, diesen Port auf Public zu setzen.

Öffnen Sie die Windows-Firewall.

Geben Sie den Typ an.

Der Anschluss wird im nächsten Schritt festgelegt.

Der nächste Schritt ist die Angabe der Richtung.

Und in welchem Fall die Firewall-Regel greifen sollte.

Schließlich braucht die neue Firewall-Regel einen aussagekräftigen Namen.

Kommunikation Anveo Server mit der Anveo Mobile App

Die Kommunikation zwischen dem Anveo Server und der Anveo Mobile App erfordert zwei Ports pro Instanz. Standardmäßig sind dies die Ports 7020 und 7021. Diese Häfen müssen öffentlich zugänglich sein.

Hinweis: Wenn Sie eine weitere Instanz auf diesem Anveo-Server planen, können Sie zum Beispiel zusätzliche Ports wie 7022-7023 aktivieren.

Erstellen Sie eine neue Firewall-Regel und geben Sie ihren Typ an.

Geben Sie die entsprechenden Ports ein.

Folgen Sie den weiteren Schritten wie oben beschrieben. Geben Sie schließlich erneut einen aussagekräftigen Namen ein.

Nachdem die Einrichtung erfolgreich abgeschlossen ist, sollten Sie die neuen Regeln in der Firewall sehen.

Bitte beachten Sie:
Wenn die PostgreSQL-Datenbank nicht auf demselben Server installiert ist, muss ein anderer Port aktiviert werden. Auf dem Server der PostgreSQL-Installation muss der Port 5432 (oder der angepasste Port) standardmäßig für die Kommunikation mit dem Anveo-Server geöffnet sein. Dieser Port muss auch nur intern zugänglich sein und sollte nicht von außen zugänglich sein.

Einrichtung in Microsoft Dynamics

Öffnen Sie in Microsoft Dynamics den Assistenten für die Einrichtung der Anveo Mobile App.

Starten Sie die Einrichtung der Anveo Mobile App in Microsoft Dynamics, indem Sie angeben, dass Sie den Anveo Server auf Ihrer eigenen Infrastruktur installiert haben (Self-managed Anveo Server). Geben Sie außerdem einen eindeutigen Anveo Instanznamen an. Diese wird später auf den mobilen Geräten zur Anmeldung verwendet. Er sollte den Mandant Ihres Mandant enthalten und so kurz und prägnant wie möglich sein.

Im nächsten Abschnitt werden Sie aufgefordert, die Verbindungsdaten zum Anveo-Server einzugeben.

Die App-Service-Adresse (extern) ist der „Full Qualified Domain Name“ (FQDN), für den Sie ein gültiges, offiziell bestätigtes Zertifikat benötigen. Der Anveo Server ist für den Anveo-Mobile-App-Client von außen über diese Adresse erreichbar. Damit eine SSL-Zertifikatsprüfung durchgeführt werden kann, sollte an dieser Stelle ein FQDN und nicht eine IP-Adresse verwendet werden.

Der TCP-Port des App-Dienstes ist standardmäßig auf 7020 eingestellt, sofern er nicht manuell angepasst wird. Wenn mehrere Anveo App Services von einem Anveo Server bereitgestellt werden, weicht dieser Port vom Standard ab.

Der http-Port des App-Dienstes ist normalerweise 7021. Dies kann auch bei Mehrfachanlagen anders sein.

Die Anveo-Server-Adresse (intern) ist die interne Adresse, über die Microsoft Dynamics den Anveo Server erreichen kann. Wichtig: Diese Adresse sollte für die Außenwelt nicht zugänglich sein.

Der Server Port ist standardmäßig 8888 und wurde auch bei der Installation des Anveo Servers festgelegt.

Sie haben das Anveo Server-Passwort bei der letzten Installation des Anveo Servers vergeben.

Nachdem Sie die Verbindungsdaten für den Anveo-Server eingegeben haben, müssen Sie im nächsten Schritt die Verbindungsdaten zur PostgreSQL Datenbank einrichten.

Die Datenbankadresse ist der „Full Qualified Domain Name“ (FQDN) oder die IP-Adresse, unter der die PostgreSQL-Datenbank vom Anveo-Server aus erreicht werden kann. Wenn die PostgreSQL-Datenbank auf demselben Server wie der Anveo Server installiert ist, geben Sie hier bitte „localhost“ ein. Wenn die PostgreSQL-Datenbank auf einem anderen Server installiert ist, muss der externe Zugriff trotzdem eingerichtet werden. Weitere Informationen dazu finden Sie unter diesem Link.

Der SSL-Modus ist Deaktiviert.

Der Datenbankbenutzer ist standardmäßig „postgres“.

Das Datenbankpasswort haben Sie bei der Installation der PostgreSQL-Datenbank vergeben.

Der nächste Schritt ist die Angabe der Webdienst-URL und des Standardclients.

Der nächste Schritt besteht darin, den Anveo Server einzurichten.

Der nächste Schritt besteht darin, der Instanz eine Lizenz zuzuweisen.

Bitte nicht:
Dies ist keine Fehlermeldung. Bitte kontaktieren Sie unser Team unter [email protected]. Sie können eine Testlizenz für Sie erstellen oder Ihre vorhandene Live-Lizenz der Instanz zuweisen. Geben Sie dazu Ihren Anveo Instanznamen ein, den Sie zu Beginn vergeben haben. Nachdem Sie eine Antwort von unserem Team erhalten haben, starten Sie bitte den Anveo-Assistenten neu.

Der Anveo Assistent setzt die Einrichtung mit der Einstellung des Job Intervals fort.

Für die Berechnung der Deltadaten empfehlen wir, einen Job in Microsoft Dynamics zu erstellen, der automatisch die Änderungen in den Dynamics-Daten ermittelt und in regelmäßigen Abständen an den Anveo Delta Service übermittelt.

Diese Berechnung wird bei jeder Synchronisierung von Anveo-Benutzern automatisch gestartet. Der automatische Job minimiert die Synchronisationszeit erheblich, da die Daten immer in der Zwischenzeit berechnet werden und nicht erst zum Zeitpunkt der Synchronisation.

Datenreplikation zum Anveo Delta Service

Die Replikation von Daten in den Anveo Delta Service ist eine erforderliche Funktion, die bei der ersten Installation mit Hilfe des Installationsassistenten automatisch eingerichtet wird. Wenn Sie die App jedoch nach Ihren Bedürfnissen konfigurieren, ist ein genauerer Blick auf die Einrichtung des Anveo Delta Service erforderlich.

Was macht der Anveo Delta Dienst?

Um dem Nutzer eine schnelle Synchronisation zu ermöglichen, werden nur die Datenänderungen (das Datendelta) und nicht immer alle Daten (sog. Volllast)
zwischen Dynamics und der Anveo Mobile App übertragen. Zu diesem Zweck werden Datenänderungen in Dynamics vom Anveo Delta Service on the fly ermittelt und über den Anveo App Service der Anveo Mobile App zur Verfügung gestellt.

Zu diesem Zweck werden alle Datenänderungen in regelmäßigen Abständen von Dynamics an den Anveo Delta-Dienst übertragen, damit dieser die Berechnung schnell durchführen kann. Dies wird von Delta Service Replication übernommen.

Im Anveo Mobile App-Client auf dem mobilen Gerät sind nur die Daten verfügbar, die durch die Anveo-Synchronisationspakete und die Einrichtung des Delta-Servers definiert sind – siehe Einrichtung des Delta-Servers.

Wichtig! Neuanmeldung nach Konfigurationsänderungen

Aufgrund einiger Einschränkungen von Microsoft Dynamics ist es notwendig, alle Benutzer ab- und wieder anzumelden, nachdem Sie einige Konfigurationsänderungen am Anveo Delta Service Setup vorgenommen haben. Daher empfehlen wir, Änderungen außerhalb der Arbeitszeiten vorzunehmen. Heute ist für mobile Benutzer eine Ausfallzeit erforderlich, während die Änderungen neu synchronisiert werden. In zukünftigen Versionen werden Sie in der Lage sein, Änderungen nachts automatisch und ohne Ausfallzeit zu synchronisieren.

Installieren Sie die Anveo Sales oder Service App

Wenn Sie die Anveo Sales oder Service App als Erweiterung installiert haben, werden Sie nun gefragt, ob Sie diese einrichten möchten.

Anveo Sales App

Hier finden Sie die Installationshandbücher für die gebrauchsfertigen Lösungen der Anveo Sales App.

Anveo Service App

Hier finden Sie die Installationsanleitungen für die gebrauchsfertigen Lösungen der Anveo Service App.