Сведения о развертывании нового портала Self-Service и устранении неполадок с установкой

Новый портал Self-Service — это веб-приложение HTML5 на основе ASP.NET MVC на основе Razor. Во время установки это веб-приложение настраивается для подключения непосредственно к службе SDK, запущенной в обозревателе серверов Service Manager. Базовая и только что настроенная установка портала самообслуживания работает согласно следующей схеме.

Данные передаются между разными компонентами в следующей последовательности.

1. Пользователи вводят URL-адрес веб-приложения в браузере для доступа к порталу Self-Service.

2. ASP.NET создает новый экземпляр для пользователя и пытается отправить содержимое в службу SDK, предоставленную во время установки, в контексте пользователя.

3. Служба SDK обращается к базе данных Service Manager, выполняя чтение и запись данных.

Подготовка к развертыванию

Просмотрите следующий раздел со сведениями о подготовке к развертыванию.

Примечание

Не рекомендуется устанавливать портал Self-Service на том же сервере, что и основной сервер управления.

Требования к оборудованию

серверы Service Manager	Процессор (мин.)	Процессор (рек.)	ОЗУ (мин.)	ОЗУ (рек.)	Место на жестком диске (мин.)	Место на жестком диске (рек.)
Портал Self-Service + вторичная Service Manager (рекомендуется*)	8-ядерный ЦП с тактовой частотой 2,66 ГГц	8-ядерный ЦП с тактовой частотой 2,66 ГГц	16 Гб	32 ГБ	80 ГБ	80 ГБ
Портал самообслуживания (автономно)	4-ядерный ЦП с тактовой частотой 2,66 ГГц	8-ядерный ЦП с тактовой частотой 2,66 ГГц	8 ГБ	16 Гб	80 ГБ	80 ГБ

* Приведенные выше требования обеспечивают параллельный доступ для 500 пользователей с приемлемым временем отклика, включая среднюю продолжительность операций чтения менее 3 секунд и операций записи менее 5 секунд при условии, что соотношение операций чтения и записи составляет 80:20. Более крупные развертывания см. в разделе Развертывание веб-фермы ниже.

Поддерживаемые операционные системы

• Windows Server 2022

• Windows Server 2019

Поддерживаемые веб-браузеры

На портале Self-Service требуется разрешение экрана выше 1024 x 768. Она поддерживается в следующих браузерах:

• Microsoft Edge

• Microsoft Internet Explorer 10 и 11

• Mozilla Firefox 42 и более поздних версий

• Google Chrome 46 и более поздних версий

Развертывание нового портала Self-Service

Подробные инструкции по развертыванию нового портала Self-Service см. в статье Развертывание нового портала Self-Service . В следующих разделах приведены основные рекомендации по развертыванию.

Установка портала в качестве веб-сайта по умолчанию

Если вы хотите установить новый портал Self-Service через порт 80, сначала необходимо переместить веб-сайт по умолчанию в IIS на другой порт. Например, порт 8080, а затем переместите Self-Service Portal на порт 80.

Использовать SSL

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

Технологии развертывания

Для портала Self-Service можно использовать следующие топологии развертывания.

Один сервер (рекомендуется) — портал самообслуживания и сервер Service Manager на одном сервере

В этой топологии новый портал Self-Service и роль сервера управления устанавливаются на одном сервере. Это рекомендуемая топология, так как позволяет избежать сетевых задержек между порталом и службой SDK. Кроме того, рекомендуется установить портал Self-Service на дополнительный сервер управления службами, чтобы избежать снижения производительности из-за рабочих процессов, запущенных на сервере-источнике.

В этой топологии проверка подлинности Windows (которая задана по умолчанию) используется для обеспечения безопасной проверки подлинности без служебных данных, связанных с использованием SSL.

Развертывание автономного портала самообслуживания

В этой топологии на портале Self-Service устанавливается сервер, на котором не установлена роль сервера управления Service Manager.

В этой конфигурации новый портал Self-Service и дополнительный сервер Service Manager устанавливаются на разных серверах, и для создания подключения к службе SDK из веб-приложения требуется двойной прыжок. В этом случае нельзя использовать проверку подлинности Windows, и необходимо настроить портал для использования обычной проверки подлинности. Так как обычная проверка подлинности изначально небезопасна, рекомендуется использовать SSL, чтобы избежать проблем с безопасностью развертывания, таких как доступ к ресурсам за пределами брандмауэров и прокси-серверов. Дополнительные сведения см. в статье Обычная проверка подлинности для сценариев двойного прыжка.

Использование протокола SSL с сетевыми задержками между порталом и службой SDK делает эту топологию более медленной по сравнению с односерверным развертыванием. Однако такая конфигурация может помочь в сценариях развертывания, в которых двойного прыжка избежать невозможно.

Развертывание веб-фермы

Одним из ключевых преимуществ нового портала Self-Service является то, что веб-приложение не имеет локального хранилища данных, кроме кэширования. Оно напрямую обращается к базе данных Service Manager, выполняя чтение и запись данных. Это упрощает параллельное развертывание нескольких экземпляров веб-сервера. Для крупных развертываний, более 1000 пользователей, обращаюющихся к порталу параллельно, можно развернуть новый портал Self-Service как веб-ферму , как в следующей конфигурации.

Веб-ферма обеспечивает высокий уровень доступности портала самообслуживания. Внутри веб-приложение создает соединение WCF со службой SDK. Создание первоначального подключения требует времени, поэтому идеальный сценарий заключается в том, что веб-сервер, к которому подключается пользователь, должен изначально обслуживать все последующие запросы для более быстрого обхода. Чтобы реализовать такую конфигурацию в службах IIS, в параметре маршрутизации запросов приложений должно быть включено сходство клиента .

Устранение неполадок с установкой

Следующие разделы по устранению неполадок помогут вам решить распространенные проблемы.

Службы IIS не установлены

На странице конфигурации отображается ошибка роли IIS, даже если службы IIS включены на сервере.

Это происходит при запуске установщика без учетных данных администратора. В результате установщик не может получить доступ к параметрам конфигурации IIS.

Решение: запустите SetupWizard.exe от имени администратора. Щелкните правой кнопкой мыши SetupWizard и выберите Запуск от имени администратора.

Устранение неполадок на портале new Self-Service

В этом разделе описывается устранение неполадок, которые могут возникнуть после установки нового портала Self-Service.

Параметры служб IIS

Во время установки настраиваются следующие параметры портала по умолчанию:

Пул приложений

Он настроен для запуска в .NET CLR версии 4 в классическом режиме.

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

Конфигурация веб-сайта

Должны быть включены только параметры Олицетворение и Проверка подлинности Windows . Все остальные параметры должны быть отключены.

Для олицетворения должен быть выбран Прошедший проверку пользователь .

Параметры проверки подлинности Windows

Документом по умолчанию для веб-сайта должен быть index.cshtml.

Обычная проверка подлинности

В сценарии двойного прыжка проверка подлинности Windows не будет работать; поэтому он должен быть отключен. Включите и настройте обычную проверку подлинности.

Включение трассировки

Чтобы включить трассировку, выполните следующие действия.

Шаг 1. Добавьте следующие параметры в файл web.config, чтобы включить создание журнала событий.

<system.web>  
   .....  
   <trace enabled="true"/>  
   ...  
</system.web>  

Шаг 2. Направьте выходные данные в файл путем добавления следующих разделов в файл web.config.

<system.diagnostics>  
    <trace autoflush="true">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\logs\SSPOutput.log" />    
      </listeners>  
    </trace>  
</system.diagnostics>  

Так как веб-приложение выполняется в содержимом вошедшего пользователя, убедитесь, что вы предоставляете разрешения на запись всем пользователям в папке журнала. Например, "c:\logs" в приведенном выше примере.

Отладка служб IIS

Службы IIS поддерживают эффективное ведение журнала для отладки проблем IIS. Дополнительные сведения см. в статье Общие сведения о ведении журнала IIS.

Устранение неполадок развертывания

Используйте следующие разделы для устранения неполадок с развертыванием, которые могут повлиять на вас.

Изменения определений (объявления,предложения запросов/предложения услуг/статьи базы знаний) не отображаются

Новый портал Self-Service использует механизм кэширования для хранения статических данных, чтобы обеспечить быстрое время отклика. Время ожидания кэша по умолчанию составляет 30 минут, и его можно настроить. Дополнительные сведения см. в разделе "Базовая настройка" статьи Deploy the New Self-Service Portal . Любые изменения в определениях объявлений, предложений запросов, предложений служб и статей знаний не отображаются до очистки кэша.

Используемое кэширование памяти основано на .NET Framework MemoryCache. Кэшированное содержимое остается в памяти до завершения рабочего процесса IIS. Перезапуск IIS не помогает, так как iis не удаляет старый процесс, а затем запускает новый. Вместо этого они повторно используют уже существующий процесс. Чтобы обеспечить вывод актуальных данных и удаление данных кэша, определите рабочий процесс IIS, связанный с данным экземпляром, и выберите Завершить задачу до перезапуска служб IIS.

Разделы "Мои запросы" и "Мои действия" пусты

Проекции нового типа включены в файл Portal.mpb, который входит в состав установщика и должен быть импортирован в Service Manager. Чтобы осуществить импорт, выполните указанные ниже действия.

1. Импортируйте файл Portal.mpb на сервер управления.

2. На сервере управления, к которому подключается портал, перезапустите службу SDK.

Всплывающие окна, блокирующие внешние ссылки

Если включен параметр "Конфигурация усиленной безопасности" для Internet Explorer, при просмотре портала пользователь на каждой странице получает следующее всплывающее окно.

Это всплывающее окно отображается для пакета SDK JavaScript для App Insights, который интегрирован в портал Self-Service для сбора данных телеметрии. Вы можете отключить отправку данных телеметрии, изменив значение параметра конфигурации EnableTelemetry, что приведет к удалению всплывающего окна. Дополнительные сведения см. в разделе "Базовая настройка" статьи Deploy the New Self-Service Portal .

Вы можете получить доступ к порталу на компьютере, на котором размещены службы IIS, но не с удаленного компьютера.

Эта проблема может возникнуть, если портал и служба SDK расположены на разных компьютерах (автономное развертывание Self-Service портала). Это вызывает двойной прыжок при попытке получить доступ к порталу с удаленного компьютера. Поэтому конфигурация портала по умолчанию, описанная в разделе Проверка подлинности Windows , не будет работать. Чтобы устранить эту проблему, используйте вместо нее конфигурацию обычной проверки подлинности .

Некоторые предложения услуг или опубликованные предложения услуг не отображаются на портале

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

• предложение услуги соответствует языку браузера или языку, выбранному через средство выбора языка портала;

• для предложения услуги язык не выбран.

  

  

Ниже приведен список языков с кодами языков, поддерживаемыми порталом:

• en-US: английский

• fr-FR: français

• de-DE: Deutsch

• cs-CZ: čeština

• da-DK: Dansk

• el-GR: Ενννινινινιο

• es-ES: español

• fi-FI: suomi

• hu-HU: magyar

• it-IT: italiano

• ja-JP: 日本語

• ko-KR: 한국어

• nb-NO: norsk

• nl-NL: Nederlands

• pl-PL: polski

• pt-BR: português (Brasil)

• pt-PT: português (Португалия)

• ru-RU: русский

• sv-SE: svenska

• tr-TR: Türkçe

• zh-CHS: 中文(简体)

• zh-TW: 中文(简体)

• zh-HK: 中文 (香港特別行政區)

Отображение времени для моих элементов всегда указывает на am

Чтобы устранить эту проблему, найдите тег utc-date и замените строку DateTime.Parse(xyz).ToString("yyyy,M,d,h,m,s") строкой DateTime.Parse(xyzToString("yyyy,M,d,H,m,s") в следующих файлах:

• Views\KnowledgeBase\Article.cshtml;

• Views\MyActivities\ActivityDetails.cshtml;

• Views\MyRequests\RequestDetails.cshtml;

• Views\Shared\_Layout.cshtml.

Дальнейшие действия

• Сведения о развертывании и настройке портала Self-Service см. в статье Развертывание портала Self-Service.