Compartir a través de

Procedimiento de instalación única para los ejemplos de Windows Communication Foundation

  • Artículo

La mayoría de los ejemplos de Windows Communication Foundation (WCF) se hospedan en Internet Information Services (IIS) y se ejecutan desde un directorio virtual común. Este procedimiento de instalación única crea una carpeta en el disco y también agrega un directorio virtual en IIS denominado ServiceModelSamples.

El directorio virtual ServiceModelSamples se utiliza para compilar y ejecutar todos los ejemplos que usan un servicio hospedado en IIS. Este es el único directorio virtual que se necesita para ejecutar los ejemplos. Al compilar un ejemplo, se reemplazará cualquier servicio implementado anteriormente en este directorio virtual; solo se implementará y estará disponible en este directorio virtual el ejemplo creado más recientemente.

ms751527.note(es-es,VS.100).gifNota:
Debe ejecutar todos los comandos con una cuenta de administrador local. Si está utilizando Windows 7, Windows Vista o Windows Server 2008 R2, también debe ejecutar el símbolo del sistema con privilegios elevados. Para realizar esta acción, haga clic con el botón secundario en el icono del símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Todos los comandos de este tema se deben ejecutar en un símbolo del sistema que tenga la configuración de ruta de acceso adecuada. La manera más fácil de asegurarse de esto es usar el símbolo del sistema de Visual Studio. Para abrir este símbolo del sistema, haga clic en Inicio, seleccione Todos los programas, desplácese hasta Visual Studio 2010, seleccione Visual Studio Tools, haga clic con el botón secundario en Símbolo del sistema de Visual Studio (2010) y, a continuación, haga clic en Ejecutar como administrador. Si tiene una de las ediciones de Visual Studio Express instalada, este símbolo del sistema no está disponible, y tendrá que agregar "C:\Windows\Microsoft.Net\Framework\v4.0" a la ruta de acceso del sistema.

Procedimiento de instalación única para los ejemplos de WCF

  1. Asegúrese de que ASP.NET está instalado. Para obtener más información sobre cómo instalar ASP.NET, vea Instrucciones de hospedaje Internet Information Services.

  2. Asegúrese de que .NET Framework versión 4 está instalado. Busque la versión v4.0 (o posterior) en el siguiente directorio: \Windows\Microsoft.NET\Framework

  3. Si Visual Studio 2010 no está instalado y el sistema operativo no es Windows Server 2008 SP2 o posterior, instale el hotfix 251798.

  4. Ejecute los siguientes comandos. Para obtener más información acerca de por qué se deben ejecutar estos comandos, vea IIS Hosted Service Fails.

    ms751527.Warning(es-es,VS.100).gif Precaución:
    Si se reinstala IIS, los siguientes comandos deberán ejecutarse de nuevo. 

    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable
"%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r
    ms751527.Warning(es-es,VS.100).gif Precaución:
    Al ejecutar el comando aspnet_regiis –i –enable, hará que se ejecute el grupo de aplicaciones predeterminadas con .NET Framework 4, lo que puede generar problemas de incompatibilidad con otras aplicaciones en el mismo equipo.

  5. Siga el procedimiento de Instrucciones de firewall para habilitar los puertos usados en los ejemplos.

  6. Compruebe el siguiente directorio predeterminado: <InstallDrive>:\WF_WCF_Samples. Si se instalaron los ejemplos con anterioridad, este es el directorio predeterminado.

  7. Si los ejemplos no están instalados, instálelos desde la ubicación de descarga de ejemplos para Visual C# o Visual Basic.

  8. Después de instalar los ejemplos, vaya a: <InstallDrive>:\WF_WCF_Samples\WCF\Setup\

  9. Ejecute el archivo por lotes Setupvroot.bat. Se realizan estos pasos:

    • Se crea un directorio virtual en IIS denominado ServiceModelSamples.

    • Los nuevos directorios del disco se crean con los nombres %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples y %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Si prefiere configurar manualmente estos directorios, vea Instrucciones de configuración del directorio virtual. Para revertir todos los cambios efectuados en este paso, ejecute cleanupvroot.bat después de que termine de utilizar los ejemplos.

    ms751527.note(es-es,VS.100).gifNota:
    Este procedimiento solo se debe realizar una vez en un equipo, a menos que se ejecute cleanupvroot.bat.

  10. Debe conceder permiso para modificar %SystemDrive%\inetpub\wwwroot a la cuenta con la que se van a compilar los ejemplos y al usuario del Servicio de red. Mientras se compilan, algunos ejemplos hospedados en Web podrían intentar copiar los archivos binarios compilados en la ubicación mencionada previamente y, si no se han establecido los permisos adecuados, la compilación se interrumpirá. Alternativamente puede dejar los permisos tal como están y ejecutar el símbolo de sistema de SDK o de Visual Studio (2010) como administrador, o bien compilar los ejemplos en Visual Studio 2010, también como administrador.

    ms751527.note(es-es,VS.100).gifNota:
    Si no se completa este paso, todos los ejemplos hospedados en IIS generarán errores al compilarse. Asegúrese de que ha establecido los permisos correctamente o ejecute el símbolo del sistema de SDK y Visual Studio (2010) como administrador.

  11. Cree un directorio C:\logs en el equipo; en algunos ejemplos podría esperarse que exista. Asegúrese de que la cuenta adecuada tiene concedido acceso de escritura en esta carpeta. En Windows 7, Windows Vista y Windows Server 2008 R2, esta cuenta es Servicio de red. En Windows Server 2008, la cuenta es NT Authority\Network Service. En Windows XP y Windows Server 2003, la cuenta es ASPNET.

  12. Ejecute el archivo Setupcerttool.bat. Este archivo se encuentra en la carpeta <rutaDeInstalación>\WF_WCF_Samples\WCF\Setup\. Este script realizará las siguientes tareas:

    • Compile La herramienta FindPrivateKey.

    • Cree un directorio denominado %ProgramFiles%\ServiceModelSampleTools.

    • Copie la nueva herramienta FindPrivateKey en este directorio.

    Esta herramienta se requiere en los ejemplos que utilizan certificados y se hospedan en IIS.

    ms751527.note(es-es,VS.100).gifNota:
    Por motivos de seguridad, no olvide quitar la definición del directorio virtual y los permisos concedidos en los pasos de instalación anteriores cuando termine con los ejemplos; para ello ejecute el archivo por lotes denominado Cleanupvroot.bat.

  13. Los ejemplos autohospedados (no se hospedan en IIS) requieren permiso para registrar las direcciones HTTP en el equipo a fin de realizar escuchas. El permiso para una reserva de espacio de nombres HTTP procede de la cuenta de usuario utilizada para ejecutar el ejemplo. De forma predeterminada, las cuentas de administrador tienen el permiso para registrar cualquier dirección HTTP. Se debe dar permiso a las cuentas que no sean de administrador para los espacios de nombres HTTP utilizados en los ejemplos. Para obtener más información sobre cómo configurar reservas de espacios de nombres, vea Configuración de HTTP y HTTPS.

  14. Algunos ejemplos requieren Message Queuing. Vea Instalar Message Queuing (MSMQ) para obtener las instrucciones de instalación.

    ms751527.note(es-es,VS.100).gifNota:
    Asegúrese de iniciar el servicio de MSMQ antes de ejecutar cualquier ejemplo que requiera Message Queuing.

  15. En algunos ejemplos se requieren los certificados. Consulte Instrucciones de instalación del certificado de servidor de Internet Information Services (IIS).