Premiers pas avec Service Bus for Windows Server

  • Article

Cette section décrit l'installation locale de Service Bus pour Windows Server et la définition d'options de configuration. Une fois Service Bus pour Windows Server en cours d'exécution, vous pouvez suivre un didacticiel qui présente la création d'une file d'attente, ainsi que quelques opérations de base relatives à la messagerie. Pour commencer à développer une application, voir Didacticiel : Première application.

Installation de l'environnement de développement Service Bus

Cette section décrit les étapes de base nécessaires à l'installation de Service Bus pour Windows Server. Notez les conditions requises suivantes :

  • Toutes les instances SQL sont placées dans une instance SQL Server (2008 R2 SP1 ou SQL Express 2012) locale.

  • Le service SQL Browser doit être activé et en cours d'exécution.

  • TCP/IP doit être activé. Cela inclut la désactivation du pare-feu sur un port spécifique et l'activation des services SQL Browser.

  • Si une version antérieure de Service Bus était installée, pensez à supprimer les bases de données suivantes : SBGatewayDatabase, SBManagementDB et ServiceBusDefaultContainer.

  • Les services sont exécutés avec les informations d'identification actuelles de l'utilisateur.

  • Le script d'installation requiert un compte de domaine.

  • Service Bus utilise un certificat généré automatiquement.

Remplacez les paramètres d'entrée suivants par les valeurs de votre environnement :

  • <HostName>
    Votre nom d'hôte. N'utilisez pas localhost.
  • <Password>
    Mot de passe nécessaire à la génération des certificats. Le mot de passe doit contenir uniquement des lettres majuscules et minuscules, des chiffres et des symboles.

Installation de Service Bus

Tout d'abord, veillez à désinstaller les services Windows Fabric existants, ainsi que Service Bus. Procédez ensuite comme suit :

Utilisation d'un flux local

Notes

Cette étape est requise si vous utilisez un flux privé, tel que Microsoft Connect, ou un DVD.

Tout d'abord, veillez à désinstaller les services Windows Fabric existants, ainsi que Service Bus. Procédez ensuite comme suit :

  1. Quittez une batterie de serveurs Service Bus existante en appelant la cmdlet Remove-SBHost.

  2. Désinstallez la version précédente de Service Bus pour Windows Server, Windows Fabric, et Web Platform Installer.

  3. Supprimez les bases de données utilisées par le Service Bus.

Procédez ensuite comme suit :

  1. Installez Microsoft Web Platform Installer 4.0 depuis https://www.microsoft.com/web/downloads/platform.aspx.

  2. Démarrez Web Platform Installer.

  3. Cliquez sur Options, accédez au répertoire contenant le fichier (.xml) de flux, puis ajoutez-le.

    Notes

    Cette étape est requise si vous utilisez un flux privé, tel que Microsoft Connect, ou un DVD.

  4. Cliquez sur OK, puis sur Windows Azure Service Bus 1.0 dans le flux.

  5. Cliquez sur Installer, acceptez le CLUF, puis lancez le processus d'installation.

    Notes

    Vous serez peut-être invité à redémarrer l'ordinateur. L'installation se poursuivra après le redémarrage.

Configuration de l'environnement de développement Service Bus

Configuration de Service Bus à l'aide de l'Assistant Configuration

L'Assistant Configuration vous guide via les étapes de configuration d'une nouvelle batterie de serveurs Service Bus pour Windows Server (cluster de serveurs), d'association à une batterie de serveurs existante ou de sortie d'une batterie de serveurs. Si vous décidez de créer une batterie de serveurs, vous pouvez utiliser les paramètres par défaut ou entrer des valeurs personnalisées pour les paramètres qui identifient et configurent la batterie de serveurs en cours de création. La procédure suivante permet de créer une batterie de serveurs et de lui attribuer le serveur Service Bus pour Windows Server 1.0 à l'aide des paramètres par défaut.

Lorsque Web Platform Installer se ferme, vous pouvez démarrer l'Assistant Configuration Service Bus. Procédez comme suit :

  1. Dans le menu Démarrer, pointez sur Tous les programmes, puis cliquez sur Service Bus 1.0. Cliquez sur Configuration de Service Bus pour lancer l'Assistant Configuration Service Bus.

    Assistant Configuration de Service Bus

  2. Cliquez sur Utiliser les paramètres par défaut (recommandé). La boîte de dialogue Nouvelle configuration de batterie de serveurs apparaît.

    Assistant Configuration du bus des services

  3. Dans la zone de texte INSTANCE SQL SERVER, le nom de l’instance SQL Server sur l’ordinateur actuel s’affiche par défaut. Pour spécifier un autre serveur SQL Server, tapez le nom complet de l'instance SQL Server qui hébergera les bases de données pour la batterie de serveurs. Pour plus d'informations sur le sujet suivant la configuration requise pour SQL Server, consultez la section SQL Server dans Configuration requise. Pour vérifier que le nom d'instance entré pointe vers une instance valide, cliquez sur Tester la connexion. Si la connexion réalisée est correcte, une coche verte apparaît en regard du bouton. En cas d'erreur, un message s'affiche dans l'Assistant.

    Assistant Configuration du bus des services Le panneau d'empilement Options avancées permet de spécifier d'autres paramètres associés à la base de données, tels que le mode d'authentification SQL et l'utilisation de SSL.

  4. Sous Configurer le compte de service, votre ID d’utilisateur apparaît dans la zone de texte ID D’UTILISATEUR pour identifier le compte d’utilisateur sous lequel les services sont exécutés. Pour modifier l’ID d’utilisateur associé au compte d’utilisateur, entrez un nouvel ID d’utilisateur dans la zone de texte ID D’UTILISATEUR. L'identifiant utilisateur doit être au format nom_utilisateur@nom_domaine ou domaine\utilisateur. Entrez ensuite le mot de passe pour cet ID d’utilisateur dans la zone de texte MOT DE PASSE. L'Assistant valide la combinaison identifiant utilisateur/mot de passe et, en cas d'erreur, vous indique d'entrer à nouveau l'identifiant utilisateur et le mot de passe. Les mêmes informations d'identification de l'utilisateur sont utilisées pour les services Service Bus pour Windows Server 1.0 et Windows Azure Service Bus.

  5. Sous Clé de génération de certificat, entrez une clé dans la première zone de texte, puis entrez-la à nouveau dans la zone de texte sous CONFIRMER LA CLÉ DE GÉNÉRATION DE CERTIFICAT pour confirmer la première clé entrée. L’Assistant vérifie que les clés correspondent. Si les clés ne correspondent pas, l'Assistant vous indique de les entrer à nouveau. Enregistrez la clé pour une utilisation ultérieure. Vous devrez l'indiquer à chaque fois que vous ajoutez un ordinateur à cette batterie de serveurs. La cmdlet de configuration utilise cette clé pour générer les certificats. Vous pouvez spécifier un certificat personnalisé avec l'option des paramètres personnalisés.

  6. La case à cocher Activer les règles de pare-feu sur cet ordinateur permet d'indiquer si vous souhaitez autoriser l'Assistant Configuration à créer des règles de pare-feu. Désactivez cette case à cocher uniquement si les clients Service Bus (votre application) sont exécutés sur le même serveur que Service Bus.

  7. Cliquez sur Suivant. L’Assistant affiche l’écran Résumé qui répertorie les valeurs que vous avez entrées, ainsi que les valeurs par défaut pour les options de configuration restantes. L'écran affiche également les options et valeurs de configuration de la batterie de serveurs dans son ensemble et pour Service Bus pour Windows Server 1.0 individuellement. L'Assistant valide également le fait que les valeurs de configuration sont valides pour cet ordinateur. En cas d'erreur, l'Assistant affiche la page concernée et ne vous permet pas de continuer. Vous pouvez revenir en arrière pour modifier la configuration à l’origine de l’erreur ou, si possible, résoudre l’erreur en dehors de l’Assistant.

    Pour certaines erreurs, il est possible que vous ne puissiez pas continuer avec la configuration par défaut. Par exemple, si le port par défaut utilisé pour la gestion de Service Bus pour Windows Server 1.0 est bloqué par une application, il est possible que vous ne puissiez pas le débloquer. S'il est impossible de continuer avec la configuration par défaut, vous devez créer la batterie de serveurs avec les paramètres personnalisés.

    Assistant Configuration du bus des services

    Conseil

    S'il existe des erreurs que vous pouvez corriger hors de l'Assistant, vous pouvez utiliser le bouton Revalider pour valider la configuration.

    Conseil

    Si vous souhaitez effectuer la configuration à l'aide de PowerShell, vous pouvez générer le script en fonction de la configuration actuelle de cette page en cliquant sur le lien Commandes PowerShell.

  8. Cliquez sur Appliquer pour approuver les options répertoriées, pour créer la batterie de serveurs et pour ajouter le serveur à celle-ci. Cliquez sur Précédent pour revenir à la page Nouvelle configuration de batterie de serveurs et modifier les entrées que vous avez effectuées.

Configuration de Service Bus à l'aide de PowerShell

La première étape consiste à choisir un mot de passe à utiliser durant la génération du certificat. Notez que ces étapes doivent être exécutées dans une fenêtre de commande Service Bus PowerShell. Créez une chaîne sécurisée avec votre mot de passe.

  1. Choisissez le mot de passe à utiliser lors de la génération du certificat. Émettez la commande suivante :

    $mycert=ConvertTo-SecureString -string <Password> -force -AsPlainText

  2. Créez une batterie de serveurs :

    New-SBFarm –SBFarmDBConnectionString "data source=localhost\sqlexpress;integrated security=true" –CertificateAutoGenerationKey $mycert

  3. Ajoutez un hôte à la batterie de serveurs

    Add-SBHost -CertificateAutoGenerationKey $mycert -SBFarmDBConnectionString "data source=localhost\sqlexpress; integrated security=true"

    Notes

    Vous serez invité à saisir votre mot de passe.

  4. Vérifiez l'état de la batterie de serveurs

    Get-SBFarmStatus

    Le résultat attendu doit ressembler à ce qui suit :

    HostName      ProcessName               Status
--------      -----------               ------
...      Service Bus Gateway            Running
...      Service Bus Message Broker     Running
...      FabricHostSvc                  Running

  5. Créez le premier espace de noms de service

    New-SBNamespace –Name DemoSB –ManageUsers  yourDomain\yourUsername

    Le résultat attendu doit ressembler à ce qui suit :

    Name                  : <Namespace Name>
AddressingScheme      : Path
CreatedTime           : 5/1/2012 5:30:49 PM
IssuerName            : <Namespace Name>
IssuerUri             : <Namespace Name>
ManageUsers           : {<domain\user>}
Uri                   :
ServiceIdentifier     :
PrimarySymmetricKey   : <GUID>
SecondarySymmetricKey :

Si vous devez réinitialiser la clé générée automatiquement, émettez la commande PowerShell suivante :

Set-SBCertificateAutoGenerationKey –SBFarmDBConnectionString "data source=<hostname>\sqlexpress;integrated security=true"

Voir aussi

Autres ressources

Didacticiel : Première application
Installation et configuration de Service Bus for Windows Server

Date de génération :

2013-07-25