Migrer la base de données UserLock
Migrez les données UserLock vers SQLite, SQL Server ou MySQL depuis la console, sans perdre aucun événement pendant la copie.
Vous changez la base de données de production depuis la console, dans Paramètres serveur ▸ Base de données.
L’assistant de base de données copie les données UserLock de la base actuelle vers SQLite, SQL Server ou MySQL, quel que soit le fournisseur actuel. Vous pouvez par exemple passer de SQLite à SQL Server quand un essai passe en production, ou d’une instance SQL Server à une autre.
La base de données stocke les événements UserLock, comme les ouvertures de session et les changements de statut. Les stratégies d’accès, les statuts utilisateur et les paramètres serveur sont stockés par le service UserLock : la migration ne les modifie pas.
UserLock continue d’enregistrer les événements dans la base actuelle pendant la copie. À la fin de la copie, il copie aussi les événements enregistrés entre-temps, puis bascule sur la nouvelle base. Aucun événement n’est perdu.
Pour déplacer une base SQL Server avec les outils SQL Server, voir Déplacer les fichiers de la base UserLock vers un autre SQL Server.
Pour les prérequis de la base de données, voir Architecture de la base de données.
Depuis UserLock 13.1, SQLite remplace Microsoft Access comme base de données par défaut. Une base de production Access existante continue de fonctionner, mais vous ne pouvez plus sélectionner Access pour une nouvelle base de production.
Quand la base de production utilise Access, la page Base de données affiche le message Recommandé : migrer votre base de données vers SQLite. Comme Access, SQLite stocke ses données dans un fichier, mais sans limite de taille de 2 Go.
SQLite convient aux essais et aux petits déploiements. Pour la production ou de gros volumes de données, migrez plutôt vers SQL Server.
Pour migrer d’Access vers SQLite :
Dans Paramètres serveur ▸ Base de données, sous Base de données de production, cliquez sur Migrer vers SQLite. L’assistant s’ouvre à l’étape Migration, avec SQLite et le fichier de base par défaut déjà sélectionnés :
C:\ProgramData\ISDecisions\UserLock\Database\UserLock.db. Pour utiliser un autre emplacement, cliquez sur Retour.Choisissez les données à migrer, puis cliquez sur Continuer. Voir 3. Choisir les données à migrer.
Vérifiez le récapitulatif, puis cliquez sur Confirmer et appliquer. Voir 4. Confirmer et appliquer les modifications.
Continuez ensuite à l’étape 5. Suivre ou annuler la migration.
Dans la console, allez dans Paramètres serveur ▸ Base de données.
Sous Base de données de production, cliquez sur Changer la base de données de production. L’assistant s’ouvre à l’étape Fournisseur, avec le fournisseur actuel sélectionné.
Sélectionnez le fournisseur, puis cliquez sur Continuer.
SQLite convient aux essais et aux petits déploiements. SQL Server est le choix recommandé pour la production. Sélectionnez MySQL si votre organisation l’utilise déjà, ou Chaîne de connexion personnalisée pour une configuration avancée.
Aucune modification n’est appliquée avant que vous cliquiez sur Confirmer et appliquer, à la dernière étape. Si vous fermez l’assistant ou rechargez la page avant cette étape, les paramètres saisis sont perdus.
À l’étape Base de données, saisissez les informations de connexion du fournisseur sélectionné. Voir le tableau ci-dessous.
Pour SQL Server et MySQL, sélectionnez une base existante dans le champ Base de données, ou saisissez un nouveau nom. Une base existante est signalée par le badge Existant. Si aucune base ne porte ce nom, UserLock la crée après l’étape de confirmation. Pour la créer, le compte utilisé pour la connexion doit avoir le droit de créer des bases de données sur le serveur.
Cliquez sur Continuer. UserLock teste la connexion.
Fournisseur | Informations de connexion |
|---|---|
SQLite | Saisissez le chemin du fichier de base de données, ou cliquez sur Parcourir. Pour créer une nouvelle base, saisissez le chemin d’un fichier qui n’existe pas encore. |
SQL Server avec Authentification Windows | Saisissez le Serveur (nom d’hôte ou adresse IP). UserLock se connecte avec le compte défini dans Paramètres serveur ▸ Service, et non avec votre compte administrateur. Cochez Faire confiance aux certificats auto-signés du serveur si le serveur utilise un certificat auto-signé, ce qui est le cas de la plupart des instances SQL Server auto-hébergées. |
SQL Server avec Authentification SQL Server | Saisissez le Serveur (nom d’hôte ou adresse IP), puis le Nom d'utilisateur et le Mot de passe d’un compte SQL Server. |
MySQL | Saisissez le Nom d'hôte, le Port (3306 par défaut), le Nom d'utilisateur et le Mot de passe. |
Chaîne de connexion personnalisée | Sélectionnez le pilote dans la liste, puis saisissez la chaîne de connexion complète. Elle doit inclure le nom de la base et les paramètres d’authentification. |
Si vous avez conservé le fournisseur actuel, l’assistant préremplit ses informations de connexion : pour passer à une autre instance SQL Server, modifiez uniquement le champ Serveur.
À l’étape Migration, sélectionnez une option, puis cliquez sur Continuer.
Option | Données copiées | Quand l’utiliser |
|---|---|---|
Ne pas migrer les données | Aucune. UserLock utilise la base sélectionnée telle quelle : vide si elle est nouvelle, avec ses données existantes sinon. | Vous n’avez pas besoin de l’historique des événements, ou la base sélectionnée le contient déjà. |
Migrer toutes les données | Tous les événements de la base actuelle | Vous avez besoin de tout l’historique pour les rapports et les audits. |
Migrer à partir des X derniers jours | Uniquement les événements des X derniers jours. Saisissez le nombre de jours : l’assistant affiche la date de début correspondante. | La cible a une limite de taille, comme la limite de 10 Go de SQL Server Express, ou les événements plus anciens ne sont plus utiles. |
⚠️ Important
Si la base sélectionnée existe déjà (badge Existant), Migrer toutes les données et Migrer à partir des X derniers jours effacent ses tables UserLock dès le début de la migration. Annuler la migration ne les restaure pas. Pour conserver les données d’une base existante, sélectionnez Ne pas migrer les données, ou cliquez sur Retour et sélectionnez une nouvelle base.
La durée de la migration dépend du volume de données et du réseau entre le serveur UserLock et les serveurs de base de données. Migrer uniquement les X derniers jours la réduit.
Les événements non copiés restent dans la base actuelle. Vous pouvez la conserver comme archive et l’ouvrir dans les rapports en tant que base archivée. Voir Générer des rapports à partir d’une base archivée.
À l’étape Confirmation, vérifiez le fournisseur, la base de données et l’option de migration des données.
Pour une nouvelle base, un badge à côté de son nom indique que UserLock va la créer. Sans ce badge, la base existe déjà : si vous migrez des données, ses tables UserLock sont effacées. Voir 3. Choisir les données à migrer.
Cliquez sur Confirmer et appliquer. L’assistant se ferme et la migration démarre.
Pendant la migration, la page Base de données affiche Migration des données vers la nouvelle base de données..., avec la base actuelle, la nouvelle base et le nombre d’enregistrements déjà migrés.
La migration s’exécute sur le serveur UserLock. Vous pouvez fermer la console : quand vous y revenez, la page affiche toujours la migration en cours.
Les paramètres de base de données sont verrouillés pour tous les administrateurs jusqu’à la fin de la migration. La page se déverrouille ensuite automatiquement.
Pour arrêter la migration, cliquez sur Annuler la migration, sous la carte de migration (faites défiler la page si besoin).
La base de production reste la base actuelle.
L’annulation peut prendre du temps : UserLock termine l’étape de copie en cours avant de s’arrêter.
La nouvelle base n’est pas supprimée. Elle contient les enregistrements copiés avant l’annulation, elle est donc incomplète. Supprimez-la manuellement, ou sélectionnez-la à nouveau comme cible d’une nouvelle migration.
Dans Paramètres serveur ▸ Base de données, sous Base de données de production, vérifiez le Fournisseur, le nombre d’Enregistrements et la Plage de données.
Ouvrez un rapport et vérifiez qu’il affiche les sessions récentes.
Si un Accès en lecture seule est configuré, mettez-le à jour pour qu’il utilise la nouvelle base de production. Voir Paramètres serveur ▸ Base de données.
Configurez les permissions et les sauvegardes de la nouvelle base. Voir Sauvegarder les configurations et données.
Conservez l’ancienne base jusqu’à avoir vérifié la nouvelle, puis archivez-la. UserLock ne la modifie pas et ne la supprime pas.
La base de données de sauvegarde de UserLock, configurée dans Paramètres serveur ▸ Base de données, est indépendante de la base de production : la migration ne la modifie pas.
Symptôme | Solution |
|---|---|
« La connexion à la base de données n'a pas pu être établie. » après un clic sur Continuer | Cliquez sur Consultez les détails pour afficher l’erreur renvoyée par le serveur de base de données. |
L’erreur mentionne un certificat (SQL Server) | Avec Authentification Windows, cochez Faire confiance aux certificats auto-signés du serveur à l’étape Base de données. |
L’erreur mentionne des droits d’accès | Donnez au compte utilisé pour la connexion le droit de créer des bases de données, pour une nouvelle base, ou de lire, écrire et créer des tables, pour une base existante. Avec Authentification Windows, ce compte est celui défini dans Paramètres serveur ▸ Service. |
La carte de migration affiche une erreur | La base de production reste la base actuelle, et la nouvelle base, incomplète, reste en place. Lisez l’erreur, cliquez sur Ignorer les modifications pour revenir à la page Base de données, puis relancez la migration. |
La migration échoue car la base cible est pleine | Relancez avec Migrer à partir des X derniers jours, ou utilisez une cible sans cette limite de taille, par exemple SQL Server au lieu de SQL Server Express. |
Les paramètres de base de données ne peuvent pas être modifiés | Une migration est en cours : la page affiche Migration des données vers la nouvelle base de données.... Attendez la fin de la migration, ou cliquez sur Annuler la migration. |