Средства набора ресурсов для сохраняемого чата Lync Server 2013

  • Статья

 

Последнее изменение раздела: 2013-02-24

Средства набора ресурсов сохраняемого чата Lync Server 2013 упрощают выполнение задач ИТ-администраторам, которые развертывают сервер сохраняемого чата Lync Server 2013 и управляют им. Помимо инструкций по установке, в этом разделе описывается назначение каждого средства и примеры его использования.

Установка средств из набора ресурсов

Чтобы установить Lync Server 2013, resource Kit Tools, скачайте PersistentChatReskit.msi. ВыполнитеPersistentChatReskit.msi, чтобы выполнить простую установку. В .msi устанавливаются все средства по следующему пути: \Program Files\ Microsoft Lync Server 2013\Persistent Chat Server Resource Kit. Инструменты, представляющие собой автономные исполняемые файлы, находятся непосредственно в этой папке. Средства, которые также содержат файлы, находятся в собственных вложенных папках.

Важно

После установки Lync Server 2013, resource Kit Tools, необходимо установить PsExec.exe и скопировать PsExec.exe по следующему пути: \Program Files\ Microsoft Lync Server 2013\Persistent Chat Server Resource Kit\ChatStressTool. Если вы не скопируетеPsExec.exe, средство сохраняемого чата создаст исключение ошибки и выполнит неправильное выполнение. Перед запуском средства убедитесь, что выполнены эти предварительные требования. Дополнительные сведения об установке PsExec.exeсм. в разделе https://go.microsoft.com/fwlink/p/?LinkId=282246.

Поддерживаемые среды

Для оптимальной производительности Lync Server 2013, средства комплекта ресурсов должны быть установлены в той же среде и со спецификациями, необходимыми для Lync Server 2013.

Обзор средств из набора ресурсов

Ниже приведены средства, предоставляемые в наборе ресурсов сохраняемого чата Lync Server 2013. В следующем разделе приводится описание каждого средства, включая требования и примеры использования.

  • AffCheck

  • ChatMonitoringSummary

  • Средство ChatStress

  • ChatUpgradeVerifier

  • ChatUsageReport

  • ScheduleADSyncforPrincipal

AffCheck

Описание

Средство AffCheck подтверждает, что записи о пользователях и группах внутренней базы данных сохраняемого чата совпадают с записями принадлежности к доменные службы Active Directory.

Требования

Средство устанавливается вместе с установщиком PersistentChatResKit на компьютере, присоединенном к домену.

Учетная запись пользователя, под которой выполняется средство, должна иметь доступ на чтение к серверной базе данных сохраняемого чата и доменные службы Active Directory.

Режим

Настройте файл AffCheck.exe.config в соответствии с инструкциями в файле конфигурации и запустите средство AffCheck без параметров командной строки. Ниже приведено содержимое стандартного AffCheck.exe.config.

AffCheck.exe.config:

    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
      <appSettings>
        <!--Domain Controller IP Address-->
        <add key="LDAP" value="LDAP://0.0.0.0/"/>
        
        <!-- Domain DN  This is case sensitive, it must match exactly-->
        <add key="DomainComponent" value ="DC=DOMAIN,DC=COM"/>
        
        <!--Domain Administrator Login and Password-->
        <add key="DomainLogin" value="DOMAIN\Administrator"/>
        <add key="DomainPassword" value ="password"/>
        
        <!-- Connection string to Group Chat Database-->
        <add key="ConnectionString" value="data source=SQL_SERVER\INSTANCE;initial catalog=DATABASE_NAME;integrated security=SSPI"/>
        
        <!--Check group affiliations-->
        <add key="CheckGroups" value="true"/>
        
        <!--Check user affilations-->
        <add key="CheckUsers" value="true"/>
        
        <!--List all affiliations if there is a mismatch between database and active directory-->
        <add key="ListAffiliations" value="true"/>
    
        <!--If you need to offset the results of the number of affilations in AD(can be negative to add to AD parent count)-->
        <add key="Offset" value ="0"/>
    
        <!--If you need to ignore certain parents, provide a semi colon delimitted list.-->
        <add key="Ignore" value ="DC=uatest,DC=test,DC=contoso,DC=com;DC=test,DC=contoso,DC=com"/>
      </appSettings>
    </configuration>

ChatMonitoringSummary

Описание

Средство PersistentChatMonitoringSummary перемещает сведения о мониторинге сохраняемого чата из базы данных мониторинга в указанный CSV-файл журнала.

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

Требования

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

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

Файл, PersistentChatMonitoringSummary.exe.config, должен содержать раздел connectionStrings>, <который определяет строку подключения к базе данных мониторинга. Он также должен содержать ключ для PersistentChatEndpointUri, для которого будут собираться данные мониторинга, и путь к файлу расположения для создаваемого CSV-файла. Примеры см. в установленном файле конфигурации. Файл должен находиться в том же каталоге, что и средство.

Режим

    PersistentChatMonitoringSummary [-StartDateTime <date>] [-EndDateTime <date>]

Эти параметры определяют выбор данных:

StartDateTime: При необходимости указывает дату начала периода выбора. По умолчанию: 1/1/1753 12:00:00 AM

EndDateTime: При необходимости указывает последнюю дату периода выбора. По умолчанию: теперь

Пример

    C:\Users\Administrator.VDOMAIN>Desktop\PersistentChatMonitoringSummary.exe
    Reading database connection information, Persistent Chat endpoint uri, and csv output path information from the application config file...
    Connecting to Monitoring database with connection string specified in the application config file...
    Gathering Persistent Chat Session Summary information between "1/1/1753 12:00:00 AM" and "11/19/2012 10:11:25 AM" for Persistent Chat Endpoint Uri "persistentChatEndpointUri@domain.com"...
    Press enter to continue or hit ctr-c if these settings are incorrect...
    
    The summary information about Persistent Chat sessions from the Monitoring database has been output to C:\PersistentChatMonitoring_dd4ace24-4c8a-4a3d-8fd4-591bdfacf47b.csv
    Press enter to exit...

Средство сохраняемого нагрузки чата

Описание

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

Требования

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

Помимо этого компьютера контроллера , вам потребуется несколько компьютеров загрузчиков . Для каждого 10 000 пользователей в пользовательской модели на компьютере загрузщика потребуется не менее 4 ГБ свободной ОЗУ. Например, для запуска с 80 000 пользователей потребуется около 32 ГБ ОЗУ, распределенного по всем компьютерам загрузчиков. Мы рекомендуем иметь по крайней мере три компьютера загрузщика независимо от ожидаемой нагрузки.

На компьютерах загрузчиков должна быть установлена платформа .NET 4.5 Framework, а также распространяемый компонент Visual C++ 2012.

Конфигурация

Скопируйте файлы ChatStressTool в общую папку, доступную со всех компьютеров загрузчиков.

Создайте пользователей и каналы для использования в нагрузочных запусках:

  • Создайте столько пользователей, сколько вызывает модель пользователя, включите их для Lync и задайте для политики сохраняемого чата значение "Включено".

  • Создайте категорию для каналов нагрузки, а затем создайте столько помещений, сколько требуется в этой категории. Категория должна содержать всех пользователей с нагрузкой в списке разрешенных (путем добавления подразделения), а комнаты с нагрузками должны иметь параметр конфиденциальности "Открыть".

  • Рекомендуется создавать комнаты с дополнительными нагрузками. Вы можете создать 50 000 комнат с помощью следующей Windows PowerShell интерфейса командной строки:

        for ($i = 0; $i -le 50000; $i++) { New-CsPersistentChatRoom -Category <parent category> -Name "StressChan_$i" -Privacy Open }

Измените файлы конфигурации в соответствии с топологией:

В LoaderProcess.exe.configизмените "controller.contoso.com" на полное доменное имя (FQDN) компьютера контроллера.

В StressLauncher.exe.config:

  1. Измените значение параметра LoaderBinary на путь к общей папке.

  2. Измените "AdminUser"/"AdminPassword" на учетные данные, которые имеют административный доступ к компьютерам загрузчиков.

  3. Измените ChannelCategory на имя категории, в которую были созданы каналы нагрузки.

  4. Измените значения UserNamePattern и UserPasswordPattern на шаблон, соответствующий вашим учетным данным пользователя с нагрузкой. {0} заменяется номером индекса пользователя.

  5. Измените "Домен" на домен SIP тестовой топологии.

  6. Замените ConnectionString строкой подключения для серверной базы данных сохраняемого чата.

  7. Измените "UserIndexStart" на индекс первого пользователя с нагрузкой.

  8. Измените LyncFQDN на полное доменное имя пула переднего плана.

  9. Измените список "Компьютеры", включив имена компьютеров для всех компьютеров загрузчиков.

  10. Измените значение baseAddress конечной точки службы (по умолчанию — controller.contoso.com) на полное доменное имя компьютера контроллера.

Режим

После завершения настройки откройте StressLauncher.exe на компьютере контроллера. Вы можете запустить StressLauncher от имени любого пользователя. Учетные данные, с которых загрузчик начинает работу на компьютерах загрузчиков, должны быть указаны в файле конфигурации. Также необходимо предоставить строку подключения, которая имеет доступ на чтение к серверной базе данных сохраняемого чата. Если эта строка подключения использует интегрированные проверка подлинности Windows, необходимо запустить StressLauncher от имени пользователя с таким доступом.

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

ChatUpgradeVerifier

Описание

ChatUpgradeVerifier — это средство сравнения базы данных сохраняемого чата. Средство сравнивает базу данных группового чата 2007 R2 или базы данных группового чата 2010 (2007/2010Db) с базой данных сохраняемого чата 2013 (2013Db).

Средство проверит по одному, каждую категорию, комнату сохраняемого чата и надстройку в базе данных 2007/2010Db, чтобы узнать, отображается ли она в базе данных 2013Db. Сравнение включает проверку всех параметров категории, комнаты чата или надстройки, всех участников в области действия в категории и любого участника в роли в категории или комнате чата. Если категория или комната чата неправильно отображаются в базе данных 2013Db, различия будут выводиться в файл конфликтов. Если после обновления база данных 2007/2010db будет изменена, а затем запустится это средство, в файле конфликтов будут отображаться различия. Обратите внимание, что это приложение является средством сравнения базы данных и не проверяет процесс обновления.

Требования

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

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

Файл ChatUpgradeVerifier.exe.config должен содержать параметр GroupChat2007R2Db или GroupChat2010Db со строкой подключения к соответствующей базе данных группового чата (Groupchat 2007R2 или 2010). Он также должен содержать параметр PersistentChat2013Db со строкой подключения к базе данных сохраняемого чата 2013.

Режим

Запустите ChatUpgradeVerifier без параметров.

Пример

Выполнение ChatUpgradeVerifier.exe.

Отчет об использовании сохраняемого чата

Описание

Средство ChatUsageReport создает HTML-отчет об использовании службы сохраняемого чата.

Требования

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

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

Файл, ChatUsageReport.exe.config, должен содержать раздел connectionStrings>, <определяющий строку подключения к серверной базе данных сохраняемого чата. Содержимое файла конфигурации по умолчанию содержится здесь для справки.

Режим

    ChatUsageReport [-StartDate {date}] [-EndDate {date}] [-TopActiveUsers {n}] [-TopActiveRooms {n}] [-LeastActiveRooms {n}] [-RoomsInactiveSince {Date}] [-OutputFolder {path}]

Эти параметры определяют выбор данных:

Startdate: При необходимости указывает дату начала периода выбора в формате UTC. По умолчанию: раннюю дату

Enddate: При необходимости указывает дату окончания периода выбора в формате UTC. По умолчанию: теперь

Эти параметры определяют, как и какие данные отображаются:

TopActiveUsers: Если этот параметр указан, отчет будет включать в себя n самых активных пользователей с точки зрения количества сообщений, опубликованных пользователем в комнате чата за выбранный период. Значение по умолчанию: 10

TopActiveRooms: Если этот параметр указан, отчет будет включать n самых активных комнат чата с точки зрения количества сообщений, опубликованных в комнате за выбранный период. Значение по умолчанию: 10

LeastActiveRooms: Если этот параметр указан, отчет будет включать в себя n наименее активных комнат чата с точки зрения количества сообщений, опубликованных в комнате чата за выбранный период. В комнатах будет опубликовано по крайней мере одно сообщение. Значение по умолчанию: 10

RoomsInactiveSince: Если этот параметр указан, отчет будет содержать список комнат чата, которые неактивны с указанной даты. По умолчанию: все время

OutputFolder: Папка, в ChatUsageReport.html и изображения графа. Он должен быть определен в файле конфигурации или в командной строке.

Все значения параметров командной строки также можно указать в ChatUsageReport.exe.config, который находится в том же каталоге, что и средство. Если в файле конфигурации и командной строке указано любое значение, значение командной строки переопределит значение файла конфигурации.

Выходные данные

Отчет всегда будет содержать следующие выходные данные:

  • N самых активных комнат чата по количеству записей сообщений за выбранный период.

  • N самых активных пользователей по количеству записей сообщений за выбранный период.

  • Первые n наименьших активных комнат чата по количеству записей сообщений за выбранный период.

  • Комнаты чата, которые неактивны в течение всего времени существования базы данных или с указанной даты.

  • Тенденция публикации ежедневных сообщений за выбранный период.

  • Тенденция публикации еженедельных сообщений за выбранный период.

  • Тенденция публикации ежемесячных сообщений за выбранный период.

  • Общее количество записей сообщений за выбранный период.

  • Общее количество включенных комнат.

Пример

В следующем примере создается отчет об использовании за весь 2001 год и он помещается в папку OutputFolder, указанную в ChatUsageReport.exe.config.

    ChatUsageReport -RoomsInactiveSince 06-20-2010

ChatUsageReport.exe.config:

    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
      <connectionStrings>
        <!-- The PersistentChat connection string must be defined in this file. -->
        <add name="PersistentChat" connectionString="Data Source=contoso.com\RTC;Initial Catalog=mgc;Integrated Security=SSPI"/>
      </connectionStrings>
      <appSettings>
        <!-- The OutputFolder must be defined here or on the command line. -->
        <add key="OutputFolder" value="."/>
        <!-- The values below are the same as the application defaults. -->
        <add key="StartDate" value="01/01/0001"/>
        <add key="EndDate" value="12/31/9999"/>
        <add key="TopActiveUsers" value="10"/>
        <add key="TopActiveRooms" value="10"/>
        <add key="LeastActiveRooms" value="10"/>
        <add key="RoomsInactiveSince" value="01/01/0001"/>
      </appSettings>
    </configuration></configuration>

ScheduleADSyncForPrincipal

Описание

ScheduleADSyncForPrincipal — это скрипт Microsoft SQL Server 2012, который должен выполняться непосредственно SQL Server Management Studio при подключении к серверной базе данных сохраняемого чата. Этот сценарий позволяет принудительно синхронизировать записи пользователя с записями пользователя из доменные службы Active Directory, а не ожидать запланированного времени синхронизации.

Требования

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

Режим

Ниже приведено содержимое скрипта по умолчанию:

    /*
    This script will schedule a principal for a forced AD synchronization cycle
    
    If you're using Sql Server Management Studio, pressing Ctrl+Shift+M will 
    allow you to specify values for the template parameter.
    */
    
        insert into
          tblPrincipalMeta
          (
           prinID
          ,prinAffiliationsDirty
          ,prinAttributesDirty
          ,prinDeleted
          )
          select
            prinID
           ,1
           ,1
           ,0
          from
            tblPrincipal
          where
            prinID not in (select prinID from tblPrincipalMeta) and
            prinID = <PrinID,int,0>
     
        update
          tblPrincipalMeta
        set
          prinAffiliationsDirty = 1
         ,prinAttributesDirty = 1
         ,tryCount = 0
         ,nextTry = null
        where
         prinID = <PrinID,int,0>