Ressourcenkittools für beständigen Chat in Lync Server 2013

Beschreibung

Das AffCheck-Tool bestätigt, dass die Datensätze der Back-End-Datenbankbenutzer und der Gruppenzugehörigkeit für beständigen Chat mit denen von Active Directory Domain Services übereinstimmen.

Anforderungen

Das Tool wird mit dem PersistentChatResKit-Installationsprogramm auf einem in die Domäne eingebundenen Computer installiert.

Das Benutzerkonto, unter dem das Tool ausgeführt wird, muss Lesezugriff auf die Back-End-Datenbank für beständigen Chat und Active Directory Domain Services haben.

Verwendung

Konfigurieren Sie die AffCheck.exe.config Datei gemäß den Anweisungen in der Konfigurationsdatei, und führen Sie das AffCheck-Tool ohne Befehlszeilenparameter aus. Nachfolgend sehen Sie den Inhalt der Standard-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>

Beschreibung

Das PersistentChatMonitoringSummary-Tool verschiebt Überwachungsinformationen für beständigen Chat aus der Überwachungsdatenbank in eine angegebene CSV-Protokolldatei.

Die CSV-Datei enthält eine Aufschlüsselung der Sitzungen für beständigen Chat nach Anzahl der Gesamtsitzungen, erfolgreichen Sitzungen, unerwarteten Fehlern, erwarteten Fehlern und einer Aufschlüsselung der unerwarteten Fehler nach Diagnose-ID, Anzahl der Fehler und Fehlerbeschreibung.

Anforderungen

Installieren Sie die Resource Kit-Tools für beständigen Chat auf einem in die Domäne eingebundenen Computer, der Zugriff auf die Überwachungsdatenbank hat.

Das Benutzerkonto, unter dem das Tool ausgeführt wird, muss Lesezugriff auf die Überwachungsdatenbank haben.

Die Datei PersistentChatMonitoringSummary.exe.config muss einen <ConnectionStrings-Abschnitt> enthalten, der die Verbindungszeichenfolge zur Überwachungsdatenbank definiert. Es muss auch einen Schlüssel für den PersistentChatEndpointUri enthalten, für den die Überwachungsdaten gesammelt werden, und einen Dateipfad zu einem Speicherort für die CSV-Datei, die generiert wird. Beispiele finden Sie in der installierten Konfigurationsdatei. Die Datei muss sich im selben Verzeichnis wie das Tool befinden.

Verwendung

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

Diese Parameter definieren die Auswahl von Daten:

StartDateTime: Gibt optional das Startdatum des Auswahlzeitraums an. Standard: 1/1/1753 12:00:00 AM

EndDateTime: Gibt optional das letzte Datum des Auswahlzeitraums an. Standard: Jetzt

Beispiel

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

Beschreibung

Das Tool "Stress für beständigen Chat" bietet eine einfache Möglichkeit, die Verwendung des beständigen Chats zu simulieren, um die reale Leistung zu testen, einschließlich verschiedener Benutzermodelle, um ihre erwarteten Nutzungsszenarien besser zu erfüllen.

Anforderungen

Installieren Sie die Resource Kit-Tools für beständigen Chat auf einem in die Domäne eingebundenen Computer, der Zugriff auf die Back-End-Datenbank für beständigen Chat hat.

Zusätzlich zu diesem Controllercomputer benötigen Sie mehrere Lademaschinen . Für jeden 10K-Benutzer in Ihrem Benutzermodell benötigen Sie mindestens 4 GB freien RAM auf einem Ladegerät. Beispielsweise erfordert eine Ausführung mit 80K-Benutzern etwa 32 GB RAM, die auf alle Lademaschinen verteilt sind. Es wird empfohlen, unabhängig von der erwarteten Last mindestens drei Lademaschinen zu verwenden.

Auf Ladecomputern müssen .NET 4.5 Framework und Visual C++ 2012 Redistributable installiert sein.

Konfiguration

Kopieren Sie ChatStressTool-Dateien in einen freigegebenen Ordner, auf den von allen Ladecomputern zugegriffen werden kann.

Erstellen Sie Benutzer und Kanäle für die Verwendung im Stresslauf:

• Erstellen Sie so viele Benutzer, wie ihr Benutzermodell aufruft, aktivieren Sie sie für Lync, und legen Sie ihre Richtlinie für beständigen Chat auf "Aktiviert" fest.

• Erstellen Sie eine Kategorie für Ihre Stresskanäle, und erstellen Sie dann so viele Räume, wie unter dieser Kategorie benötigt werden. Die Kategorie sollte alle Stressbenutzer in der Liste "Zulässig " (durch Hinzufügen ihrer ORGANISATIONSeinheit) enthalten, und Stressrooms sollten über die Datenschutzeinstellung "Öffnen" verfügen.

• Wir empfehlen, zusätzliche Stressräume zu erstellen. Sie können 50.000 Räume mit dem folgenden Befehl Windows PowerShell Befehlszeilenschnittstelle erstellen:

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

Bearbeiten Sie die Konfigurationsdateien an Ihre Topologie:

Ändern Sie inLoaderProcess.exe.config"controller.contoso.com" in den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Controllercomputers.

In StressLauncher.exe.config:

1. Ändern Sie den Einstellungswert "LoaderBinary" in den Pfad des freigegebenen Ordners.

2. Ändern Sie "AdminUser"/"AdminPassword" in Anmeldeinformationen, die Administratorzugriff auf Ladecomputer haben.

3. Ändern Sie "ChannelCategory" in den Namen der Kategorie, unter der Stresskanäle erstellt wurden.

4. Ändern Sie "UserNamePattern" und "UserPasswordPattern" in eine Vorlage, die Ihren stressbasierten Benutzeranmeldeinformationen entspricht. {0} wird durch die Indexnummer des Benutzers ersetzt.

5. Ändern Sie "Domäne" in die SIP-Domäne Ihrer Testtopologie.

6. Ändern Sie "ConnectionString" in eine Verbindungszeichenfolge für Ihre Back-End-Datenbank für beständigen Chat.

7. Ändern Sie "UserIndexStart" in den Index des ersten Stressbenutzers.

8. Ändern Sie "LyncFQDN" in den FQDN Ihres Front-End-Pools.

9. Ändern Sie die Liste "Computer", um Computernamen für alle Lademaschinen einzuschließen.

10. Ändern Sie die baseAddress des Dienstendpunkts (Standardwert ist "controller.contoso.com") in den FQDN Ihres Controllercomputers.

Verwendung

Öffnen Sie nach Abschluss der Konfiguration StressLauncher.exe auf dem Controllercomputer. Sie können StressLauncher als jeden Benutzer starten. Die Anmeldeinformationen, unter denen die Ladeprogrammprozesse auf den Ladecomputern gestartet werden, müssen in der Konfigurationsdatei angegeben werden. Sie müssen auch eine Verbindungszeichenfolge mit Lesezugriff auf die Back-End-Datenbank für beständigen Chat bereitstellen. Wenn diese Verbindungszeichenfolge integrierte Windows-Authentifizierung verwendet, müssen Sie StressLauncher als Benutzer starten, der diesen Zugriff hat.

Ändern Sie die Benutzermodelleinstellungen nach Bedarf. Klicken Sie auf "Laden starten ", um eine Ausführung zu initiieren. Nach einer Minute oder so beginnen die Benutzer, angemeldet zu werden, und die Statusanzeige beginnt zu füllen. An diesem Punkt können Sie die Controllermaschine arbeiten und Leistungsmessungen durchführen.

Beschreibung

ChatUpgradeVerifier ist ein spezifisches Datenbankvergleichstool für beständigen Chat. Das Tool vergleicht entweder die Datenbank "Gruppenchat 2007 R2" oder "Gruppenchat 2010" (2007/2010Db) mit der Datenbank für beständigen Chat 2013 (2013Db).

Das Tool überprüft 2007/2010Db nacheinander jede Kategorie, jeden Chatroom und jedes Add-In, um festzustellen, ob es in der 2013Db angezeigt wird. Der Vergleich umfasst das Überprüfen aller Einstellungen für die Kategorie, den Chatroom oder das Add-In, alle Prinzipale im Bereich der Kategorie und jeden Prinzipal in einer Rolle in der Kategorie oder im Chatroom. Wenn eine Kategorie oder ein Chatroom in der 2013Db nicht ordnungsgemäß angezeigt wird, werden die Unterschiede in eine Konfliktdatei ausgegeben. Wenn nach dem Upgrade die 2007/2010Db geändert wird und dieses Tool ausgeführt wird, gibt es eine Ausgabe von Unterschieden in der Konfliktdatei. Beachten Sie, dass diese Anwendung nur ein Datenbankvergleichstool ist und den Upgradevorgang nicht überprüft.

Anforderungen

Installieren Sie die Resource Kit-Tools für beständigen Chat auf einem in die Domäne eingebundenen Computer, der Zugriff auf die Back-End-Datenbanken für beständigen Chat hat (frühere und aktuelle Versionen für beständigen Chat).

Das Benutzerkonto, unter dem das Tool ausgeführt wird, muss Lesezugriff auf die Datenbanken für beständigen Chat haben.

Die ChatUpgradeVerifier.exe.config Datei muss entweder den Parameter "GroupChat2007R2Db" oder den Parameter "GroupChat2010Db" mit einer Verbindungszeichenfolge zur entsprechenden Gruppenchatdatenbank (entweder Groupchat 2007R2 oder 2010) enthalten. Es muss auch einen PersistentChat2013Db-Parameter mit einer Verbindungszeichenfolge zur Datenbank für beständigen Chat 2013 enthalten.

Verwendung

Führen Sie ChatUpgradeVerifier ohne Parameter aus.

Beispiel

Beschreibung

Das ChatUsageReport-Tool generiert einen HTML-Bericht über die Nutzung des Diensts für beständigen Chat.

Anforderungen

Installieren Sie die Resource Kit-Tools für beständigen Chat auf einem in die Domäne eingebundenen Computer, der Zugriff auf die Back-End-Datenbank für beständigen Chat hat.

Das Benutzerkonto, unter dem das Tool ausgeführt wird, muss Lesezugriff auf die Back-End-Datenbank für beständigen Chat haben.

Die Datei ChatUsageReport.exe.config muss einen <ConnectionStrings-Abschnitt> enthalten, der die Verbindungszeichenfolge für die Back-End-Datenbank für beständigen Chat definiert. Der Inhalt der Standardkonfigurationsdatei wird hier als Referenz hinzugefügt.

Verwendung

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

Diese Parameter definieren die Auswahl von Daten:

Startdate: Gibt optional den UTC-Starttermin des Auswahlzeitraums an. Standard: Frühestes Datum

Enddate: Gibt optional das UTC-Enddatum des Auswahlzeitraums an. Standard: Jetzt

Diese Parameter definieren, wie und welche Daten angezeigt werden:

TopActiveUsers: Wenn dies angegeben ist, enthält der Bericht die n aktivsten Benutzer im Hinblick auf die Anzahl der Nachrichten, die der Benutzer im Chatroom für den ausgewählten Zeitraum gepostet hat. Standard: 10

TopActiveRooms: Wenn dies angegeben ist, enthält der Bericht die n aktivsten Chatrooms im Hinblick auf die Anzahl der Nachrichten, die im Chatroom für den ausgewählten Zeitraum gepostet wurden. Standard: 10

LeastActiveRooms: Wenn dies angegeben ist, enthält der Bericht die n am wenigsten aktiven Chatrooms im Hinblick auf die Anzahl der Nachrichten, die im Chatroom für den ausgewählten Zeitraum gepostet wurden. In Chatrooms wird mindestens eine Nachricht gepostet. Standard: 10

RoomsInactiveSince: Wenn dies angegeben ist, enthält der Bericht eine Liste der Chatrooms, die seit dem angegebenen Datum inaktiv waren. Standard: Ganze Zeit

OutputFolder: Der Ordner, in dem die ChatUsageReport.html und die Diagrammbilder platziert werden. Dies muss in der Konfigurationsdatei oder in der Befehlszeile definiert werden.

Alle Befehlszeilenparameterwerte können auch in der ChatUsageReport.exe.config Datei angegeben werden, die sich im selben Verzeichnis wie das Tool befindet. Wenn sowohl in der Konfigurationsdatei als auch in der Befehlszeile ein Wert angegeben ist, überschreibt der Befehlszeilenwert den Wert der Konfigurationsdatei.

Ausgabe

Der Bericht enthält immer die folgende Ausgabe:

• Die n aktivsten Chatrooms nach der Anzahl der Nachrichtenbeiträge für den ausgewählten Zeitraum.

• Die n aktivsten Benutzer nach Anzahl der Nachrichtenbeiträge für den ausgewählten Zeitraum.

• Die obersten n am wenigsten aktiven Chatrooms nach der Anzahl der Nachrichtenbeiträge für den ausgewählten Zeitraum.

• Chatrooms, die während der gesamten Lebensdauer der Datenbank oder seit dem angegebenen Datum inaktiv sind.

• Tagesnachrichtenbeitragstrend für ausgewählten Zeitraum.

• Wöchentlicher Nachrichtenbeitragstrend für den ausgewählten Zeitraum.

• Monatlicher Nachrichtenbeitragstrend für den ausgewählten Zeitraum.

• Nachrichtenbeiträge für den ausgewählten Zeitraum insgesamt.

• Gesamtanzahl der aktivierten Räume.

Beispiel

Im folgenden Beispiel wird ein Nutzungsbericht für das gesamte Jahr 2001 generiert und der Bericht in das outputFolder-Element eingefügt, das in der ChatUsageReport.exe.config angegeben ist.

    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>

Beschreibung

ScheduleADSyncForPrincipal ist ein Microsoft SQL Server 2012-Skript, das direkt in SQL Server Management Studio ausgeführt werden muss, wenn eine Verbindung mit der Back-End-Datenbank für beständigen Chat besteht. Mit diesem Skript können Sie erzwingen, dass der beständige Chat seine Datensätze eines Benutzers mit denen von Active Directory Domain Services synchronisiert, anstatt auf die geplante Synchronisierungszeit zu warten.

Anforderungen

Das Benutzerkonto, unter dem das Skript ausgeführt wird, muss über Besitzerzugriff auf die Back-End-Datenbank für beständigen Chat verfügen.

Verwendung

Im Folgenden sehen Sie den Inhalt des Standardskripts:

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