Procédure d'installation unique pour les exemples Windows Communication Foundation

La plupart des exemples Windows Communication Foundation (WCF) sont hébergés dans les services IIS et sont exécutés à partir d'un répertoire virtuel commun. Cette procédure d'installation unique crée un dossier sur le disque et un répertoire virtuel nommé servicemodelsamples.

Le répertoire virtuel servicemodelsamples est utilisé pour générer et exécuter tous les exemples qui utilisent des services hébergés par IIS. Il s'agit du seul répertoire virtuel requis pour exécuter les exemples. Le dernier exemple généré est déployé et disponible dans ce répertoire virtuel. La génération d'un autre exemple remplace le service déployé précédemment dans ce répertoire.

Remarque :
Dans la procédure suivante, vous devez exécuter toutes les commandes sous un compte d'administrateur local. Si vous utilisez Windows Vista ou Windows Server 2008, vous devez également exécuter l'invite de commandes avec des autorisations élevées. Pour ce faire, cliquez avec le bouton droit sur l'icône de l'invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur.

Procédure d'installation unique pour les exemples WCF

1. Vérifiez que .NET Framework 3.0 est installé. Certains exemples reposent sur .NET Framework version 3.5 ; par conséquent, si vous prévoyez de les exécuter, assurez-vous que .NET Framework 3.5 est installé.

2. Assurez-vous que ASP.NET est installé. Pour plus d'informations sur l'installation de ASP.NET, consultez Instructions relatives à l'hébergement dans les Services Internet (IIS).

3. Si vous installez les services IIS après avoir installé WCF, vous devez enregistrer les mappages de scripts requis pour IIS. Si vous exécutez Windows Vista ou Windows Server 2008, vérifiez que vous avez effectué la procédure d'activation HTTP à l'étape 2. Si vous utilisez Windows XP SP2 ou Windows Server 2003, exécutez la commande suivante.

   Remarque :
   Si vous utilisez Windows Vista ou Windows Server 2008, n'exécutez pas cette commande.

   "%WINDIR%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe" -r
   

4. Si vous avez installé .NET Framework 3.5, exécutez la commande suivante.

   "%WINDIR%\Microsoft.Net\Framework\v3.5\WFServicesReg.exe" /c
   

5. Conformez-vous aux instructions figurant dans la rubrique Instructions sur les pare-feu pour activer les ports utilisés par l'exemple.

6. Téléchargez les fichiers d'installation à partir de cette page.

7. Exécutez le fichier de commandes Setupvroot.

   • Un répertoire virtuel nommé servicemodelsamples est créé.
   • Des répertoires de disque nommés %SystemDrive%\Inetpub\wwwroot\servicemodelsamples et %SystemDrive%\Inetpub\wwwroot\servicemodelsamples\bin sont créés.
   • Si vous préférez installer ces répertoires manuellement, consultez Instructions d'installation du répertoire virtuel.

   Remarque :
   Cette procédure doit être effectuée une fois seulement sur un ordinateur.

8. Vous devez accorder au compte utilisé pour générer les exemples des autorisations de modification sur le répertoire %SystemDrive%\inetpub\wwwroot. Lors de la génération, certains exemples hébergés par le Web tentent de copier les fichiers binaires compilés dans l'emplacement mentionné précédemment. Si vous n'avez pas accordé les autorisations requises, leur génération échoue. Vous pouvez également laisser les autorisations telles quelles et exécuter l'invite de commande du Kit de développement SDK ou Visual Studio en tant qu'administrateur.

   Remarque :
   Si vous ne procédez pas à cette étape, tous les exemples hébergés par IIS échouent lors de la génération. Veillez à définir les autorisations correctement ou exécutez l'invite de commandes du Kit de développement et Visual Studio en tant qu'administrateur.

9. Créez un répertoire c:\logs sur l'ordinateur lorsque vous utilisez certains exemples (comme l'exemple Extending Control Over Error Handling and Reporting) qui s'attendent à trouver ce répertoire, puis accordez au compte d'utilisateur concerné des droits d'accès en écriture à ce dernier. Pour Windows Vista et Windows Server 2008, le compte correspond à NT Authority\Network Service, et pour Windows XP et Windows Server 2003, le compte correspond à ASPNET.

10. Exécutez le fichier Setupcerttool.bat. Ce fichier se trouve dans le dossier \TechnologySamples\Setup\CS (ou \TechnologySamples\Setup\VB), dans le dossier d'installation des exemples WCF :

    • L'outil FindPrivateKey est généré.
    • Un répertoire est créé dans %ProgramFiles%\ServiceModelSampleTools.
    • FindPrivateKey est copié dans ce répertoire.

    Cet outil est requis pour les exemples qui utilisent les certificats et sont hébergés dans les services IIS.

11. Les exemples auto-hébergés (non hébergés dans IIS) doivent être autorisés à enregistrer des adresses HTTP sur l'ordinateur pour pouvoir écouter les données. Ces autorisations (qui permettent de réserver les espaces de noms HTTP) dépendent directement des autorisations dont les comptes d'utilisateurs utilisés pour exécuter ces exemples disposent. Par défaut, les comptes d'administrateur sont autorisés à enregistrer n'importe quelle adresse HTTP. L'autorisation pour les espaces de noms HTTP utilisés par les exemples doit être accordée aux comptes qui ne sont pas administrateur. Pour plus d'informations sur la configuration des réservations d'espaces de noms, consultez Configuring HTTP and HTTPS.

12. Certains exemples nécessitent Message Queuing. Pour obtenir les instructions d'installation, consultez Installation de Message Queuing (MSMQ).

Remarque   Pour des raisons de sécurité, supprimez la définition de répertoire virtuel et les autorisations accordées au cours des étapes d'installation lorsque vous en avez terminé avec les exemples en exécutant le fichier de commandes Cleanupvroot.bat.

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.