Installation d’Anveo OnPrem (Type B et C)
Il existe différentes variantes de l’installation d’Anveo Mobile App : Variante gérée avec Anveo Mobile App Cloud Service et variante autogérée avec le serveur Anveo. Pour une vue d’ensemble des variantes disponibles, voir la configuration requise. Ce guide d’installation décrit les Anveo Type B et C : autogérés.
Quand dois-je utiliser la gestion déléguée ou l’autogestion ?
La variante gérée est l’option la plus rapide et la plus simple. Anveo fournit le service App et le service Delta en tant que solution SaaS. Si vous ne souhaitez pas utiliser votre propre serveur Anveo, choisissez la variante d’installation Anveo Type A (géré).
Le serveur Anveo fournit le service Anveo App ainsi que le service Delta (pour les installations Anveo B). Le serveur Anveo et la base de données PostgreSQL sont tous deux multi-instances, ce qui permet de les utiliser pour des systèmes multiples tels que des environnements de production et des bacs à sable.
Le service Anveo App est la connexion entre l’application mobile Anveo installée sur les appareils mobiles et le système Microsoft Dynamics. Il est utilisé pour l’authentification et la sécurité et peut être installé devant un pare-feu pour protéger votre système.
Le serveur Anveo est nécessaire pour les variantes d’infrastructure Anveo B et C. Vous pouvez facilement l’installer à l’aide d’un setup. Il est également possible d’utiliser le service Anveo Mobile App Cloud Service pour installer le serveur Anveo. Pour plus d’informations sur le service Anveo Mobile App Cloud, cliquez ici.
Anveo Infrastructure Variant B nécessite également l’installation d’une base de données PostgreSQL. La base de données PostgreSQL fournit le serveur Anveo Delta, qui est obligatoire pour le service Anveo Delta. Cette installation est décrite ci-dessous. Dans la variante C de l’infrastructure Anveo, le serveur Delta est installé directement dans la base de données SQL où réside la base de données Microsoft Dynamics. Par conséquent, le service Delta n’est pas nécessaire pour cette variante d’installation.
Installer le serveur Anveo
Installez le serveur Anveo en exécutant le fichier« Anveo Server Setup.exe« . Sélectionnez la langue et le répertoire cible.
Il vous sera ensuite demandé de sélectionner un port et un mot de passe. Le mot de passe sera nécessaire ultérieurement pour l’installation dans Microsoft Dynamics. Pour des raisons de sécurité, il ne doit être connu que de l’administrateur.
En raison du transfert crypté des données entre le serveur Anveo et le client de l’application mobile Anveo, nous recommandons l’utilisation d’un certificat SSL. Pour plus d’informations sur l’utilisation d’un certificat, veuillez consulter notre Knowledge Base ici. Pour les environnements de test, vous pouvez laisser ce champ vide et un certificat auto-signé sera créé.
Où puis-je trouver l’empreinte de mon certificat SSL ?
Vous pouvez trouver l’empreinte de votre certificat SSL comme suit :
Entrez « Certificats » ou « certlm.msc » dans le moteur de recherche de Windows. La fenêtre suivante s’affiche :
Sous l’onglet « Détails », vous trouverez l’empreinte du pouce :
Après avoir saisi l' »empreinte », vous pouvez vérifier vos paramètres et démarrer l’installation.
Remarque : Lors d’un copier-coller à partir de ce champ, des caractères spéciaux invisibles sont inclus au début ou à la fin, en fonction de la version de Windows. Il convient de les supprimer.
Une fois l’installation terminée, vous pouvez vérifier si le serveur Anveo a été démarré avec succès.
En cas d’erreur, veuillez consulter les messages d’erreur. Il peut s’agir d’une erreur dans l’empreinte du certificat SSL ou d’un port TCP déjà attribué.
Installation de la base de données PostgreSQL
Pour utiliser le serveur Anveo dans l’installation d’Anveo B, la base de données PostgreSQL est nécessaire. Vous pouvez le télécharger à partir de ce lien.
Veuillez noter que pour Anveo Varainte C, la base de données PostgresSQL n’est pas nécessaire et que cette section peut être omise. Veuillez poursuivre avec la « Configuration du pare-feu Windows ».
Pour les environnements de test, nous recommandons d’installer la base de données PostgreSQL sur le même serveur que le serveur Anveo.
Pour les systèmes actifs, nous recommandons d’utiliser des serveurs distincts. Cela permet au serveur Anveo d’être situé en tant que serveur frontal dans la zone démilitarisée, tandis que PostgreSQL est installé dans un environnement sécurisé. Lors de l’installation sur un autre serveur, des paramètres de sécurité supplémentaires doivent être définis dans PostgreSQL, qui ne sont pas documentés ici. Des informations plus détaillées sont disponibles sur ce lien.
La première étape consiste à sélectionner l’emplacement de l’installation.
Installer les composants sélectionnés par défaut. Le Stack Builder n’est pas nécessaire. Vous pouvez donc le retirer des composants à installer.
Dans l’étape suivante, vous pouvez modifier le répertoire de destination de la base de données.
Veuillez définir le mot de passe de la base de données. Ce mot de passe doit être très différent de celui du serveur Anveo et n’être connu que de l’administrateur.
L’étape suivante consiste à définir le port de la base de données PostgreSQL. Si possible, le port par défaut (5432) de PostgreSql doit être utilisé. Toutefois, si nécessaire, vous pouvez le modifier.
Vous pouvez personnaliser la langue/l’emplacement à l’étape suivante. Nous vous recommandons de conserver le réglage par défaut.
Avant de commencer l’installation, vous pouvez encore vérifier toutes les entrées.
Enfin, l’installation est lancée :
Configuration du pare-feu Windows
La communication entre le serveur Anveo, l’application mobile Anveo et Dynamics nécessite la configuration des ports appropriés dans le pare-feu Windows.
Communication Anveo Server avec Microsoft Dynamics
Le serveur Anveo communique avec le service Web de Microsoft Dynamics via le port de configuration du serveur Anveo. Il s’agit du port 8888 par défaut, mais il peut être défini différemment lors de l’installation du serveur Anveo. Ce port ne doit être ouvert que pour la communication avec Microsoft Dynamics Web Services. Il n’est pas recommandé de définir ce port sur Public.
Ouvrez le pare-feu Windows.
Spécifiez le type.
Le port est spécifié à l’étape suivante.
L’étape suivante consiste à spécifier la direction.
Et dans quel cas la règle de pare-feu doit prendre effet.
Enfin, la nouvelle règle de pare-feu doit porter un nom significatif.
Communication entre le serveur Anveo et l’application mobile Anveo
La communication entre le serveur Anveo et l’application mobile Anveo nécessite deux ports par instance. Par défaut, il s’agit des ports 7020 et 7021. Ces ports doivent être accessibles au public.
Note : Si vous prévoyez une autre instance sur ce serveur Anveo, vous pouvez par exemple activer des ports supplémentaires comme 7022-7023.
Créez une nouvelle règle de pare-feu et spécifiez son type.
Entrez les ports appropriés.
Suivez les étapes décrites ci-dessus. Enfin, saisissez à nouveau un nom significatif.
Une fois la configuration terminée, vous devriez voir les nouvelles règles dans le pare-feu.
Remarque :
Si la base de données PostgreSQL n’est pas installée sur le même serveur, un autre port doit être activé. Sur le serveur d’installation de PostgreSQL, le port 5432 (ou le port personnalisé) doit être ouvert par défaut pour la communication avec le serveur Anveo. Ce port doit également être accessible uniquement en interne et ne doit pas être accessible de l’extérieur.
Configuration dans Microsoft Dynamics
Dans Microsoft Dynamics, ouvrez l’assistant de configuration de l’application mobile Anveo.
Commencez la configuration de l’application mobile Anveo dans Microsoft Dynamics en spécifiant que vous avez installé le serveur Anveo sur votre propre infrastructure (Self-managed Anveo Server). En outre, spécifiez un nom d’instance Anveo unique. Elle sera utilisée ultérieurement sur les appareils mobiles pour la connexion. Le nom de l’instance doit contenir le company name votre company name et être aussi court et concis que possible. Vous trouverez ici une liste des noms d’instance qui ne sont pas autorisés.
Dans la section suivante, vous serez invité à entrer les détails de la connexion au serveur Anveo.
L’adresse du service d’application (externe ) est le « nom de domaine complet qualifié » (FQDN) pour lequel vous avez besoin d’un certificat valide et officiellement confirmé. Le serveur Anveo peut être atteint par le client de l’application mobile Anveo depuis l’extérieur via cette adresse. Pour qu’un certificat SSL soit vérifié, il convient d’utiliser un FQDN à ce stade, et non une adresse IP.
Le port TCP du service d’application est fixé par défaut à 7020, à moins qu’il ne soit modifié manuellement. Si plusieurs Anveo App Services sont fournis par un serveur Anveo, ce port diffère du port par défaut.
Le port http de l’App Service est normalement 7021. Cela peut également être différent pour des installations multiples.
L’adresse du serveur Anveo (interne ) est l’adresse interne à laquelle Microsoft Dynamics peut atteindre le serveur Anveo. Important : Cette adresse ne doit pas être accessible au monde extérieur.
Le port du serveur est 8888 par défaut et a également été défini lors de l’installation du serveur Anveo.
Vous avez attribué le mot de passe du serveur An veo lors de l’installation précédente du serveur Anveo.
Après avoir saisi les données de connexion au serveur Anveo, l’étape suivante consiste à configurer les données de connexion à la base de données PostgreSQL.
L’ adresse de la base de données est le « Full Qualified Domain Name » (FQDN) ou l’adresse IP sous laquelle la base de données PostgreSQL peut être atteinte à partir du serveur Anveo. Si la base de données PostgreSQL est installée sur le même serveur que le serveur Anveo, veuillez entrer « localhost » ici. Si la base de données PostgreSQL est installée sur un autre serveur, l’accès externe doit toujours être configuré. Vous trouverez plus d’informations à ce sujet sur ce lien.
Le mode SSL est désactivé.
L’utilisateur de la base de données est « postgres » par défaut.
Le mot de passe de la base de données a été attribué lors de l’installation de la base de données PostgreSQL.
L’étape suivante consiste à spécifier l’URL du service Web et le client par défaut.
L’étape suivante consiste à configurer le serveur Anveo.
L’étape suivante consiste à attribuer une licence à l’instance.
Please not :
Il ne s’agit pas d’un message d’erreur. Veuillez contacter notre équipe à l’adresse [email protected]. Ils peuvent créer une licence d’essai pour vous ou attribuer votre licence existante à l’instance. Pour ce faire, entrez le nom de l’instance Anveo que vous avez attribué au début. Après avoir reçu une réponse de notre équipe, veuillez redémarrer l’assistant Anveo.
L’assistant Anveo poursuit la configuration en réglant l' »intervalle de travail ».
Pour le calcul des données delta, nous recommandons de créer un job dans Microsoft Dynamics qui détermine automatiquement les changements dans les données Dynamics et les transmet à Anveo Delta Service à intervalles réguliers.
Ce calcul est lancé automatiquement à chaque fois que les utilisateurs d’Anveo se synchronisent. Le travail automatique réduit considérablement le temps de synchronisation, puisque les données sont toujours calculées entre-temps et non au moment de la synchronisation.
Réplication des données vers le service Anveo Delta
La réplication des données vers le service Anveo Delta est une fonctionnalité obligatoire qui est automatiquement configurée lors de la première installation à l’aide de l’assistant d’installation. Cependant, si vous configurez l’application en fonction de vos besoins, il est nécessaire d’examiner de plus près la configuration du service Anveo Delta.
Que fait le service Anveo Delta ?
Afin d’offrir à l’utilisateur une synchronisation rapide, seules les données modifiées (le delta de données) et pas toujours toutes les données (ce que l’on appelle le full load)
sont transférées entre Dynamics et l’application mobile Anveo. À cette fin, les changements de données dans Dynamics sont déterminés à la volée par le service Anveo Delta et mis à la disposition de l’application mobile Anveo via le service Anveo App.
À cette fin, toutes les modifications de données sont périodiquement transférées de Dynamics au service Anveo Delta afin que ce dernier puisse effectuer le calcul rapidement. Cette opération est gérée par le service de réplication Delta.
Dans le client Anveo Mobile App sur l’appareil mobile, seules les données définies par les paquets de synchronisation Anveo et la configuration du serveur Delta – voir Configuration du serveur Delta – sont disponibles.
Important ! Reconnexion après des changements de configuration
En raison de certaines limitations de Microsoft Dynamics, il est nécessaire de déconnecter et de reconnecter tous les utilisateurs après avoir effectué des changements de configuration dans l’installation du service Anveo Delta. C’est pourquoi nous recommandons d’effectuer les changements en dehors des heures de travail. Aujourd’hui, les utilisateurs mobiles ont besoin d’un temps d’arrêt pendant que les changements sont resynchronisés. Dans les prochaines versions, vous pourrez resynchroniser automatiquement les modifications la nuit sans interruption de service.
Installer l’application Anveo Sales or Service
Si vous avez installé l’application Anveo Sales ou Service en tant qu’extension, il vous sera demandé si vous souhaitez les configurer.
Anveo Sales App
Vous trouverez ici les manuels d’installation des solutions prêtes à l’emploi de l’Anveo Sales App.
Anveo Service App
Vous trouverez ici les manuels d’installation des solutions prêtes à l’emploi de l’Anveo Service App.