Installation de la version stub du service orienté solutions

La procédure suivante décrit la préparation de votre ordinateur avant l'installation de la version stub de la solution orientée services, puis l'installation de la solution sur votre ordinateur.

• Préparation de l'ordinateur pour l'installation de la version stub de la solution orientée services

• Installation du client IBM WebSphere MQ pour Windows

• Création des répertoires virtuels dans IIS pour la solution orientée services

• Création de la solution orientée services

• Création des entrées et valeurs de l'authentification unique de l'entreprise (SSO) dans la base de données SSO

• Déploiement de la définition BAM pour la solution orientée services

• Déployer la solution orientée services

Préparation de l'ordinateur pour l'installation de la version stub de la solution orientée services

Pour préparer l'ordinateur pour l'installation de la version stub de la solution orientée services

1. Assurez-vous que le site web par défaut est configuré pour utiliser ASP.NET 2.X.

   1. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Outils d'administration, puis cliquez sur Gestionnaire des services Internet (IIS).

   2. Dans le Gestionnaire des services Internet (IIS), le nom de l’ordinateur, développez Sites, Site web par défaut, aspnet_client, system_web.

   3. Vérifiez que le sous-dossier est 2.X.

2. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Outils d’administration, puis cliquez sur Services. À l’aide de la console Services , vérifiez que les services suivants sont en cours d’exécution :

   • Publication World Wide Web

3. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Outils d’administration, cliquez sur Console Gestion de l’ordinateur , puis ajoutez le compte de service BizTalk au groupe Administrateurs local.

4. Si vous avez installé Windows SharePoint Services, excluez la (racine) du site web par défaut de Windows SharePoint Services chemins d’accès gérés comme suit : cliquez sur Démarrer, pointez sur Tous les programmes, sur Outils d’administration, puis cliquez sur Administration centrale de SharePoint.

   1. Sous Configuration du serveur virtuel, sélectionnez Configurer les paramètres du serveur virtuel.

   2. Dans la page Liste des serveurs virtuels , cliquez sur Site web par défaut.

   3. Dans la page Paramètres du serveur virtuel , cliquez sur Définir des chemins managés.

   4. Dans la section Chemins inclus de la page Chemin d’accès managé défini , sélectionnez Racine , puis cliquez sur Supprimer les chemins sélectionnés.

   5. Ouvrez une invite de commandes, puis exécutez IISReset.

5. Fermez votre session, puis ouvrez une session sur l'ordinateur à l'aide du compte de service BizTalk.

6. Ouvrez une invite de commandes, tapez la commande suivante, puis appuyez sur ENTRÉE pour définir l'environnement %BTSSolutionsPath%. Fermez ensuite l'invite de commandes.

   • setx BTSSolutionsPath « \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Scenarios »

     Notes

     Si vous utilisez un ordinateur 64 bits, utilisez %ProgramFiles(x86)% à la place de %ProgramFiles%.

     Notes

     Pour plus d’informations sur la commande SETX, consultez le site Web Microsoft TechNet à l’adresse https://go.microsoft.com/fwlink/?LinkId=67831.

Installation du client IBM WebSphere MQ pour Windows

Pour installer le client IBM WebSphere MQ pour Windows

1. Téléchargez la dernière version du client IBM WebSphere MQ pour Windows.

   Notes

   Même si la version stub de la solution ne requiert pas IBM WebSphere Server, l'application cliente référence le fichier amqmdnet.dll fourni par le client IBM WebSphere MQ pour Windows, de sorte que vous devez installer ce dernier. Le client de la version stub n'appelle pas réellement une API dans la DLL. Il n'est requis que pour la compilation et l'exécution de l'application cliente. Vous pouvez télécharger le client IBM WebSphere MQ pour Windows depuis le site Web d'IBM.

2. Installez le client IBM WebSphere MQ pour Windows

   Notes

   Il n'est pas utile de configurer le client IBM WebSphere MQ pour Windows. Conservez les paramètres par défaut.

3. Ajoutez les classes WebSphere MQ pour l'assembly .NET au Global Assembly Cache (GAC).

   1. À l’invite de commandes Visual Studio, accédez au répertoire <Répertoire> d’installation IBM MQSeries\bin.

   2. Exécutez la commande suivante (vérifiez que gacutil.exe est inclus dans l'environnement PATH) :

      gacutil.exe /i amqmdnet.dll

Création des répertoires virtuels dans IIS pour la solution orientée services

Pour créer les répertoires virtuels dans IIS pour la solution orientée services

1. Dans le Gestionnaire des services Internet (IIS), cliquez avec le bouton droit sur Pools d’applications, sélectionnez Ajouter un pool d’applications.

   Dans la boîte de dialogue Ajouter un pool d’applications, tapez SSOStubAppPool dans la zone de texte Nom , puis cliquez sur OK.

   Les répertoires virtuels utilisés par la solution orientée services incluent le service Web publié pour la version stub des orchestrations, le service Web SAP stub, le service Web Payment Tracker stub et le service Web Pending Transaction stub.

2. Dans le Gestionnaire des services Internet (IIS), cliquez avec le bouton droit sur le pool d’applications que vous venez de créer, puis cliquez sur Paramètres avancés.

3. Cliquez dans la colonne à droite de la propriété Identity , puis cliquez sur le bouton de sélection (...).

4. Dans la boîte de dialogue Identité du pool d’applications, sélectionnez l’option Compte personnalisé , puis cliquez sur Définir.

5. Dans la boîte de dialogue Définir les informations d’identification , spécifiez un nom d’utilisateur et un mot de passe, confirmez le mot de passe, puis cliquez sur OK.

   Notes

   Cet utilisateur doit être autorisé à exécuter le service Web Orchestration Proxy et être ajouté au groupe Administrateurs BizTalk Server, Administrateurs de l'authentification unique ou Administrateurs d'applications associées à authentification unique.

6. Cliquez sur OK pour fermer la boîte de dialogue Identité du pool d’applications.

7. Cliquez sur OK pour fermer la boîte de dialogue Paramètres avancés .

8. Dans le Gestionnaire des services Internet (IIS), développez Sites web, cliquez avec le bouton droit sur site web par défaut, pointez sur Nouveau, puis cliquez sur Répertoire virtuel pour exécuter l’Assistant Création d’annuaires virtuels.

   1. À l’aide de l’Assistant Création de répertoires virtuels, créez le répertoire virtuel suivant pour le service Web proxy pour la version de l’adaptateur :

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub

      PATH = <Répertoire> d’installation bizTalk\SDK\Scenarios\SO\BTSSoln\OrchProxy\Stub

      Access Permissions = Read, Run scripts

   2. À l’aide de l’Assistant Création de répertoires virtuels, créez le répertoire virtuel suivant pour le service Web proxy pour la version de l’adaptateur :

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\SAP

      Access Permissions = Read, Run scripts

   3. À l’aide de l’Assistant Création de répertoires virtuels, créez le répertoire virtuel suivant pour le service Web proxy pour la version de l’adaptateur :

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans

      Access Permissions = Read, Run scripts

   4. À l’aide de l’Assistant Création de répertoires virtuels, créez le répertoire virtuel suivant pour le service Web proxy pour la version de l’adaptateur :

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PaymentTrack

      Access Permissions = Read, Run scripts

9. Dans le Gestionnaire des services Internet (IIS), développez Sites web, site web par défaut, cliquez avec le bouton droit sur Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub, cliquez sur Propriétés, puis modifiez les paramètres comme suit :

   1. Sous l’onglet Répertoire virtuel , définissez le pool d’applications sur SSOStubAppPool que vous venez de créer.

   2. Cliquez sur l’onglet Sécurité de l’annuaire , cliquez sur Modifier dans la zone Authentification et groupe de contrôle d’accès , sélectionnez Uniquement l’authentification Windows intégrée activée, puis désactivez les autres cases à cocher Accès à l’authentification . Cliquez sur OK pour quitter.

10. Dans le Gestionnaire des services Internet (IIS), développez Sites web, site web par défaut, cliquez avec le bouton droit sur Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP, cliquez sur Propriétés, puis modifiez les paramètres comme suit :

    1. Sous l’onglet Répertoire virtuel , définissez le pool d’applications sur SSOStubAppPool que vous venez de créer.

    2. Cliquez sur l’onglet Sécurité de l’annuaire , cliquez sur Modifier dans la zone Authentification et groupe de contrôle d’accès , puis sélectionnez Activer l’accès anonyme. Cliquez sur OK pour quitter.

11. Dans le Gestionnaire des services Internet (IIS), développez Sites web, site web par défaut, cliquez avec le bouton droit sur Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions, cliquez sur Propriétés, puis modifiez les paramètres comme suit :

    1. Sous l’onglet Répertoire virtuel , définissez le pool d’applications sur SSOStubAppPool que vous venez de créer.

    2. Cliquez sur l’onglet Sécurité de l’annuaire , cliquez sur Modifier dans la zone Authentification et groupe de contrôle d’accès , puis sélectionnez Activer l’accès anonyme. Cliquez sur OK pour quitter.

12. Dans le Gestionnaire des services Internet (IIS), développez Sites web, site web par défaut, cliquez avec le bouton droit sur Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker, cliquez sur Propriétés, puis modifiez les paramètres comme suit :

    1. Sous l’onglet Répertoire virtuel , définissez le pool d’applications sur SSOStubAppPool que vous venez de créer.

    2. Cliquez sur l’onglet Sécurité de l’annuaire , cliquez sur Modifier dans la zone Authentification et groupe de contrôle d’accès , puis sélectionnez Activer l’accès anonyme. Cliquez sur OK pour quitter.

Création de la solution orientée services

Pour générer la solution orientée services

1. Démarrez l’invite de commandes Visual Studio.

   Notes

   Dans les fichiers %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Inline\app_code\customerserviceport.asmx.cs et %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Stub\app_code\customerserviceport.asmx.cs, remplacez toutes les instances de 17f20caea2afcc8c par a1054514fc67bded.

2. À l'invite de commandes Visual Studio, accédez au dossier %BTSSolutionsPath%\SO\BTSSoln, puis exécutez la commande suivante pour générer la version stub de la solution orientée services.

   • SetupBTSSoln.bat

   Notes

   Dans les fichiers répertoriés ci-dessous, remplacez toutes les instances de 17f20caea2afcc8c par le jeton de clé publique actuel.

   • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_CustomerServiceResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_ErrorResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CreditLimitResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CustomerServiceResponseDenied.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_LastPaymentResponseTimeout.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_PendingTransactionResponse.btm.cs

Création des entrées et valeurs de l'authentification unique de l'entreprise (SSO) dans la base de données SSO

Pour créer les entrées et valeurs de l'authentification unique de l'entreprise (SSO) dans la base de données SSO

1. Ouvrez une invite de commandes, accédez au répertoire %BTSSolutionsPath%\SO\BTSSoln\Scripts, puis exécutez les commandes suivantes pour définir l'environnement PATH pour le dossier Authentification unique de l'entreprise.

   • Set PATH=%PATH%;%ProgramFiles%\"Common Files\Enterprise Single Sign-On"

2. À l'invite de commandes, accédez au répertoire %BTSSolutionsPath%\SO\BTSSoln\Scripts, ouvrez le fichier ConfigStoreApp.xml à l'aide du Bloc-notes, puis examinez le contenu du fichier.

   Notes

   Ce fichier définit l'application de magasin de configuration dans SSO que le scénario utilise pour stocker les paramètres de configuration. Certains paramètres de configuration incluent la valeur Délai d’expiration utilisée pour communiquer avec SAP (pour les trois versions). Il n'est pas nécessaire de modifier ce fichier.

3. À l'invite de commandes, exécutez la commande suivante pour créer l'application de magasin de configuration SSO.

   • ssomanage -createapps ConfigStoreApp.xml

4. À l'invite de commandes, ouvrez SetConfigValuesInSSO.cmd à l'aide du Bloc-notes, puis examinez le contenu du fichier.

   Notes

   Ce fichier de commandes définit les valeurs des paramètres de configuration dans la base de données SSO. Il contient plusieurs instructions Set qui définissent les valeurs dans les variables locales au début du fichier de commandes. Les valeurs SAPAdapterTimeout, PendingTransactionsAdapterTimeout et PaymentTrackingAdapterTimeout sont utilisées dans le stub et la version de l’adaptateur. Les valeurs restantes sont utilisées dans la version Inline. Il n'est pas nécessaire de modifier ce fichier pour la version stub.

5. À l’invite de commandes, tapez SetConfigValuesInSSO.cmd, puis appuyez sur ENTRÉE pour stocker les valeurs dans l’application du magasin de configuration de l’authentification unique.

6. À l'invite de commandes, exécutez la commande suivante pour activer les tickets dans SSO :

   • ssomanage -tickets yes yes

Déploiement de la définition BAM pour la solution orientée services

Pour déployer la définition BAM pour la solution orientée services

1. À une invite de commandes, tapez la commande suivante, puis appuyez sur ENTRÉE. Cela permet de définir le chemin d'accès de l'utilitaire BAM :

   • SET PATH=%PATH% ;%programfiles%\Microsoft BizTalk Server\Tracking

2. À l’invite de commandes, remplacez le répertoire par le dossier %BTSSolutionsPath%\SO\BTSSoln\BAM, tapez la commande suivante, puis appuyez sur ENTRÉE :

   • bm deploy-all -DefinitionFile:ServiceLevelTracking.xml

     Notes

     Sur les systèmes qui prennent en charge le contrôle de compte d'utilisateur, vous devrez peut-être exécuter l'outil avec des privilèges d'administrateur.

Déploiement de la solution orientée services

Pour déployer la solution orientée service

1. Ouvrez une invite de commandes, puis accédez au dossier %BTSSolutionsPath%\SO\BTSSoln\Scripts.

2. Modifiez le fichier DeployStubBinding.cmd en remplaçant toutes les instances de « debug » et « development » par « release ».

3. Ouvrez une invite de commandes, puis accédez au dossier %BTSSolutionsPath%\SO\BTSSoln\Scripts. Tapez la commande suivante et appuyez sur ENTRÉE :

   • DeployStubBinding.cmd

4. À l'invite de commandes, exécutez la commande suivante pour démarrer les orchestrations de la version stub.

   • Startstub.vbs

Étapes suivantes

Vous testez le fonctionnement de la version stub de la solution orientée service dans Comment exécuter la solution orientée service.

Voir aussi

Avant d’installer la solution orientée serviceComment installer les versions inline et adapter de la configuration de l’ordinateur de développement de solution orientée servicepour la solution orientée service