titre du document - sante-ra.fr · 2019. 10. 14. · le fihier est envoyé sur la file msmq...

25
14/03/2019 Passerelle 5 – manuel d’exploitation 1 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite. PASSERELLE 5 – MANUEL D’EXPLOITATION Date Auteur Modification 14/03/2019 Quentin ELUARD Création Fiche contact SISRA Contacts technique Eluard Quentin [email protected] Assistance SISRA [email protected] Contacts projet Etablissement Contacts technique Contacts projet

Upload: others

Post on 24-Feb-2021

1 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 1 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

PASSERELLE 5 – MANUEL D’EXPLOITATION

Date Auteur Modification

14/03/2019 Quentin ELUARD Création

Fiche contact

SISRA Contacts technique Eluard Quentin [email protected]

Assistance SISRA [email protected]

Contacts projet

Etablissement Contacts technique

Contacts projet

Page 2: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 2 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Table des matières I. Introduction ..................................................................................................................................... 3

II. Fonctionnement .............................................................................................................................. 3

Flux d’alimentation ...................................................................................................................... 3

Description .............................................................................................................................. 3

Passerelle Métier ..................................................................................................................... 4

Flux de réintégration ................................................................................................................... 6

Zepra ........................................................................................................................................ 6

Annuaire .................................................................................................................................. 7

III. Surveillance ................................................................................................................................. 8

Système ....................................................................................................................................... 8

Services ........................................................................................................................................ 8

IV. Annexe ......................................................................................................................................... 9

Requêtes utiles ............................................................................................................................ 9

Lexique .............................................................................................................................................. 11

Utilisation du portail de suivi ..................................................................................................... 12

Présentation .......................................................................................................................... 12

Suivi des erreurs .................................................................................................................... 12

Recherche des messages ....................................................................................................... 14

Détails du flux ........................................................................................................................ 15

Liste des codes d’erreurs fonctionnels .................................................................................. 17

Relance d’un message ........................................................................................................... 20

Vérifications diverses ................................................................................................................ 21

J’ai l’impression que ma passerelle ne fait plus rien ............................................................. 21

Les files MSMQ ne se vident plus .......................................................................................... 21

A quoi servent les jobs SQL ? ................................................................................................. 22

Mise à jour Windows en attente, dois-je les appliquer ? ...................................................... 23

Vérification du bon fonctionnement du connecteur ............................................................ 23

Vérification de la communication avec les outils régionaux ................................................. 23

Vérification de la liaison réseau ............................................................................................ 25

Page 3: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 3 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

I. INTRODUCTION

Schéma des flux sur la passerelle :

Plateforme SISRA

SIH

Passerelle

DPI

Entrepôt documents

STIC

DPPR

Zepra

Connecteur

VPN

Envoi de notifications

Partage dossier patient

Flux d identités

Zepra entrant

Zepra IN

DMP

Optionnel

II. FONCTIONNEMENT

Flux d’alimentation

Description

Les messages générés par le connecteur sont envoyés à la passerelle via un dossier partagé

« rcvMetier » qui pointe sur l’emplacement E:\Passerelle\SIHXXX\IN\rcvMetier de la passerelle. Les

fichiers .XML envoyés sont au format IHE XDS.

Lors de l’arrivée d’un message, la passerelle récupère les messages dans le dossier partagé, les trace

en base de données, en créée une copie locale, puis lance les traitements métiers.

Après avoir vérifié l’intégrité du message, la passerelle vérifie en tout premier si le message contient

des correspondants Zepra. Si c’est le cas, on extrait les informations nécessaires et le processus

d’envoi Zepra est activé.

En parallèle (que le message contienne des correspondants ou non), la passerelle va lancer le

processus de partage de document (voir processus Métier).

Page 4: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 4 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Passerelle Métier

Arrivée d un message

Message lisible ?

Oui

Présence de correspondants

?

NonArrêt des

traitements

OuiGénération d un message Zepra

Dans tous les cas

Processus STIC

Réussite

Processus DPPR

Fin du traitement

Réussite

Arrêt des traitements

Arrêt des traitements

Echec

Echec

Fin du traitement Zepra

Figure 1 : Processus Passerelle Métier

Page 5: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 5 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Arrivée d un message dans le

process STIC

5 traits stricts présents ?

5 traits stricts conformes à la

charte ?

IPPL déjà connu ?

IPPR présent ?

Fin du processus STIC Début du processus DPPR

Oui

Fin du processus STIC Début du processus DPPR Oui

Arrêts des traitements

(suspicion de doublon en cours)

Non

Oui

Création du patient dans STIC

Acquittement création

effectuée ?

Oui

NonDifférents scénarios

selon le message d erreur

Oui

Oui

Traits dans le message identiques à ceux déjà

connus ?

Modification du patient

Arrêts des traitements

Arrêts des traitements

Non

Non

Non

Non

Figure 2 : Processus STIC

Page 6: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 6 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Début du processus DPPR

Fin du processus DPPR

Stockage du document dans l entrepôt local

Référencement du document dans le

DPPR

Invalidation du document

Message d invalidation ?

Stockage réussi ?

Oui

Non

Non

Document déjà référencé ?

Arrêts des traitements

Oui

Acquittement création

effectuée ?

Oui

NonDifférents scénarios

selon le message d erreur

Oui

Arrêts des traitements

Non

Figure 3 : Processus DPPR

Flux de réintégration

Zepra

Les messages de réintégration (ZEPRA IN) sont envoyés depuis la plateforme régionale vers la file

MSMQ reintegration2sih (ou reintegrationzepraXX) de la passerelle. Les messages sont dans un

format spécifique à SISRA, l’enveloppe de réintégration, qui contient un fichier XML IHE XDS encodé

en base64.

Page 7: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 7 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

La passerelle va récupérer les messages sur la file MSMQ les tracer en base de données pour pouvoir

faire un suivi, et désencapsuler les fichiers de l’enveloppe de réintégration. Les messages au format

XDS sont alors déposés dans le dossier E:\Passerelle\SIHXXX\Reintegration\Zepra de la passerelle.

Annuaire

L’annuaire des utilisateurs de la plateforme SISRA est mis à disposition des établissements de santé

de la région. Il est possible de configurer un export automatique vers la passerelle de l’annuaire au

format CSV.

L’export sera effectué tous les jours à 22h. Le fichier est envoyé sur la file MSMQ

reintegrationannuaire163.

Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire.

Le fichier contient les colonnes suivantes :

Colonne Description

Rpps Rpps de l'utilisateur

Adeli Adeli de l'utilisateur

IdAutre Identifiant (CPE,CPA,Autre) de l'utilisateur

Titre Titre de l'utilisateur

Nom Nom

Prenom Prénom

MailContact Adresse mail de contact

MailNotif Adresse mail de notification ZEPRA

DerniereConnexion Date de la dernière connexion au site sante-ra.fr

AccordNotif 0 = ne pas envoyer les notifications 1 = envoyer les notifications

AccordDemat 0 = le correspondant veut recevoir la version papier du document 1 = le correspondant ne veut plus recevoir les documents par courrier papier

Etat 0 (= noir) si le PS ne veut pas entendre parler de Zepra 1 (= noir) si SISRA n’a aucun mail de contact pour ce PS 2 (= rouge) si le PS ne s’est jamais connecté 3 (= jaune) si le PS utilise Zepra mais ne dématérialise pas 4 (=vert) si le PS dématérialise

Page 8: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 8 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

III. SURVEILLANCE

Système

Il est recommandé de mettre en place une surveillance du système sur le serveur passerelle.

La surveillance doit vérifier les performances de du serveur CPU et RAM. Il faut également mettre en

place un test sur l’espace disque disponible (par exemple une alerte à 20% libres restant).

Ces éléments peuvent être mis en place depuis la plateforme SISRA sous réserve que la configuration

réseau requise soit appliquée.

Services

La surveillance doit vérifier que les services suivants sont démarrés :

Adaptateur d’écouteur Net.Msmq

Adaptateur d’écouteur Net.Pipe

Adaptateur d’écouteur Net.Tcp

Service de mise en cache d’AppFabric

Message Queuing

Les services Biztalk Group

o BiztalkServerApplication

o Process

o ProcessDMP

o ProcessDPPR

o ProcessSTIC

o ProcessZEPRA

o Receive

o ReceiveSIH

o Send

o Tracking

Les services SQL Server

Sisra.Passerelle.AgentEntrepot.Relay

Page 9: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 9 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

IV. ANNEXE

Requêtes utiles

Pour connaitre le nombre de messages zepra envoyés, il faut lancer la requête suivante sur le serveur

SQL de la passerelle :

USE PasserelleTraces

select count(*) from dbo.TracesMessages where EtapeTrace

='EnvoiMessageZEPRA'

/ ! \ Attention cette requète donne le nombre de messages ZEPRA reçus par

la passerelle, mais un message peut être à destination de plusieurs

correspondants, ce qui va générer plusieurs notifications ZEPRA / ! \

Pour avoir le nombre de correspondants pour lesquels vous avez adressé des documents, c’est la

requête suivante :

USE PasserelleTraces

SELECT count(*) FROM dbo.TracesCorrespondants Ou pour avoir le détail des couples identifiant du correspondant / identifiant du document :

SELECT IdPs,IdDocument FROM dbo.TracesCorrespondants

Pour connaitre le nombre de messages de réintégration reçus sur la passerelle à destination de

l’établissement, il faut utiliser la requête suivante :

USE PasserelleTraces

select count(*) from dbo.TracesMessages where EtapeTrace

='ReceptionReintegrationZEPRA'

Stockage des fichiers

Entrepôt de documents

Tous les documents médicaux qui sont partagés avec la plateforme régionale sont stockés sur le

serveur passerelle.

Ils sont stockés à l’emplacement E:\Projets\PasserelleSISRA\Filer\ avec le système de

classement par date suivant :

E:\Projets\PasserelleSISRA\Filer\AAAA\MM\JJ\HH\mm\guidDocument

Par exemple : E:\Projets\PasserelleSISRA\Filer\2015\09\17\08\08\b3490595-d871-4a0d-9d0b-

b49c96834902

Page 10: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 10 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Sauvegarde des messages

Tous les messages qui transitent sur la passerelle sont sauvegardés sous forme de fichier .bkp (qui est

en fait un fichier .xml).

Le chemin d’accès à ces fichiers est E:\Passerelle\BackupTraces\XXX\AAAA-MM\JJ\

Ils sont ensuite classés selon les ports d’envois et de réception dans BizTalk qui correspondent à

certaines opérations métier. Ces ports respectent la nomenclature de nommage suivante :

[Sens].[Domaine].[NomduPort].[Type]

- Le sens peut être soit sp (sendport) pour port d’envoi ou rp (receiveport) pour port de

réception.

- Le domaine peut être SIH, STIC, DPPR, ZEPRA ou interne. C’est l’interface avec laquelle

BizTalk communique.

- Le nom du port est spécifique au traitement en cours sur le message.

o Par exemple les messages reçus depuis le connecteur de l’établissement seront dans

[…]rp.SIH.TraitementMetier\Entrant

o Les messages « zepra sortant » seront dans

sp.ZEPRA.EnvoiMessage_SIHXXX.MSMQ\Sortant

- Le type correspond au canal d’envoi ou de réception du message, il est optionnel.

La nomenclature de nommage des fichiers .bkp est la suivante : ippl-idocument-guidAléatoire.bkp

Tous ces messages sont également accessibles via l’interface de supervision de la passerelle.

Page 11: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 11 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Lexique

SIH Système d’information hospitalier : Applications

informatiques de l’établissement chargées de

dialoguer avec la Passerelle SISRA

Passerelle SISRA Composant logiciel facilitant la communication

avec les plateformes régionales (STIC, DPPR,

ZEPRA)

STIC Serveur télématique d’identités

communautaires. Plateforme régionale chargé

de l’affectation des IPPR.

DPPR Dossier Patient Partagé Réparti. Plateforme

régionale permettant le référencement de

documents médicaux

ZEPRA Zéro Echange Papier en Rhône Alpes.

Messagerie sécurisée d’échange de documents

entre professionnels de santé

Mode METIER Mode évolué de la Passerelle dans lequel les

actions préalables au traitement d’un message

sont effectuées par la Passerelle SISRA.

Séquenceur Composant logiciel permettant de réordonner et

traiter les messages par date de création. Le

séquenceur est aussi chargé de publier les

messages en relance en cas d’erreurs techniques

ou fonctionnelles.

Entrepôt Composant Passerelle permettant le stockage et

la restitution de documents médicaux.

Journal des évènements Console Windows permettant le suivi des

messages d’information, d’avertissement,

d’erreur ou d’audit publiés pas d’autres

applications. Le journal des évènements peut

être lancé par la commande eventvwr.

MSMQ Microsoft Message Queuing est

l’implémentation de Microsoft des files de

messages. La passerelle SISRA communique

essentiellement avec les plateformes régionales

via ce protocole.

Console d’administration BizTalk Console fournie nativement par BizTalk

permettant le suivi des différents services en

erreur ou en cours d’exécution par le serveur

BizTalk.

Page 12: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 12 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Portail de suivi Interface Web fournie par la Passerelle SISRA

permettant de suivre le traitement des messages

au sein de la Passerelle SISRA.

Utilisation du portail de suivi

Présentation

Le portail de suivi permet de connaitre l’état d’un message et son avancement dans les différents

processus Passerelle à un instant t.

Il est composé de deux interfaces :

L’interface de suivi des erreurs (écran d’accueil par défaut)

L’interface de recherche des messages

Dans le cadre d’une maintenance régulière, il est indispensable de consulter le plus souvent possible

le portail pour prendre en compte :

Le traitement des messages par la Passerelle. Pour cela rechercher tous les messages traités entre deux dates distinctes afin de comparer le nombre de messages traités avec le nombre de messages envoyés.

Les messages ayant engendrés des erreurs. Pour cela, il faut aller dans l’écran de supervision des erreurs et afficher le compte rendu sur la période désirée.

Suivi des erreurs

La rubrique « Erreurs » permet de retrouver les messages en erreur en fonction d’une période

donnée, de l’IPPL, l’IPPR etc… le résultat de la recherche liste les messages suivant un code erreur

spécifique.

En affichant le compte rendu sur une période, on obtient le graphique donnant une idée des erreurs

les plus fréquentes, ainsi que la liste des codes d’erreur qui sont survenus.

Page 13: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 13 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

En sélectionnant une des catégories sur le graphique ou dans la légende, on obtient la liste des

erreurs associées :

Il est alors possible de relancer le ou les messages correspondant à la recherche.

En cliquant sur « Détail », on peut visualiser le détail de l’erreur et le message original qui est en

erreur.

Page 14: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 14 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Recherche des messages

Le module de recherche permet de trouver par date, le ou les messages souhaités en fonction :

- De l’identifiant d’établissement ;

- Des identifiants local (IPPL), régional (IPPR) et national (INS-C) du patient ;

- Du type de transaction (création de document, de dossier, de patient…) ;

- Des interfaces impliquées dans le traitement (STIC, DPPR, ZEPRA,…) ;

- De l’identifiant local du document ;

- Du correspondant du document dans le cas d’un message ZEPRA ;

Les zones de recherche « arrivés depuis » et « jusqu’à » permettent de restreindre la recherche en

fonction de la date d’arrivée d’un message.

La liste déroulante SIH permet de sélectionner un des établissements configuré sur la Passerelle

SISRA.

La zone de texte IPPL permet d’obtenir les messages concernant un unique patient local.

La liste déroulante Transaction permet de filtrer le type de messages traités par la Passerelle.

Page 15: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 15 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

La recherche retourne la liste des messages correspondants aux critères saisis.

Dans cette liste, on a l’ID qui correspondant à l’identifiant du message interne à la passerelle. Cet

élément est cliquable et permet d’afficher le détail sur le message.

L’id flux est également un identifiant interne à la passerelle, il permet de faire le lien entre les

différents messages d’un même flux. En cliquant dessus on accède à l’écran de détail du flux (voir

partie suivante).

Les messages en erreur apparaissent en surbrillance orangée.

Détails du flux

L’Id Flux permet de visualiser chaque étape et le résultat du traitement d’un message donné.

Page 16: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 16 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Les détails du flux nous informent sur les informations générales telles que la date d’arrivée du

message ou l’identifiant local du patient concerné.

La surbrillance rouge signale une anomalie dans le traitement du message et la surbrillance verte

signale que le traitement du flux s’est bien déroulé.

Cliquer sur permet de connaître le détail de l’erreur.

La liste des étapes d’un flux (colonne Passerelle) :

Quand la flèche est entre le SIH et l’action, c’est une interaction entre l’établissement et la

passerelle.

Quand la flèche est entre l’action et un outil régional, l’interaction est alors entre la passerelle et la

plateforme SISRA.

Page 17: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 17 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Liste des codes d’erreurs fonctionnels

La liste des codes concernant l’état de chaque étape du flux :

STIC

Page 18: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 18 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

DPPR

Page 19: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 19 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Page 20: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 20 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Relance d’un message

En cas d’erreur fonctionnelle ou technique lors du traitement du message par la Passerelle SISRA,

celui peut être relancé manuellement depuis l’interface de suivi des flux.

Pour se faire, il suffit de cocher la ligne de l’Id flux correspondant et cliquer sur le bouton Générer

script de relance et exécuter :

Demander une nouvelle recherche pour visualiser le message relancé.

Page 21: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 21 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Vérifications diverses

J’ai l’impression que ma passerelle ne fait plus rien

Si vous avez l’impression que votre Passerelle ne traite plus de messages, exécutez la procédure de

diagnostic, celle vous permettra de connaitre l’état de fonctionnement de votre Passerelle.

Si l’inactivité de la Passerelle est confirmée :

- Vérifier le bon fonctionnement des files MSMQ de réception Passerelle.

- Vérifier que les Instances de l’hôte BizTalk sont en cours d’exécution.

- Si tel est le cas, redémarrer les instances de l’hôte BizTalk.

- Vérifier le bon fonctionnement des réceptions BizTalk (Files MSMQ entrante STIC et DPPR, VPN…)

Les files MSMQ ne se vident plus

BizTalk peut dans certains cas considéré son activité comme trop importante et se met

automatiquement en sommeil jusqu’à ce que la charge utilisée sur la machine redescende.

Si les files ne se vident plus, vérifiez :

- Que les emplacements de réception sont bien démarrés.

- Que BizTalk traite toujours les messages. Dans le cas contraire, redémarrer les instances d’hôte.

Il peut arriver que la communication avec les acteurs externes ne fonctionnent plus. Dans ce cas,

vérifier l’état du VPN et redémarrez-le si nécessaire.

Page 22: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 22 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

A quoi servent les jobs SQL ?

Job Description Planification

standard BizTalk

Backup BizTalk Server Backup avec full recovery des bases de

données BizTalk et d’éventuelles bases de

données tierces.

Toutes les 15

minutes

CleanupBTFExpiredEntrie

sJob_BiztalkMgmtDb

Supprime les entrée expirées des

instances et messages BTF (Biztalk

Framework).

Toute les 12 heures

DTA Purge and Archive Ce job purge le contenu de la base de

tracking (en la sauvegardant

préalablement).

MessageBox_DeadProce

ss_CleanUp_BiztalkMsgB

oxDb

Permet le loadbalancing en détectant

qu’un host ne fonctionne plus et en libérant

les processus de ce host pour qu’ils

puissent être pris par un autre host.

Toutes les minutes

MessageBox_MessageCl

eanup_BiztalkMsgBoxDb

Supprime tous les messages qui ne sont

plus utilisés par des abonnés. Ce job

permet de vider la message box des

messages qui ont été traités.

Ne pas lancer ce job manuellement et

ne pas le planifier.

Ne pas planifier car

lancé par un autre

job

MessageBox_Message_

ManageRefCountLog

_BiztalkMsgBoxDb

Ce job se charge de mettre à jour les

compteurs de référencement des

messages pour ensuite demander la purge

des messages non référencés en appelant

le job MessageBox_MessageCleanup

_BiztalkMsgBoxDb.

Toutes les minutes

MessageBox_Parts_Clea

nup_BiztalkMsgBoxDb

Supprime les parts des messages

inutilisés.

Toutes les minutes

MessageBox_UpdateStat

s_BizTalkMsgBoxDB

Mise à jour des statistiques de la base de

données BizTalkMsgBoxDB

Toutes les 5

minutes

Operations_OperateOnIns

tances_OnMaster_BizTalk

MsgBoxDb

Job utile lorsque plusieurs Message box

ont été déployées. Ce job assure

notamment les opérations de réplication

d’informations.

Toutes les minutes

PurgeSubscriptionsJob_Bi

ztalkMsgBoxDb

Purge des souscriptions inutilisées dans la

base de données.

Toutes les minutes

TrackedMessages_Copy_

BiztalkMsgBoxDb

Copie du body des messages traqués de

la message box vers la base de tracking

Toutes les minutes

Page 23: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 23 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Mise à jour Windows en attente, dois-je les appliquer ?

Demander l’autorisation à l’assistance établissement pour savoir si les mises à jour en attentes ont

bien été validées.

Vérification du bon fonctionnement du connecteur

La communication entre les SIH et les Passerelle SISRA peut être réalisée à l’aide de différents

protocoles tels que :

- MSMQ ;

- FILE ;

- SOAP ;

- HTTP.

Il est impératif de s’assurer que la Passerelle reçoit les messages émis par le ou les centres. La

majorité des connecteurs dialogue via MSQM, pour vérifier les échanges entre les Passerelle et le

SIH, ouvrez le gestionnaire de services et applications et vérifiez que les messages ne restent pas

bloqués dans les files entrantes.

Vérification de la communication avec les outils régionaux

Un message émis par un Etablissement ne peut être intégré sans que ce message ne soit référencé

au niveau régional via un échange MSMQ.

Il est impératif de s’assurer que la Passerelle reçoit les messages émis par les plateformes régionales.

Pour vérifier les échanges entre les Passerelle et le SIH, ouvrez le gestionnaire de services et

applications et vérifiez que les messages ne restent pas bloqués dans les files entrantes et dans les

files

Pour cela dans l’écran de Gestion de l’ordinateur, aller dans la section Services et applications, puis

Message Queuing.

Page 24: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 24 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Les files entrantes sont sous la section file d’attente privées :

Dppr2bn : file de réception des acquittements DPPR

Q_si : File de réception des acquittements STIC

Q_si_test : File de réception des acquittements STIC Test

Rcvinfra : File de réception pour les établissements en mode INFRA qui alimentent via MSMQ

Rcvmetier : File de réception pour les établissements en mode métier qui alimentent via

MSMQ

Reintegration* : Files de réception des messages de réintégration (ZEPRA IN et Annuaire).

Sih2zepra : File de réception des messages ZEPRA générés via l’API ZEPRA (Zepra routing)

Statistiqueszepra : File de réception des

Les files sortantes sont sous la section files d’attente sortantes. Elles sont précédées de l’ip de la

machine de destination :

BN2ZEPRA : File d’envoi des messages ZEPRA

BN2DPPR : File d’envoi des messages DPPR

Q_si_Etablissement : File d’envoi des messages STIC

StatistiquesZEPRA : File d’envoi du rapport qualité passerelle, utilisé pour générer le rapport

zepra hebdomadaire

Order_queue$ : Files créées automatiquement pour le service MSMQ dans le cas d’utilisation

de files transactionnelles. Elles permettent de s’assure que les messages ne sont pas perdus

pendant le transport via MSMQ.

Page 25: Titre du document - sante-ra.fr · 2019. 10. 14. · Le fihier est envoyé sur la file MSMQ reintegrationannuaire163. Il est ensuite déposé dans le dossier E:\Passerelle\SIHXXX\Reintegration\Annuaire

14/03/2019 Passerelle 5 – manuel d’exploitation 25 / 25 Ce document est la propriété exclusive de SISRA. Toute reproduction est interdite.

Vérification de la liaison réseau

Si vous utilisez un VPN IPSec, lancer la commande

telnet 10.200.21.101 1801

Si la fenêtre de commande se vide c’est que la connexion est effectuée et que le VPN est disponible.