Поделиться через

процедура установки One-Time для примеров Windows Communication Foundation

Большинство примеров Windows Communication Foundation (WCF) размещаются в службах IIS и запускаются из общего виртуального каталога. Эта однократная процедура установки создает папку на диске; она также добавляет виртуальный каталог в службы IIS с именем ServiceModelSamples.

Виртуальный каталог ServiceModelSamples используется для создания и запуска всех примеров, использующих размещенную в IIS службу. Это единственный виртуальный каталог, необходимый для запуска примеров. Создание примера заменит любую ранее развернутую службу в этом виртуальном каталоге; Только последний созданный пример будет развернут и доступен в этом виртуальном каталоге.

Замечание

  • Необходимо выполнить все команды в учетной записи локального администратора. Если вы используете Windows 7, Windows Vista или Windows Server 2008 R2, необходимо также запустить командную строку с повышенными привилегиями. Для этого щелкните правой кнопкой мыши значок командной строки и нажмите кнопку "Запуск от имени администратора".
  • Все команды в этой статье должны выполняться в командной строке с соответствующими параметрами пути. Самый простой способ обеспечить это - воспользоваться Командной строкой разработчика для Visual Studio.

Процедура первоначальной настройки для примеров WCF

  1. Убедитесь, что ASP.NET настроен. Дополнительные сведения о настройке ASP.NET см. в инструкциях по размещению служб Internet Information Service.

  2. Убедитесь, что установлен .NET Framework 4+ . Выполните поиск в следующем каталоге для версии 4.0 (или более поздней версии): \Windows\Microsoft.NET\Framework

  3. Убедитесь, что установлен Visual Studio 2012 или более поздней версии, или операционная система windows Server 2008 с пакетом обновления 2 (SP2) или более поздней версии.

  4. Выполните следующие команды. Дополнительные сведения о том, почему эти команды должны выполняться, см. в разделе "Сбой размещенной службы IIS".

    Предупреждение

    Если служба IIS переустановлена, выполните следующие команды снова.

    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" -i -enable
"%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r

    Предупреждение

    При выполнении команды aspnet_regiis -i -enable пул приложений по умолчанию запускается с помощью .NET Framework 4, что может привести к проблемам несовместимости для других приложений на том же компьютере.

  5. Следуйте инструкциям брандмауэра , чтобы включить порты, используемые примерами.

  6. Запустите пакетный файлSetupvroot.bat. Выполняются следующие действия.

    • Виртуальный каталог создается в службах IIS с именем ServiceModelSamples.

    • Новые каталоги дисков создаются с именем %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples и %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Если вы предпочитаете вручную настроить эти каталоги, см. инструкции по настройке виртуального каталога. Чтобы вернуть все изменения, выполненные на этом шаге, запустите cleanupvroot.bat после завершения работы с примерами.

    Замечание

    Эта процедура должна выполняться только один раз на компьютере, если вы не запускаете cleanupvroot.bat.

  7. Необходимо предоставить разрешение на изменение для %SystemDrive%\inetpub\wwwroot учетной записи, под которой вы выполняете сборку примеров, и пользователя Network Service. При сборке некоторые веб-примеры могут попытаться скопировать скомпилированные двоичные файлы в указанное ранее расположение, и если у вас нет соответствующих разрешений, сборка будет нарушена. Вы также можете оставить текущие разрешения и запустить командную строку SDK или Visual Studio (2012) от имени администратора, либо создать примеры в Visual Studio 2012, также запустив от имени администратора.

    Замечание

    Если этот шаг не завершен, все примеры, размещенные в IIS, завершаются сбоем во время сборки. Убедитесь, что вы правильно задаете разрешения или запускаете командную строку SDK и командную строку Visual Studio от имени администратора.

  8. Создайте каталог C:\logs на компьютере, так как некоторые образцы могут его требовать. Убедитесь, что соответствующая учетная запись имеет доступ на запись, предоставленный этой папке. Для Windows 7, Windows Vista и Windows Server 2008 R2 эта учетная запись является сетевой службой. Для Windows Server 2008 учетная запись — NT Authority\Network Service. Для Windows XP и Windows Server 2003 учетная запись — ASPNET.

  9. Запустите файлSetupcerttool.bat. Этот скрипт выполняет следующие задачи:

    • Создает средство FindPrivateKey.

    • Создает каталог с именем %ProgramFiles%\ServiceModelSampleTools.

    • Копирует новое средство FindPrivateKey в этот каталог.

    Это средство требуется для примеров, использующих сертификаты и размещённых в IIS.

    Замечание

    Для обеспечения безопасности не забудьте удалить определение и разрешения виртуального каталога, предоставленные в описанных выше шагах установки, выполнив пакетный файл с именемcleanupvroot.bat после завершения работы с примерами.

  10. Для регистрации HTTP-адресов на компьютере для прослушивания примеров, не размещенных в IIS, требуется разрешение на регистрацию HTTP-адресов на компьютере. Разрешение для резервирования пространства имен HTTP поступает из учетной записи пользователя, используемой для запуска примера. По умолчанию учетные записи администратора имеют разрешение на регистрацию любого HTTP-адреса. Неадминистраторские учетные записи должны получить разрешения для пространств имен HTTP, используемых примерами. Дополнительные сведения о настройке резервирований пространств имен см. в разделе "Настройка HTTP и HTTPS".

  11. Для некоторых примеров требуется очередь сообщений. Инструкции по установке см. в статье об установке очереди сообщений (MSMQ ).

    Замечание

    Перед запуском всех примеров, требующих очереди сообщений, необходимо запустить службу MSMQ.

  12. Для некоторых примеров требуются сертификаты. См. инструкции по установке сертификата сервера IIS.

  • Last updated on