PROJET KAS-STORE DEMARRAGE AVANCE. KS-DEMARAV Version /02/ Validé. KS-DEMARAV - Version /02/2010 Validé Page 1 / 17

Transcription

1 KS-DEMARAV - Version /02/2010 Validé Page 1 / 17 PROJET KAS-STORE DEMARRAGE AVANCE KS-DEMARAV Version /02/ Validé Destinataire(s) Emetteur(s) Auteur(s) Vérificateur(s) Approbateur(s) Tout Public Service R&D

2 KS-DEMARAV - Version /02/2010 Validé Page 2 / 17 PREFACE Ce document est un guide de démarrage avancé pour l'utilisation de KasStore. HISTORIQUE DE MODIFICATIONS DU DOCUMENT Version Date Etat Description de la modification / Auteur(s) REFERENCES DOCUMENTAIRES ID Référence du document Auteur(s) Date

3 KS-DEMARAV - Version /02/2010 Validé Page 3 / 17 TABLE DES MATIERES 1INTRODUCTION...4 2L'ENVIRONNEMENT DE PRODUCTION OBJECTIFS REALISATION...4 3SYSTEME MULTI CAISSES OBJECTIFS REALISATION...9 4CONCLUSION...16

4 KS-DEMARAV - Version /02/2010 Validé Page 4 / 17 1 INTRODUCTION Ce document viens à la suite du document de démarrage où après avoir traité du fonctionnel nous allons maintenant nous intéresser au matériel. De la même manière ce document est structuré suivant le processus d'évaluation et de décision suivant : 1. Est ce que KasStore peut s'intégrer dans mon environnement? Ou comment monter un environnement mono-caisse d'évaluation ou de production. N'ayons peur de rien : périphériques, performances Est ce que KasStore peux s'intégrer dans mon système d'information? Ou comment monter un environnement multi-caisses. On rajoute une caisse, une caissière et on simule un environnement réel... 2 L'ENVIRONNEMENT DE PRODUCTION 2.1 OBJECTIFS Si vous en êtes arrivé à cette étape il semblerait que le produit vous intéresse, qu'il couvre tout ou partie du fonctionnel attendu et qu'il ne vous a pas échappé que pour un système d'encaissement les étapes précédentes manque cruellement de tickets physiques et de beep scanner. Les objectifs de cette troisième étape sont ambitieux : utilisation d'un système de production java / Mysql ; intégration des périphériques ; 2.2 REALISATION Installation d'un système de production avec Mysql Les étapes précédentes étaient surtout axées sur le fonctionnel et nous n'avons pas été très prolixe

5 KS-DEMARAV - Version /02/2010 Validé Page 5 / 17 quand à l'environnement. Sans encore trop entrer dans les détails, ces étapes se sont déroulées en dehors de toute considération de performance et d'intégration en utilisant une base java intégrée (derby) et un jeu de donnée de test très restreint. Comme le but est maintenant d'intégrer KasStore dans un environnement de type production nous allons passer avec une base de donnée un peu plus robuste et capable de supporter les nombreuses sollicitations des applications. Nous avons retenu une des bases opensource les plus répandue et assez performante : Mysql. Toujours en restant dans l'optique d'une évaluation du produit, vous n'aurez pas à installer Mysql, la base sera démarrée depuis le répertoire où vous avez décompressé KasStore ou depuis votre clé USB. Les étapes sont les suivantes : 1. Installez KasStore dans votre environnement de production : transférer l'archive téléchargée vers l'environnement cible puis procédez à son extraction comme spécifié dans la première étape ou alors branchez votre clé USB sur l'environnement cible ; 2. Dans le répertoire KasStore\bin lancez le programme KSD-MYSQL-START.bat. Attention si une base mysql est déjà installée sur votre environnement cible, arrêtez le service mysql afin de libérer le port 3306 utilisé pour la communication. Iconisez la fenêtre de commande qui s'est ouverte. 3. Paramétrez les connections des modules : 1. éditer le fichier conf\ks_conf.xml, changer les logins vers une base mysql en modifiant les sections suivantes <Server> : <LoginId>10</LoginId> deviens <LoginId>1</LoginId> <Supervisor> : <LoginId>10</LoginId> deviens <LoginId>3</LoginId> <Pos> : <LoginId>11</LoginId> deviens <LoginId>2</LoginId> <IntegratorAgent> : <LoginId>10</LoginId> deviens <LoginId>1</LoginId> 4. Testez les connexions : démarrez les modules KS-POS.bat, KS-SERVER.bat et KS_SUPERVISOR.bat et vérifiez que ces derniers fonctionnent correctement avec le nouveau paramétrage ; Remarque : Utilisant une communication inter socket avec Mysql, vous pouvez maintenant lancer tous les modules simultanément. Intégration des périphériques Sans faire preuve de pessimisme, c'est en général à ce niveau que les ennuis commencent et que la théorie se confronte à la dure réalité de la pratique.

6 KS-DEMARAV - Version /02/2010 Validé Page 6 / 17 La théorie est on ne peux plus séduisante car depuis quelques années la norme UPOS : OPOS (environnement C/C++...) / JAVAPOS (environnement java) rend l'utilisation des imprimantes, scanners, tiroirs enfin bref de tous les périphériques utilisés dans l'encaissement, complètement transparente pour les éditeurs et les intégrateurs. Dans ce monde merveilleux les fournisseurs de Hardware donnent gracieusement les drivers UPOS correspondant à leur matériel, les éditeurs de logiciels utilisent la couche d'abstraction UPOS pour tous les accès aux périphériques et les intégrateurs ont uniquement à définir le lien existant entre la représentation logique des périphériques (utilisé par les applicatifs) et leurs accès physique (délégation des accès UPOS vers les drivers). La réalité est quelque peu différente car ce petit monde n'est hélas pas parfait, les mauvaises nouvelles étant : que l'abstraction ainsi définie ne dispense en aucun cas d'une connaissance fonctionnelle et pratique des périphériques et de leur utilisation, que les briques (librairies) utilisées par les différents fournisseurs pour écrire les drivers sont parfois incompatibles les unes avec les autres, que la couverture fonctionnelle UPOS réelle implémentée dans les drivers est aussi diverse que varié, qu'il en est de même quand à l'utilisation des UPOS dans les applicatifs, que le réglage de la zone de subduction entre les périphériques et les applicatifs est bien souvent à la charge de l'intégrateur, J'espère ne pas avoir dressé un tableau trop négatif de ce qui vous attend, mais le retour d'expérience montre que l'intégration hardware est souvent sous estimée alors qu'en réalité elle est rarement transparente et nécessite une connaissance spécifique du domaine. Pour ceux d'entre vous qui ne sont pas démoralisés et qui veulent continuer l'aventure voici donc la liste des étapes à respecter pour l'intégration des périphériques : 1. Sous le répertoire KasStore\bin lancez le module de supervision KS-SUPERVISOR.bat 2. Après avoir validé l'identification allez dans le paramétrages des magasins puis lancez la gestion des caisses. La fenêtre de recherche multi critère apparaît. Cliquez que le bouton Rechercher, la liste des caisses définies pour le magasin apparaît.

7 KS-DEMARAV - Version /02/2010 Validé Page 7 / Sélectionnez la caisse 1 puis cliquez sur Modifiez la fenêtre d'édition permettant de paramétrer la caisse s'ouvre. Cliquez sur l'onglet «Periphériques» pour accéder à la gestion des périphériques rattachés à cette caisse. Par défaut la majeur partie des périphériques gérés par KasStore sont rattachés à la caisse 1, deux types sont à distinguer : les périphériques virtuels intégrés dans l'application (ex:imprimante ticket de l'interface), les périphériques physiques rattachés à la caisse. Les périphériques virtuels sont préfixés par 'EMBEDDED'.

8 KS-DEMARAV - Version /02/2010 Validé Page 8 / Supprimez les périphériques physiques en ne laissant que ceux qui sont connectés à votre caisse, notez les noms internes de la colonne déclaration. Ces noms serviront à la déclaration que vous aurez à réaliser au niveau de UPOS. 5. Cliquez sur Enregistrer pour valider vos modifications, puis sur Liste pour revenir à la liste des caisses. De la même manière que pour les produits vous allez maintenant devoir mettre à jour la base de donnée de votre caisse en cliquant sur le bouton. 6. Vous avez achevé la déclaration des périphériques au niveau de KasStore, vous allez maintenant procéder au paramétrage des UPOS. Le paramétrage est réalisé via un fichier de configuration xml : Jpos.xml. Un fichier d'exemple vous est donné dans le répertoire KasStore\conf. Le classpath définis dans le.bat de lancement de la caisse pointe vers ce fichier, vous n'aurez donc de paramétrage spécifique à réaliser au niveau du système. 7. Editez le fichier jpos.xml et déclarez chacun des périphériques que vous avez déclaré dans KasStore. Utilisez les noms logiques que vous avez noté dans l'étape précédente. En fonction de l'environnement cible n'hésitez pas à utiliser les modules de tests d'accès aux périphériques fournis par les constructeurs. 8. Editer le fichier KasStore\bin\KS-POS.bat, mettez le bon chemin dans la ligne en commentaire contenant le chemin vers votre implémentation des UPOS (PATH_TO_UPOS_LIB) et décommentez la ligne. 9. Si vos périphériques sont accédés via une laison série (réelle ou mappée) : 2 possibilités la première et de conserver la structure fournie telle quelle et de continuer à utiliser la machine virtuelle fournie avec KastStore : rajoutez les dll et fichiers de paramétrages sous Kastore/lib/ext et paramétrez le fichier java\jdk\jre\lib\javax.comm.properties pour déclarer le stack rs232 utilisé. la seconde est de changer le path java du pos.bat pour le faire pointer vers celui de votre caisse qui est déjà paramétré. 10. Deux format d'une bitmap d'entête ticket vous sont fournis dans le répertoire KasStore/conf. Ajuster les noms de fichiers pour ne laisser que celui que vous utiliserez en fonction des caractéristiques et des capacités de votre imprimante. 11. Démarrez le module de caisse, les périphériques s'initialisent, un compte rendu est affiché au fil de l'eau sur l'afficheur puis une synthèse des initialisations sera imprimée après votre identification.

9 KS-DEMARAV - Version /02/2010 Validé Page 9 / 17 3 SYSTEME MULTI CAISSES 3.1 OBJECTIFS Vous disposez à ce niveau d'un environnement mono-caisse, la dernière étape va vous permettre de réaliser des tests multi-caisses, multi-utilisateurs. 3.2 REALISATION Installation de la deuxième caisse et paramétrage du système Afin de simplifier la mise en œuvre et de rester dans le périmètre de ce document de démarrage, nous utiliserons la caisse utilisée dans les chapitres précédents en caisse/serveur, nous l'appellerons caisse1 et nous allons rajouter une nouvelle caisse que nous nommerons caisse CAISSE 2 : Procédez à l'installation de la caisse 2 de la même manière que pour la caisse 1 1. transférer l'archive téléchargée vers l'environnement cible puis procédez à son extraction comme spécifié dans la première étape (disque, clé USB...) ; 2. Dans le répertoire KasStore\bin lancez le programme KSD-MYSQL-START.bat. Attention si une base mysql est déjà installée sur votre environnement cible, arrêtez le service mysql afin de libérer le port 3306 utilisé pour la communication. Iconisez la fenêtre de commande qui s'est ouverte. 3. Paramétrez la connexion du module caisse : éditer le fichier conf\ks_conf.xml, paramétrer le login de la section <Pos> : <LoginId>11</LoginId> deviens <LoginId>2</LoginId>, modifiez également le numéro de caisse : <PosNumber>1</PosNumber> deviens <PosNumber>2</PosNumber>. 4. Partagez les répertoires accédés par le serveur, dans le répertoire KasStore\bin lancez KSD-SHARDIR.bat. Ce script basique est basé sur une configuration système standard. Vous pouvez le modifier en fonction de votre contexte ou réaliser les partages manuellement : KasStore\data\journals doit être partagé en lecture/écriture sous le nom journals

10 KS-DEMARAV - Version /02/2010 Validé Page 10 / 17 KasStore\data\transactions doit être partagé en lecture/écriture sous le nom transactions 2. CAISSE 1 : Déclarez la caisse 2 sur le serveur : 1. Sous le répertoire KasStore\bin de la caisse 1 lancez le module de supervision KS- SUPERVISOR.bat 2. Après avoir validé l'identification allez dans le paramétrages des magasins puis lancez la gestion des caisses. La fenêtre de recherche multi critère apparaît, éditez la caisse 1 puis cliquez sur le bouton de duplication puis validez la demande de confirmation. 3. Revenez dans la liste rafraichissez les données en cliquant sur Rechercher puis éditez la caisse Changez le numéro de caisse en mettant le chiffre 2 dans la zone de saisi, cliquez sur Enregistrer puis validez la demande d'enregistrement. 3. Mettre à jour les liens réseaux pour les différents éléments : 1. toujours en restant dans le module Supervisor revenez à la racine avec la flèche rouge, descendre dans le module de paramétrage système puis sélectionnez le module

11 KS-DEMARAV - Version /02/2010 Validé Page 11 / 17 réseau. Dans la fenêtre de recherche cliquez sur Rechercher la liste des liens réseaux apparaît; 2. nous allons commencer par créer un nouveau lien pour le serveur, dans la liste éditez le lien dans le type destination est NxpStore. 3. Cliquez sur le bouton de duplication puis revenez sur la liste et rafraîchissez là. La nouvelle entrée apparaît en bas de la liste. 4. Editez là, modifiez le champ «Paramètres Lien» avec l'adresse ip et le nom réseau de votre caisse/serveur 1, changez le type en standard puis cliquez sur Enregistrer. Ex pour une machine CAISSE1 avec une adresse IP de : <HostName>CAISSE1</HostName><IpAddress> </IpAddress>

12 KS-DEMARAV - Version /02/2010 Validé Page 12 / procédez de même pour la connexion de la nouvelle caisse. Pour ce faire nous allons dupliquer et modifier celle de la caisse 1. Editez le lien dont le type destination est NxpPos. 6. Editez là, modifiez le champ «Paramètres Lien» avec l'adresse ip et le nom réseau de votre caisse 2, changez le type en standard, l'identifiant cible avec le numéro de caisse : 2, puis cliquez sur Enregistrer. Ex pour une machine CAISSE2 avec une adresse IP de : <HostName>CAISSE2</HostName><IpAddress> </IpAddress>. Modifiez et contrôlez la connexion vers la base de donnée, mettre jdbc:mysql://caisse2/posn dans le champ Url de la connexion où caisse2 est le nom réseau de votre caisse2 (le nom doit être pingeable). Cliquer sur pour tester la validité de la connexion.

13 KS-DEMARAV - Version /02/2010 Validé Page 13 / Synchronisez les référentiels caisses : cliquez sur le bouton. La caisse 2 et les liens réseaux entre les deux éléments sont maintenant déclarés dans le système. 5. Sous le répertoire KasStore\bin de la caisse 1 lancez le module d'intégration KS- INTEGRATOR.bat, réduisez la fenêtre d'exécution. Mise en œuvre 1. CAISSE 2 : Sous le répertoire KasStore\bin de la caisse 2 lancez le module d'encaissement KS-POS.bat 1. Identifiez vous avec le code caissière 2 et le mot de passe Réalisez une vente du produit 1 avec paiement en espèces.

14 KS-DEMARAV - Version /02/2010 Validé Page 14 / CAISSE 1 : Sous le répertoire KasStore\bin de la caisse 1 lancez le module d'encaissement KS-POS.bat 1. Identifiez vous avec le code caissière 1 et le mot de passe Réalisez une vente du produit 2 (300g) avec paiment en CB.

15 KS-DEMARAV - Version /02/2010 Validé Page 15 / CAISSE 1 : Sous le répertoire KasStore\bin de la caisse 1 lancez le module serveur KS- SERVER.bat 1. Identifiez vous puis allez dans le module de gestion du magasin, puis lancez le journal des transactions. 2. Dans la fenêtre multi critères cliquez sur Recherchez, la liste des transactsion s'affichent. La colonne caisse vous permet d'identifier la caisse source.

16 KS-DEMARAV - Version /02/2010 Validé Page 16 / 17

17 KS-DEMARAV - Version /02/2010 Validé Page 17 / 17 4 CONCLUSION La procédure de démarrage est maintenant achevée. Vous pouvez bien sur rajouter des caisses supplémentaires en reprenant le chapitre précédant, afin de compléter votre environnement de préproduction.