XPressEntry Installation et mise à niveau

1.Avant-propos #

Le but de ce document est d'expliquer les exigences d'installation, les prérequis, les étapes d'installation et de configuration, les procédures de mise à niveau et les étapes de désinstallation de votre solution logicielle.

2.Préparation de l'installation #

2.1.Exigences d'installation #

  • Programme d’installation et fichier de licence XPressEntry. Les droits d'administrateur sont requis pour l'installation.
  • Ports du pare-feu Windows 30000 / 30001 ouverts pour l’exécutable XPressEntryService. Cela est nécessaire pour que les périphériques de poche trouvent le serveur.
    • XPressEntry 2.7.X +

2.2.Pré-requis d'installation #

  • Windows 7 / Windows Server 2012 ou plus récent,> = 8 Go de RAM
  • . NET Framework 4.6.2
  • 20 Go d'espace disque disponible pour les très grandes installations.
  • Un compte de service de domaine Windows (ou utilisateur local si aucun domaine) pour le service XPressEntry. Sera défini comme le dbo.owner de la base de données XPressEntry SQL Server.
  • SQL Server ou SQL Server Express installé et disponible localement ou au sein du réseau.

3.Installation de XPressEntry #

3.1.Exécutez le programme d'installation XPressEntry MSI #

  1. Exécutez le programme d'installation XPressEntry MSI.
  2. Sélectionnez l'emplacement pour installer XPressEntry
  3.  
    installation de xpressentry
     

  4. Une fois l'installation terminée, sélectionnez Fermer.
  5.  
    installation de xpressentry terminée

3.2.Configuration du service XPressEntry #

Un compte de service Windows pour l'accès à la connexion sécurisée à la base de données SQL Server est requis.
 
REMARQUE: si le compte de service Windows qui sera utilisé N'EST PAS un administrateur sur la machine Windows, commencez par démarrer le service XPressEntry pour la première fois en tant que système local, puis arrêtez le service avant de continuer.
 

  1. Ouvrez les services Windows. Recherchez le service XPressEntry, cliquez avec le bouton droit et cliquez sur anti-taches.
  2.  
    service xpressentry
     

  3. Cliquez connecter Languette.
  4. Cliquez Ce compteet entrez les informations de compte de service de domaine Windows qui seront utilisées pour se connecter à SQL Server. Cliquez sur Appliquer.
  5.  
    propriétés du service xpressentry
     

3.3.Configurer SQL Server #

SQL Server

  1. Ouvrez SQL Server Management Studio. Connectez-vous avec un compte avec accès administrateur à la base de données.
  2.  
    Serveur SQL
     

  3. Dans la fenêtre de l'Explorateur d'objets, cliquez avec le bouton droit sur Bases de données et cliquez sur Nouvelle base de données… Nommez la base de données pour la base de données XPressEntry. Cliquez sur OK.
  4.  
    nouvelle base de données xpressentry
     

  5. Ensuite, nous devons donner au compte de service Windows dbo.owner un accès à la base de données XPressEntry nouvellement créée. Dans la fenêtre de l'Explorateur d'objets, développez Sécurité, et clic droit Logins. Cliquez Nouvelle connexion… Recherchez ou ajoutez le compte de service Windows pour le Nom de connexion.
  6.  
    connexion xpressentry
     

  7. Cliquez sur Mappage de l'utilisateur sur la gauche Sélectionnez une page fenêtre. Recherchez la base de données nouvellement créée et cochez la case Carte. Ci-dessous, dans le Appartenance au rôle de base de données, vérifier propriétaire_dbou séparément, le combinaison de db_datareader et db_datawriter. Db_owner remplace db_datareader et db_datawriter Cliquez sur OK.
  8.  
    propriétés de connexion
     

  9. Accédez à l'emplacement où XPressEntry a été installé ou recherchez dans XPressEntryDatabaseTool dans le menu Démarrer de Windows. Exécutez XPressEntryDatabaseTool.exe
  10. Tout utilisateur Windows qui accède à XPressEntryDatabaseTool aura besoin d'un accès db_owner pour exécuter les migrations de base de données. L'exécution de XPressEntryDatabaseTool en tant qu'utilisateur des fenêtres de service rationalisera le processus s'il est défini sur db_owner.
  11. Tous les utilisateurs Windows qui accéderont à l'application serveur XPressEntry auront également besoin d'un accès db_datareader et db_datawriter. Cela peut être attribué aux utilisateurs du domaine, ou explicitement aux administrateurs ou aux utilisateurs spécifiques uniquement.
  12.  
    outil de base de données xpressentry
     

  13. Ajouter la licence XPressEntry - Cliquez sur Rechercher le fichier de licence et ajoutez le fichier de licence fourni par Telaeris. En cas de succès, la page À propos de XPressEntry se fermera.
  14.  
    licence xpressentry
     

  15. Cliquez Modifier / définir la base de données
  16.  
    xpressentry définir la base de données
     

  17. Définissez les informations sur le serveur de la base de données SQL Server, puis cliquez sur Charger la base de données.
  18.  
    connexion à la base de données xpressentry
     

  19. Sélectionnez la base de données XPressEntry à laquelle vous connecter et cliquez sur Terminer.
  20.  
    xpressentry définir et connecter la base de données
     

  21. Cliquez Valider que l'utilisateur actuel est propriétaire.
  22.  
    utilisateur actuel de xpressentry
     

  23. Cliquez Exécuter la création / migration de table.
  24.  
    création d'une table d'exécution xpressentry
     

  25. La connexion à la base de données est configurée correctement lorsque la connexion à la base de données réussit, l'utilisateur actuel est db_owner et la version de la base de données est à jour.
  26. Si XPressEntryDatabaseTool s'exécute en tant qu'administrateur, vous pouvez arrêter ou démarrer le service XPressEntry. Il est normal que le service soit arrêté avec l'icône X rouge.
  27. Vérifier l'API vérifiera si la route de l'API fonctionne correctement. Cela nécessite le démarrage du service.
  28. Vérifier les autorisations de service vérifie si l'utilisateur de connexion pour le service XPressEntry dispose des autorisations de lecture et d'écriture appropriées sur la base de données XPressEntry.
  29.  
    Autorisations du service xpressentry
     
     
    administrateur xpressentry
     

3.4.Dépannage de la base de données #

  1. Vous pouvez double-cliquer sur n'importe quelle boîte d'erreur pour afficher le message complet.
  2. Si l'utilisateur Windows connecté ne dispose pas d'un accès en lecture ou en écriture à la base de données XPressEntry, le message d'erreur suivant s'affiche lors de l'ouverture ou lorsque vous cliquez sur Vérifier la connexion. Attribuez un accès en lecture et en écriture approprié à l'utilisateur Windows actuel.

 
base de données xpressentry

4.Mise à niveau de XPressEntry #

  1. Exécutez le programme d'installation XPressEntry MSI et / ou le programme d'installation spécifique du plug-in Datamanager.
  2. Sélectionnez l'emplacement pour installer XPressEntry.
  3.  
    installation de xpressentry
     

  4. Une fois l'installation terminée, sélectionnez Fermer.
  5.  
    installation de xpressentry terminée
     

  6. Accédez à l'emplacement où XPressEntry a été installé ou recherchez dans XPressEntryDatabaseTool dans le menu Démarrer de Windows. Exécutez XPressEntryDatabaseTool.exe
  7.  
    outil de base de données xpressentry
     

  8. Vérifiez la version de migration de la base de données en cliquant sur vérifier la migration. Si la version de migration doit être mise à jour vers la dernière version, sélectionnez Exécuter la création / migration de table. Si la version de migration est à jour, La version de la base de données est à jour à [VERSION].
  9.  
    création d'une table d'exécution xpressentry
     
     

    migration de vérification xpressentry
     

  10. Cliquez OK. Démarrez XPressEntryService.

5.Désinstallation de XPressEntry #

  1. Arrêtez XPressEntryService.
  2. Exécutez le programme d'installation XPressEntry MSI ou le programme d'installation du plug-in Datamanager spécifique à XPressEntry. Sélectionner Supprimer XPressEntry.
  3.  
    supprimer xpressentry
     

  4. Choisir Tous. Cliquez Suivant.
  5.  
    désinstaller xpressentry
     

Suggérer Modifier