Compartir vía

One-Time Procedimiento de Configuración para los ejemplos de Windows Communication Foundation

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; también agrega un directorio virtual a IIS denominado ServiceModelSamples.

El directorio virtual ServiceModelSamples se usa para compilar y ejecutar todos los ejemplos que usan un servicio hospedado en IIS. Este es el único directorio virtual necesario para ejecutar los ejemplos. La creación de un ejemplo reemplazará cualquier servicio implementado previamente en este directorio virtual; solo se implementará el ejemplo compilado más recientemente y estará disponible en este directorio virtual.

Nota:

  • Debe ejecutar todos los comandos en 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 ello, haga clic con el botón derecho en el icono del símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador.
  • Todos los comandos de este artículo 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 para desarrolladores de Visual Studio.

Procedimiento de instalación único para ejemplos de WCF

  1. Asegúrese de que ASP.NET esté configurado. Para obtener más información sobre cómo configurar ASP.NET, consulte Instrucciones de hospedaje de Internet Information Service.

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

  3. Asegúrese de que tiene Instalado Visual Studio 2012 o posterior, o el sistema operativo es Windows Server 2008 SP2 o posterior.

  4. Ejecute los siguientes comandos. Para obtener más información sobre por qué se deben ejecutar estos comandos, consulte Error en el servicio hospedado de IIS.

    Advertencia

    Si IIS se vuelve a instalar, 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

    Advertencia

    Al ejecutar el comando aspnet_regiis –i –enable , el grupo de aplicaciones predeterminado se ejecutará con .NET Framework 4, lo que puede producir problemas de incompatibilidad para otras aplicaciones del mismo equipo.

  5. Siga las instrucciones del firewall para habilitar los puertos usados por los ejemplos.

  6. Ejecute el archivo por lotes Setupvroot. Se realizan los pasos siguientes:

    • Se crea un directorio virtual en IIS denominado ServiceModelSamples.

    • Se crean nuevos directorios de disco denominados %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples y %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Si prefiere configurar estos directorios manualmente, consulte las instrucciones de configuración del directorio virtual. Para revertir todos los cambios realizados en este paso, ejecute cleanupvroot.bat después de terminar de usar los ejemplos.

    Nota:

    Este procedimiento solo se debe realizar una vez en un equipo, a menos que ejecute cleanupvroot.bat.

  7. 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. Al compilar, algunos ejemplos hospedados en web podrían intentar copiar los archivos binarios compilados en la ubicación mencionada anteriormente y, si no ha establecido los permisos adecuados, se interrumpirá la compilación. Otra opción es dejar los permisos tal como están y ejecutar la consola de comandos del SDK o la consola de comandos de Visual Studio (2012) como administrador, o bien compilar los ejemplos en Visual Studio 2012 y también ejecutarlos como administrador.

    Nota:

    Si no se completa este paso, se producirá un error en todos los ejemplos hospedados en IIS durante la compilación. Asegúrese de que ha establecido los permisos correctamente o ejecute el símbolo del sistema de SDK y Visual Studio como administrador.

  8. Cree el directorio C:\logs en el equipo porque es posible que algunos ejemplos lo requieran. Asegúrese de que la cuenta adecuada tiene acceso de escritura concedido a esta carpeta. Para Windows 7, Windows Vista y Windows Server 2008 R2, esta cuenta es Servicio de red. Para Windows Server 2008, la cuenta es NT Authority\Network Service. Para Windows XP y Windows Server 2003, la cuenta es ASPNET.

  9. Ejecute el archivoSetupcerttool.bat. Este script realiza las siguientes tareas:

    • Compila la herramienta FindPrivateKey.

    • Crea un directorio denominado %ProgramFiles%\ServiceModelSampleTools.

    • Copia la nueva herramienta FindPrivateKey en este directorio.

    Los ejemplos que usan certificados requieren esta herramienta y se hospedan en IIS.

    Nota:

    Para fines de seguridad, recuerde quitar la definición de directorio virtual y los permisos concedidos en los pasos de configuración anteriores ejecutando el archivo por lotes denominado cleanupvroot.bat después de que haya terminado con los ejemplos.

  10. Los ejemplos autohospedados (no hospedados en IIS) requieren permiso para registrar direcciones HTTP en el equipo para escuchar. El permiso para una reserva de espacio de nombres HTTP procede de la cuenta de usuario que se usa para ejecutar el ejemplo. De forma predeterminada, las cuentas de administrador tienen permiso para registrar cualquier dirección HTTP. A las cuentas que no son de administrador se les debe conceder permiso para los espacios de nombres HTTP usados por los ejemplos. Para obtener más información sobre cómo configurar las reservas de espacios de nombres, consulte Configuración de HTTP y HTTPS.

  11. Algunos ejemplos requieren Message Queuing. Consulte Instalación de Message Queue Server (MSMQ) para obtener instrucciones de la instalación.

    Nota:

    Asegúrese de iniciar el servicio MSMQ antes de ejecutar los ejemplos que requieran Message Queuing.

  12. Algunos ejemplos requieren certificados. Consulte Instrucciones de instalación de certificados de servidor de Internet Information Services (IIS).