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

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

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

Примечание

Необходимо выполнить все команды от имени учетной записи локального администратора. При использовании Windows 7, Windows Vista или Windows Server 2008 R2 необходимо запустить командную строку с более высоким уровнем привилегий. Для этого щелкните правой кнопкой мыши значок командной строки и выберите команду Запуск от имени администратора. Все команды в данном разделе должны выполняться в командной строке с соответствующим образом заданными параметрами пути. Проще всего добиться этого, используя командную строку Visual Studio. Для этого нажмите кнопку Пуск, выберите пункт Все программы, перейдите к пункту Visual Studio 2010, выберите пункт Средства Visual Studio, щелкните правой кнопкой пункт Командная строка Visual Studio (2010) и выберите команду Запуск от имени администратора. Если установлен один из выпусков Visual Studio Express, эта командная строка недоступна. В этом случае добавьте в системный путь строку «C:\Windows\Microsoft.Net\Framework\v4.0».

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

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

2. Убедитесь, что установлена платформа .NET Framework, версия 4. Найдите папку \Windows\Microsoft.NET\Framework для версии 4.0 или более поздней.

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

4. Выполните следующие команды. Дополнительные сведения о том, для чего нужно выполнить эти команды, см. в разделе IIS Hosted Service Fails.

   Внимание!
   Если 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. Проверьте следующий каталог по умолчанию: <диск_установки>:\WF_WCF_Samples. Если образцы были предварительно установлены, этот каталог будет выбран по умолчанию.

7. Если образцы не были установлены, установите их из загрузочного каталога для Visual C# или Visual Basic.

8. После установки образцов перейдите в каталог: <диск_установки>:\WF_WCF_Samples\WCF\Setup\

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

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

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

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

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

10. Предоставьте разрешение на изменение папки «%SystemDrive%\inetpub\wwwroot» для учетной записи, от имени которой выполняется построение образцов, и для пользователя сетевой службы. При построении некоторых образцов, размещенных на веб-сервере, может быть выполнена попытка копирования компилированных двоичных файлов в указанное ранее расположение, и если соответствующие разрешения не заданы, построение прервется. Можно также оставить разрешения неизменными и запускать командную строку пакета SDK или Visual Studio(2010) от имени администратора или строить образцы в Visual Studio 2010 также от имени администратора.

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

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

12. Запустите файл Setupcerttool.bat. Данный файл расположен в папке <пусть_установки>\WF_WCF_Samples\WCF\Setup\. Этот скрипт выполнит следующие задачи.

    • Построит средство FindPrivateKey.

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

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

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

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

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

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

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

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