Lync Server 2013 常設チャットリソースキットツール

[アーティクル]
07/23/2014

トピック最終更新日時: 2013-02-24

Lync Server 2013 常設チャットリソースキットツールは、Lync Server 2013 常設チャットサーバーを展開および管理する IT 管理者にとって、日常的なタスクを容易にするのに役立ちます。このトピックでは、インストール手順に加えて、各ツールの目的とその使用例について説明します。

リソースキットツールのインストール

Lync Server 2013 Resource Kit Tools をインストールするには、 PersistentChatReskit.msiダウンロードします 。 PersistentChatReskit.msiを実行して、簡単なインストールを実行します。 .msiでは、\Program Files\ Microsoft Lync Server 2013\常設チャットサーバーリソースキットのすべてのツールがインストールされます。このフォルダーには、自己完結型のツールの実行可能ファイルが格納されます。ファイルを含むツールは、独自のサブフォルダーにあります。

大事な

Lync Server 2013 Resource Kit Tools をインストールした後、 PsExec.exe をインストールし、 PsExec.exe を次のパスにコピーする必要があります。\Program Files\ Microsoft Lync Server 2013\常設チャットサーバーリソースキット\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 Domain Servicesのレコードと一致することを確認します。

要件

このツールは、ドメインに参加しているコンピューターに PersistentChatResKit インストーラーと共にインストールされます。

ツールを実行するユーザーアカウントには、常設チャットバックエンドデータベースとActive Directory Domain Servicesへの読み取りアクセス権が必要です。

使用方法

構成ファイルの指示に従って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 ファイルには、常設チャットセッションの内訳が、セッションの合計数、成功したセッション数、予期しないエラー、予想されるエラー、および診断 ID、エラーの数、エラーの説明による予期しないエラーの内訳が含まれます。

要件

監視データベースにアクセスできるドメイン参加済みコンピューターに常設チャットリソースキットツールをインストールします。

ツールを実行するユーザーアカウントには、監視データベースへの読み取りアクセス権が必要です。

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...

常設チャットストレスツール

説明

常設チャットストレスツールを使用すると、予想される使用シナリオに適したさまざまなユーザーモデルを含む、実際のパフォーマンスをテストするために常設チャットの使用をシミュレートする簡単な方法が提供されます。

要件

常設チャットリソースキットツールを、常設チャットバックエンドデータベースにアクセスできるドメイン参加済みコンピューターにインストールします。

この コントローラー マシンに加えて、複数の ローダー マシンが必要になります。ユーザーモデル内の 10,000 人のユーザーごとに、ローダーマシンに少なくとも 4 GB の空き RAM が必要です。たとえば、ユーザーが 80,000 人の場合、すべてのローダーマシンに約 32 GB の RAM が必要になります。予想される負荷に関係なく、少なくとも 3 台のローダーマシンを使用することをお勧めします。

ローダーマシンには、.NET 4.5 Framework と Visual C++ 2012 再頒布可能プログラムがインストールされている必要があります。

構成

ChatStressTool ファイルを、すべてのローダーマシンからアクセスできる共有フォルダーにコピーします。

ストレス実行で使用するユーザーとチャネルを作成します。

ユーザーモデルが呼び出す数のユーザーを作成し、Lync で有効にし、常設チャットポリシーを [有効] に設定します。
ストレスチャネルのカテゴリを作成し、そのカテゴリの下に必要な数の会議室を作成します。カテゴリには、(OU を追加して) すべてのストレスユーザーを許可リストに含める必要があり、ストレスルームのプライバシー設定は [開く] にする必要があります。
余分なストレスルームを作成することをお勧めします。次のWindows PowerShellコマンドラインインターフェイスコマンドを使用して、50,000 個のルームを作成できます。
```
    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:

"LoaderBinary" 設定値を共有フォルダーのパスに変更します。
ローダーマシンへの管理者アクセス権を持つ資格情報に "AdminUser"/"AdminPassword" を変更します。
"ChannelCategory" を、ストレスチャネルが作成されたカテゴリの名前に変更します。
"UserNamePattern" と "UserPasswordPattern" を、ストレスユーザーの資格情報と一致するテンプレートに変更します。 {0} は、ユーザーのインデックス番号に置き換えられます。
"Domain" をテストトポロジの SIP ドメインに変更します。
常設チャットバックエンドデータベースの接続文字列に "ConnectionString" を変更します。
"UserIndexStart" を最初のストレスユーザーのインデックスに変更します。
"LyncFQDN" をフロントエンドプールの FQDN に変更します。
すべてのローダーマシンのマシン名を含めるには、"Machines" リストを変更します。
サービスエンドポイントの baseAddress (既定値は "controller.contoso.com") をコントローラーコンピューターの FQDN に変更します。

使用方法

構成が完了したら、コントローラーコンピューターでStressLauncher.exeを開きます。任意のユーザーとして StressLauncher を起動できます。ローダーマシンでローダープロセスを開始する資格情報は、構成ファイルで指定する必要があります。また、常設チャットバックエンドデータベースへの読み取りアクセス権を持つ接続文字列も指定する必要があります。この接続文字列で統合Windows 認証を使用する場合は、このアクセス権を持つユーザーとして StressLauncher を起動する必要があります。

必要に応じて、ユーザーモデルの設定を変更します。 [ 読み込みの開始] をクリックして実行を開始します。 1 分ほどすると、ユーザーがサインインし始め、進行状況バーの入力が開始されます。この時点で、コントローラーマシンが動作し、パフォーマンス測定を行うことができます。

ChatUpgradeVerifier

説明

ChatUpgradeVerifier は、常設チャット固有のデータベース比較ツールです。このツールは、グループチャット 2007 R2 またはグループチャット 2010 データベース (2007/2010Db) を常設チャット 2013 データベース (2013Db) と比較します。

このツールは、2007/2010Db で各カテゴリ、常設チャットルーム、アドインを 1 つずつ確認して、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: これを指定すると、選択した期間にルームに投稿されたメッセージの数に関して、最もアクティブなチャットルームがレポートに含まれます。既定値: 10

LeastActiveRooms: これが指定されている場合、レポートには、選択した期間にチャットルームに投稿されたメッセージの数に関して、最もアクティブでないチャットルームが含まれます。ルームには、少なくとも 1 つのメッセージが投稿されます。既定値: 10

RoomsInactiveSince: これが指定されている場合、レポートには、指定した日付以降に非アクティブになっているチャットルームの一覧が含まれます。既定値: 全時間

OutputFolder: ChatUsageReport.htmlとグラフの画像が配置されるフォルダー。これは、構成ファイルまたはコマンドラインで定義する必要があります。

すべてのコマンドラインパラメーター値は、ツールと同じディレクトリにあるChatUsageReport.exe.config ファイルで指定することもできます。構成ファイルとコマンドラインの両方で値が指定されている場合、コマンドラインの値によって構成ファイルの値がオーバーライドされます。

出力

レポートには常に次の出力が含まれます。

選択した期間のメッセージ投稿の数で、最もアクティブなチャットルームの上位 n 個。
選択した期間のメッセージ投稿の数で、最もアクティブな上位 n 人のユーザー。
選択した期間のメッセージ投稿の数で、アクティブなチャットルームが最も少ない上位 n 個。
データベースの有効期間全体、または指定された日付以降に非アクティブになっているチャットルーム。
選択した期間の毎日のメッセージ投稿の傾向。
選択した期間の週次メッセージ投稿の傾向。
選択した期間の月次メッセージ投稿の傾向。
選択した期間のメッセージ投稿の合計。
有効な会議室の合計数。

例

次の例では、2001 年全体の使用状況レポートを生成し、ChatUsageReport.exe.configで指定された OutputFolder にレポートを配置します。

    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 Domain Servicesのレコードと同期することができます。

要件

スクリプトを実行するユーザーアカウントには、常設チャットバックエンドデータベースへの所有者アクセス権が必要です。

使用方法

既定のスクリプトの内容を次に示します。

    /*
    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>

Lync Server 2013 常設チャット リソース キット ツール

リソース キット ツールのインストール

サポートされる環境

リソース キット ツールの概要

AffCheck

説明

要件

使用方法

ChatMonitoringSummary

説明

要件

使用方法

例

常設チャット ストレス ツール

説明

要件

構成

使用方法

ChatUpgradeVerifier

説明

要件

使用方法

例

常設チャットの使用状況レポート

説明

要件

使用方法

出力

例

ScheduleADSyncForPrincipal

説明

要件

使用方法

その他のリソース

Lync Server 2013 常設チャットリソースキットツール

リソースキットツールのインストール

リソースキットツールの概要

常設チャットストレスツール