Configurer les adaptateurs FileAct et InterAct

Article
10/14/2023

Configurez les différents artefacts utilisés par le runtime d’adaptateurs BizTalk FileAct et InterAct.

Prérequis

Installer les adaptateurs FileAct et InterAct BizTalk
Connectez-vous en tant que membre du groupe Administrateurs BizTalk Server
Vérifier que SQL Server est en cours d’exécution

Étape 1 : Configurer l’adaptateur FileAct et InterAct

Dans l’Assistant Microsoft BizTalk FileAct et Configuration de l’adaptateur InterAct , accédez à Vue d’ensemble. Dans le volet gauche, sélectionnez Runtime pour configurer les composants runtime des adaptateurs.
Dans Configuration du runtime, sous Compte, sélectionnez les points de suspension [...] pour entrer la configuration COM plus pour le mode Store et Forward.
Dans Informations d’identification de l’utilisateur, entrez le nom d’utilisateur (au format domaine\nom d’utilisateur ) et le mot de passe du compte utilisé dans la configuration COM plus. Sélectionnez OK.

Notes

Un avertissement informations d’identification utilisateur s’affiche si le compte que vous avez entré dispose de privilèges plus élevés que ceux recommandés. Cliquez sur Oui pour continuer.
Sélectionnez Appliquer la configuration pour appliquer la configuration COM plus à l’adaptateur FileAct et InterAct.
Dans résumé, passez en revue, puis sélectionnez Suivant.
Une fois la configuration terminée, passez en revue la liste des composants. Une marque case activée signifie que le composant est correctement configuré. Un « X » signifie qu’il existe un problème avec ce composant.

Notes

Utilisez le lien Fichier journal pour afficher les événements de configuration.
Sélectionnez Terminer pour terminer la configuration. La vue d’ensemble présente les status de configuration actuelles pour les composants runtime.

Ensuite, créez l’hôte et les instances d’hôte pour exécuter ces adaptateurs.

Étape 2 : Créer l’hôte et les instances d’hôte

Nous vous recommandons de créer un hôte dédié pour l’adaptateur FileAct et un hôte dédié distinct pour l’adaptateur InterAct. Pour chaque adaptateur, créez au moins un instance hôte.

La gestion des hôtes BizTalk et des instances d’hôte répertorie les étapes de création d’hôtes et d’instances d’hôtes.

Une fois créé, l’étape suivante consiste à ajouter le gestionnaire d’envoi et à utiliser le partenaire de message client que vous avez créé dans SWIFT Alliance Gateway (SAG).

Étape 3 : Créer le gestionnaire d’envoi

Vous utilisez les propriétés du gestionnaire d’envoi FileAct et InterAct comme valeurs de configuration du port d’envoi, si les propriétés ne sont pas définies sur le port d’envoi FileAct ou InterAct individuel.

Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Paramètres de plateforme, puis Adaptateurs.
Sélectionnez l’adaptateur FileAct ou InterAct . Dans le volet droit, double-cliquez sur le gestionnaire d’envoi.
Dans la liste déroulante Nom d’hôte , sélectionnez l’hôte que vous avez créé dans la section précédente. Sélectionnez ensuite Propriétés.
Dans propriétés du transport, sélectionnez la propriété Argument , puis entrez l’argument suivant comme suit :

-SagMessagePartner <Client Message Partner created in SAG\>

Notes

Remplacez par <Client Message Partner created in SAG> le nom du partenaire de message client. Conservez les valeurs par défaut pour les propriétés Crypto Mode, FACrypto Mode et LogMessages.
Sélectionnez OK pour enregistrer vos modifications, puis pour fermer la fenêtre propriétés.
Sous Paramètres de plateforme, sélectionnez Instances d’hôte.
Redémarrez les instances d’hôte :
- Cliquez avec le bouton droit sur l’hôte FileAct instance, puis redémarrez
- Cliquez avec le bouton droit sur l’hôte InterAct instance, puis sur Redémarrer.

Ensuite, entrez les partenaires de message du serveur dans le paramfile SWIFTNet pour activer les adaptateurs de réception FileAct et InterAct.

Étape 4 : Configurer le fichier param SWIFTNet

Pour permettre aux adaptateurs de réception FileAct et InterAct de s’initialiser avec les valeurs, les partenaires de message serveur créés dans SAG doivent être entrés dans le paramfile SWIFTNet. Le paramfile se trouve généralement dans c:\SWIFTAlliance\RA\<remote access instance name\>\cfg\paramfile. Après avoir configuré le paramfile, démarrez SnlReceiver.exe.

Ouvrez le fichier de paramètres SWIFTNet. À l’emplacement marqué avec « *** », ajoutez ce qui suit. Notez que la AdapterType valeur peut être Interact ou Fileact.

spawn "snlreceiver -SagMessagePartner <Server MessagePartnerName\> -AdapterMode <AdapterType\>"
```
 username:snlowner
 subsystem_name:SampleSubsystem
 #subsystem_group: SampleSubsystem
 #subsystem_dependency:Support,Swarm
 subsystem_nature:critical
 subsystem_start:
 ***
 *END
 subsystem_stop:
 *KILL9:snlreceiver
 *END
 subsystem_status:
 *NB:1:snlreceiver
 *END
 start_event:SNL001:subsystem SampleSubsystem is up
 stop_event:SNL002:subsystem SampleSubsystem is down
```
Notes

Avant de démarrer SNLreceiver, activez les ports de réception pour l’adaptateur que vous utilisez (FileAct ou InterAct).
Démarrer et arrêter SnlReceiver.exe :
1. Sur le bureau, sélectionnez l’icône API distante pour ouvrir l’invite de commandes DE l’API distante.
2. À l’invite de commandes, tapez Swiftnet start. Sélectionnez ENTRÉE pour démarrer SnlReceiver.exe.
À l’invite de commandes, tapez Swiftnet stop. Sélectionnez ENTRÉE pour arrêter SnlReceiver.exe.

Ensuite, mettez à jour le fichier autoexec.bat pour définir les variables d’environnement SWIFT.

Étape 5 : Mettre à jour autoexec.bat pour configurer les adaptateurs de réception

Mettez à jour le fichier autoexec.bat pour définir les variables d’environnement SWIFT sur l’ordinateur sur lequel vous avez installé les adaptateurs de réception FileAct et InterAct BizTalk. Les variables d’environnement sont générées à partir du système sur lequel l’adaptateur de réception est installé dans le chemin d’accès c:\SWIFTAlliance avec un instance de l’adaptateur de réception nommé Ra1. Mettez à jour les variables d’environnement SWIFT de manière appropriée pour votre configuration.

Voici un exemple du fichier autoexe.bat :

SET COMPUTERNAME=<Machine Name>
SET GENLOG_DIR=C:\SWIFTAlliance\RA\Ra1\log
SET GENUTIL_DIR=C:\SWIFTAlliance\RA\bin
SET HOMEDRIVE=C:
SET LOGONSERVER=\\SERVERNAME
SET OSA_DIR=C:\SWIFTAlliance\RA\Ra1\log
SET OSA_INSTANCE=Ra1
SET PKIEXECDIR=C:\SWIFTAlliance\RA
SET SAGRA_HOME=C:\SWIFTAlliance\RA
SET SESSIONNAME=RDP-Tcp#1
SET SLP_ENV=DEFAULT
SET SLP_FILE=server.slp
SET SNL_DOMAIN_NAME=Ra1
SET SPK_DATA_DIR=C:\SWIFTAlliance\RA\data\pki
SET SWNET_BIN_PATH=C:\SWIFTAlliance\RA\Ra1\bin
SET SWNET_CFG_PATH=C:\SWIFTAlliance\RA\Ra1\cfg
SET SWNET_HOME=C:\SWIFTAlliance\RA
SET SWNET_HOST=HOSTNAME
SET SWNET_INST=Ra1
SET SWNET_LOG_PATH=C:\SWIFTAlliance\RA\Ra1\log
SET SWNET_SLP_PATH=C:\SWIFTAlliance\RA\data\
SET SWNET_VERSION=5.0.20
SET SWTRACE=C:\SWIFTAlliance\RA\Ra1\log
SET Path=%PATH%;C:\SWIFTAlliance\RA\bin
SET Path=%PATH%;C:\SWIFTAlliance\RA\lib

Voir quelques exemples

Pour obtenir des exemples de messages FileAct et InterAct, consultez Exemples de messages InterAct et FileAct.

Partager via