Устранение распространенных проблем, связанных с веб-развертыванием

Применимо к: Службы IIS

В этой статье описывается, как диагностировать и устранять распространенные проблемы с веб-развертыванием, включая распространенные ошибки, возникающие при публикации из Visual Studio 2010.

Ведение журнала

При возникновении проблем, связанных с веб-развертыванием, существует несколько вариантов ведения журнала в зависимости от места возникновения проблемы. По умолчанию веб-развертывание записывает журналы в журнал событий в разделе Приложения>Microsoft Web Deploy. Это отличное место, чтобы начать поиск ошибок на целевом сервере.

Если вы не можете диагностировать проблему с помощью журнала событий, ниже приведены некоторые другие варианты:

  • Используйте журналы MSI веб-развертывания, расположенные в папке %programfiles%\IIS\Microsoft Web Deploy версии 3 , для диагностики проблем с установкой.
  • Если служба веб-управления или служба удаленного агента не запускается, ознакомьтесь со сведениями об ошибке, выбрав Просмотр событий (локальная)>Системажурналов> Windows для диспетчера управления службами.
  • Вы можете дополнительно настроить трассировку для службы веб-управления.

Коды ошибок

В некоторых распространенных случаях ошибки веб-развертывание отображает сообщение и код ошибки, которые могут быть полезны для получения дополнительных сведений для устранения проблемы. Полный список кодов ошибок см. в разделе Коды ошибок веб-развертывания.

Примечание.

Сообщение об ошибке может отличаться в зависимости от того, как вызывается веб-развертывание. Например, Microsoft WebMatrix выбирает отображение пользовательских сообщений об ошибках вместо кодов ошибок, в то время как командная строка всегда будет отображать коды ошибок, если они зарегистрированы.

Проблемы с установкой

1. Не удалось установить веб-развертывание в допустимой ОС

Симптомы Операционная система (ОС) работает правильно, а версия и разрядность веб-развертывания верны, но установка не завершается успешно.
Причину Unknown
Исправление и обходное решение Просмотрите журнал установки, расположенный в папке %programfiles%\IIS\Microsoft Web Deploy версии 3.

2. Веб-развертывание не работает после обновления

Симптомы Веб-развертывание не работает после обновления версии.
Причину Веб-развертывание не перезапускает службы после обновления.
Исправление и обходное решение Если вы обновляете существующую установку веб-развертывания, обязательно перезапустите службы обработчика и агентов, выполнив следующие команды в командной строке администратора:
net stop msdepsvc
net start msdepsvc
net stop wmsvc
net start wmsvc

3. Не удалось установить 32-разрядную версию веб-развертывания на 64-разрядном оборудовании

Симптомы Снимок экрана: диалоговое окно
Причину Попытка установить 32-разрядную версию в 64-разрядной ОС — это проверка в MSI веб-развертывания, которая завершается сбоем, так как она не поддерживает режим WoW64.
Исправление и обходное решение Установите ту же версию, которая соответствует архитектуре вашей ОС.

4. Не удалось установить 64-разрядную версию веб-развертывания на 32-разрядном оборудовании

Симптомы Снимок экрана: диалоговое окно установщика Windows. В тексте говорится, что этот тип процессора не поддерживает этот пакет установки. Обратитесь к поставщику продукта.
Причину Попытка установить 64-разрядную версию в 32-разрядной ОС — это проверка в MSI веб-развертывания, которая завершится ошибкой.
Исправление и обходное решение Установите ту же версию, которая соответствует архитектуре вашей ОС.

5. Не удалось зарегистрировать пространство имен URL-адреса из-за существующего пространства имен

Симптомы Не удается установить веб-развертывание.
Причину Пространство имен URL-адресов, которое веб-развертывание пытается создать во время установки, уже зарегистрировано.
Исправление и обходное решение — Удалить конфликтующую регистрацию.
— Изменение URL-адреса веб-развертывания во время установки
msiexec /i wdeploy.msi /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/.
Дополнительные сведения о настройке URL-адреса см. в разделе Настройка и защита удаленной службы.

Проблемы со службой удаленного агента

1. Не удалось инициализировать Microsoft.Web.Deployment.Dll во время запуска

Симптомы Служба удаленного агента не запускается.
Причину msdepsvc.exe или другие файлы отсутствуют в папке %programfiles%\IIS\Microsoft Web Deploy версии 3.
Исправление и обходное решение Переустановите продукт.

2. Служба удаленного агента не запущена

Симптомы Microsoft.Web.Deployment.DeploymentAgentUnavailableException: не удалось связаться с удаленным агентом (URL-адрес http://DestinationServer/msdeployagentservice). Убедитесь, что служба удаленного агента установлена и запущена на целевом компьютере. >--- System.Net.WebException: удаленный сервер вернул ошибку: (404) Не найдено.
Причину Служба удаленного агента не запущена.
Исправление и обходное решение Запустите службу: net start msdepsvc.

3. Попытка подключения к серверу, на котором http не прослушивает или не разрешено

Симптомы Microsoft.Web.Deployment.DeploymentAgentUnavailableException: не удалось связаться с удаленным агентом (URL-адрес http://DestinationServer/msdeployagentservice). Убедитесь, что служба удаленного агента установлена и запущена на целевом компьютере. >--- System.Net.WebException: не удалось подключиться к удаленному серверу ---> System.Net.Sockets.SocketException: не удалось установить подключение, так как целевой компьютер отказался от него DestinationServer:80
Причину HTTP не прослушивает.
Исправление и обходное решение Убедитесь, что для службы удаленного агента разрешен трафик HTTP.

4. Попытка подключения к серверу с ошибкой "Метод не разрешен"

Симптомы Microsoft.Web.Deployment.DeploymentException: не удалось выполнить запрос на URL-адрес удаленного агента "http://DestinationServer/". >--- System.Net.WebException: удаленный сервер вернул ошибку: (405) Метод не разрешен.
Причину Запрос был выбран самими службами IIS вместо развертывания MS, так как отсутствует путь к msdepsvc.exe .
Исправление и обходное решение Измените URL-адрес, включив в него /MSDeployAgentService.

5. Попытка доступа к службе удаленного агента от имени администратора

Симптомы Microsoft.Web.Deployment.DeploymentException: не удалось выполнить запрос на URL-адрес удаленного агента "http://DestinationServer/msdeployAgentService". >---; System.Net.WebException: удаленный сервер вернул ошибку: (401) Не авторизовано.
Причину Служба удаленного агента требует, чтобы вызывающий объект был членом группы "Администраторы" или из учетной записи домена, добавленной в группу "Администраторы". Локальный администратор, который не является встроенной учетной записью, не будет работать со службой удаленных агентов из-за ошибки в веб-развертывании 2.0.
Исправление и обходное решение Укажите учетные данные администратора.

6. Служба удаленного агента зависает во время работы

Симптомы Служба может перестать отвечать на запросы в течение длительного времени, до нескольких часов.
Причину Неизвестно.
Исправление и обходное решение Остановите операцию и попытайтесь повторить ее.

7. Клиент и сервер несовместимы (несоответствие версий)

Симптомы Timestamp=24638007621418 MsDepSvc.exe Error: 0 : произошла ошибка. Сведения об исключении: Microsoft.Web.Deployment.DeploymentClientServerException: клиент и сервер несовместимы. Самая низкая версия, поддерживаемая клиентом, — 7.1.538.0. Самая высокая поддерживаемая сервером версия — 7.1.537.0.
Причину Некоторые версии не работают вместе, поэтому веб-развертывание блокирует их совместную работу. Обычно это делается, чтобы запретить работу предварительных версий с выпущенными версиями.
Исправление и обходное решение Соответствует версиям.

8. Службе удаленного агента не удалось начать прослушивание URL-адреса

Симптомы Службе удаленного агента не удалось начать прослушивать URL-адрес "{0}". Убедитесь, что URL-адрес не используется.
Причину Обычно указывает на конфликт URL-адресов.
Исправление и обходное решение Попробуйте переустановить, если вам нужен URL-адрес по умолчанию, или задать настраиваемый URL-адрес, как указано в документации. Дополнительные сведения о настройке URL-адреса см. в разделе Настройка и защита удаленной службы.

Проблемы со службой веб-управления

1. Служба веб-управления не запущена

Симптомы Служба веб-управления не запущена.
Причину Неизвестно. Служба должна быть запущена по умолчанию.
Исправление и обходное решение Запустите службу веб-управления: Net Start WMSVC.

2. Не авторизовано: пользователь не авторизован правилами обработчика развертывания

Симптомы Не удалось завершить операцию с указанным providerName <> при подключении с помощью службы веб-управления. Это может произойти, если администратор сервера не авторизовать пользователя для выполнения этой операции.
Причину Пользователь без прав администратора пытался выполнить ограниченное действие с поставщиком. Обычно это действие указывает на то, что соответствующее правило делегирования не найдено. Имя пользователя, поставщик, операция или путь поставщика неверны.
Исправление и обходное решение Обходной путь — исправить правило делегирования или создать его. Дополнительные сведения о правилах делегирования см. в разделе Настройка обработчика веб-развертывания.

Ошибки при публикации из Visual Studio

Дополнительные сведения об устранении распространенных ошибок, которые могут возникнуть при попытке публикации из Visual Studio на сервере, который не был правильно настроен с помощью веб-развертывания, см. в статье Устранение неполадок веб-развертывания с помощью Visual Studio.