Manuel 2 · Chapitre 11

Base de données et sauvegarde

Valable pour KoonScan version 1.1.1Télécharger ce manuel (PDF)

KoonScan conserve ses propres données (utilisateurs, travaux en cours, journal) dans sa propre base de données : par défaut un fichier de base de données par société dans C:\KoonScan\data (par exemple KScan.db), ou, si vous l'avez choisi, dans SQL Server Express (instance KSCAN). Jamais dans la base de données SAP, ni sur le SQL Server de SAP : cette licence ne couvre que SAP lui-même.

Sauvegarde : elle se fait automatiquement#

• Chaque nuit à 02:30, KoonScan effectue une sauvegarde : un fichier par jour de la semaine, donc toujours les sept derniers jours.
• Fichier de base de données : KScan_ma.db à KScan_zo.db dans C:\KoonScan\data\backup. KoonScan continue de fonctionner pendant la copie.
• SQL Server Express : KScan_ma.bak à KScan_zo.bak dans C:\Program Files\Microsoft SQL Server\MSSQL17.KSCAN\MSSQL\Backup.
• Demandez à votre prestataire informatique d'inclure ce dossier dans la sauvegarde habituelle. Conservez aussi C:\KoonScan\appsettings.Local.json et le dossier C:\KoonScan\cert dans un endroit sûr.
• Pour faire une copie vous-même : Administration → Serveur → Maintenance → Sauvegarder maintenant.
• KoonScan nettoie aussi lui-même les anciens travaux terminés (après 365 jours par défaut, voir Maintenance). Les travaux ouverts ou échoués sont toujours conservés.

Restaurer une sauvegarde (fichier de base de données)#

Uniquement si le fichier de base de données est endommagé ou perdu. Tout ce qui a été fait depuis la sauvegarde (travaux, nouveaux utilisateurs) est perdu. Sur le serveur, Terminal (Admin) :

1. Arrêtez KoonScan : Stop-Service KScan. Les scanners indiquent que KoonScan est injoignable.
2. Ouvrez C:\KoonScan\data dans l'Explorateur. Renommez KScan.db en KScan-damaged.db. Y a-t-il aussi des fichiers KScan.db-wal et KScan.db-shm ? Supprimez-les.
3. Copiez la sauvegarde du jour souhaité depuis C:\KoonScan\data\backup (par exemple KScan_di.db) vers C:\KoonScan\data et renommez-la en KScan.db.
4. Démarrez KoonScan : Start-Service KScan.
5. Connectez-vous et vérifiez que vos utilisateurs et vos travaux sont bien là.

Maintenance : taille et nettoyage#

Administration → Serveur → Maintenance affiche l'état de la base de données :

• Taille de la base de données : la taille de la base de données de KoonScan. Avec SQL Server Express, il existe une limite par base de données (50 Go avec SQL Server 2025 Express, que le programme d'installation configure ; 10 Go avec les versions plus anciennes) ; près de la limite, Administration affiche le message « La base de données est presque pleine ».
• Durée de rétention : combien de temps les travaux terminés (comptabilisés ou clôturés), le journal et les appareils déconnectés sont conservés ; chaque nuit, KoonScan nettoie ce qui est plus ancien. Touchez Modifier pour choisir de 30 à 3650 jours, ou Ne jamais nettoyer. Les travaux ouverts et échoués, les utilisateurs et les paramètres sont toujours conservés ; ce qui a été comptabilisé se trouve de toute façon dans SAP.
• Nettoyer maintenant : nettoie immédiatement au lieu de cette nuit. Le message indique combien (« Nettoyé : … travaux terminés, … lignes de journal, … appareils. »).
• Sauvegarde, Dossier et Dernière sauvegarde : voir ci-dessus. Sauvegarder maintenant fait une copie supplémentaire.

Déplacer la base de données vers KSCAN#

Nécessaire uniquement si Administration affiche le message indiquant que la base de données se trouve sur un autre SQL Server que KSCAN (par exemple le SQL Server de SAP). Pour cela, vous avez besoin de SQL Server Management Studio (gratuit chez Microsoft). En cas de doute, laissez votre prestataire informatique s'en charger.

1. Assurez-vous que SQL Server Express avec l'instance KSCAN est présent sur le serveur. Le programme d'installation ne le propose que lors d'une nouvelle installation ; ensuite, vous l'installez vous-même (annexe B).
2. Administration → Serveur → Maintenance → Sauvegarder maintenant. Retenez le nom du fichier indiqué dans le message (par exemple …\KScan_di.bak).
3. Copiez ce fichier dans C:\Program Files\Microsoft SQL Server\MSSQL17.KSCAN\MSSQL\Backup.
4. Ouvrez SQL Server Management Studio et connectez-vous à localhost\KSCAN (Windows authentication).
5. Faites un clic droit sur Databases → Restore Database… → Appareil → choisissez le fichier. Laissez le nom KScan tel quel.
6. À gauche, allez dans Files et cochez Relocate all files to folder. Cliquez sur OK.
7. Administration → Serveur → Reconfigurer et confirmez. Ensuite, sur le serveur, ouvrez le menu Démarrer → KoonScan → Configurer KoonScan : l'assistant s'ouvre avec le code de configuration déjà renseigné. Pour Base de données, choisissez SQL Server, localhost\KSCAN, Authentification Windows et le même nom (KScan) : il est indiqué « La base de données KScan existe déjà ; KoonScan la met à jour. ». Continuez jusqu'à Enregistrer et démarrer.
8. Vérifiez que vos utilisateurs et vos travaux sont toujours là. Si tout est en ordre, faites supprimer l'ancienne base de données sur le SQL Server de SAP.