Процедура однократной настройки образцов Windows Communication Foundation

  • Статья

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

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

Примечание.

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

Однократно настраиваемая процедура для образцов WCF

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

  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» для учетной записи, от имени которой выполняется построение образцов, и для пользователя сетевой службы. При построении некоторых образцов, размещенных на веб-сервере, может быть выполнена попытка копирования компилированных двоичных файлов в указанное ранее расположение, и если соответствующие разрешения не заданы, построение прервется. Кроме того, вы можете оставить разрешения так же, как и запустить командную строку ПАКЕТА SDK или командную строку Visual Studio (2012) как Администратор istrator, или создать примеры в Visual Studio 2012, а также запустить как Администратор istrator.

    Примечание.

    Если этот шаг не выполнен, построение всех образцов, размещенных в службах IIS, завершится с ошибкой. Убедитесь, что вы правильно задаете разрешения или запускаете командную строку ПАКЕТА SDK и командную строку Visual Studio как Администратор istrator.

  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. Резидентным образцам (не размещенным в службах IIS) требуется разрешение на регистрацию HTTP-адресов на компьютере для прослушивания. Разрешение на резервирование пространства имен HTTP поступает от учетной записи пользователя, используемой для выполнения образца. По умолчанию учетные записи администратора имеют разрешение на регистрацию любых HTTP-адресов. Неадминистративным учетным записям должно быть предоставлено разрешение на использование пространства имен HTTP, применяемых в образцах кода. Дополнительные сведения о настройке резервирования пространств имен см. в разделе Настройка протоколов HTTP и HTTPS.

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

    Примечание.

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

  12. Для некоторых образцов требуются сертификаты. Инструкции по установке сертификата сервера службы IIS (IIS).