Outils du Kit de ressources de conversation permanente Lync Server 2013

Description

L’outil AffCheck confirme que les enregistrements d’affiliation des utilisateurs et des groupes de la base de données principale de conversation permanente correspondent à celui de services de domaine Active Directory.

Conditions requises

L’outil est installé avec le programme d’installation de PersistentChatResKit sur un ordinateur joint à un domaine.

Le compte d’utilisateur sous lequel l’outil est exécuté doit disposer d’un accès en lecture à la base de données principale de conversation permanente et services de domaine Active Directory.

Utilisation

Configurez le fichier AffCheck.exe.config conformément aux instructions du fichier de configuration et exécutez l’outil AffCheck sans paramètres de ligne de commande. Voici le contenu de la AffCheck.exe.config par défaut.

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>

Description

L’outil PersistentChatMonitoringSummary déplace les informations de surveillance de conversation permanente de la base de données de surveillance vers un fichier journal CSV spécifié.

Le fichier CSV contient une répartition des sessions de conversation permanente par nombre total de sessions, de sessions réussies, d’échecs inattendus, d’échecs attendus et d’une répartition des échecs inattendus par ID de diagnostic, nombre d’échecs et description des échecs.

Conditions requises

Installez les outils du Kit de ressources de conversation permanente sur un ordinateur joint à un domaine qui a accès à la base de données de surveillance.

Le compte d’utilisateur sous lequel l’outil s’exécute doit avoir un accès en lecture à la base de données de surveillance.

Le fichier, PersistentChatMonitoringSummary.exe.config, doit contenir une <section connectionStrings> qui définit la chaîne de connexion à la base de données de surveillance. Il doit également contenir une clé pour PersistentChatEndpointUri pour laquelle les données de surveillance seront collectées, ainsi qu’un chemin d’accès à un emplacement pour le fichier CSV qui sera généré. Reportez-vous au fichier de configuration installé pour obtenir des exemples. Le fichier doit se trouver dans le même répertoire que l’outil.

Utilisation

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

Ces paramètres définissent la sélection des données :

StartDateTime : Spécifie éventuellement la date de début de la période de sélection. Par défaut : 1/1/1753 12:00:00

EndDateTime : Spécifie éventuellement la dernière date de la période de sélection. Par défaut : maintenant

Exemple

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

Description

L’outil De stress de conversation permanente offre un moyen simple de simuler l’utilisation de la conversation permanente pour tester les performances réelles, y compris des modèles utilisateur variés pour mieux s’adapter aux scénarios d’utilisation attendus.

Conditions requises

Installez les outils du Kit de ressources de conversation permanente sur un ordinateur joint à un domaine qui a accès à la base de données principale de conversation permanente.

En plus de cet ordinateur de contrôleur , vous aurez besoin de plusieurs machines de chargeur . Pour chaque 10 000 utilisateurs de votre modèle utilisateur, vous aurez besoin d’au moins 4 Go de RAM gratuite sur un chargeur. Par exemple, une exécution avec 80 000 utilisateurs nécessite environ 32 Go de RAM réparties sur toutes les machines de chargeur. Nous vous recommandons d’avoir au moins trois machines de chargeur, quelle que soit la charge attendue.

Le .NET 4.5 Framework et Visual C++ 2012 Redistributable doivent être installés sur les machines de charge.

Configuration

Copiez les fichiers ChatStressTool dans un dossier partagé accessible à partir de toutes les machines de chargeur.

Créez des utilisateurs et des canaux à utiliser dans l’exécution de contrainte :

• Créez autant d’utilisateurs que vos appels de modèle utilisateur, activez-les pour Lync et définissez leur stratégie de conversation permanente sur Activé.

• Créez une catégorie pour vos canaux de contrainte, puis créez autant de salles que nécessaire sous cette catégorie. La catégorie doit contenir tous les utilisateurs stressés dans sa liste Autorisée (en ajoutant leur unité d’organisation) et les salles de stress doivent avoir un paramètre de confidentialité Open.

• Nous vous recommandons de créer des salles de stress supplémentaires. Vous pouvez créer 50 000 salles avec la commande d’interface de ligne de commande Windows PowerShell suivante :

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

Modifiez les fichiers de configuration en fonction de votre topologie :

Dans LoaderProcess.exe.config, remplacez « controller.contoso.com » par le nom de domaine complet (FQDN) de l’ordinateur du contrôleur.

Dans StressLauncher.exe.config :

1. Remplacez la valeur du paramètre « LoaderBinary » par le chemin d’accès du dossier partagé.

2. Remplacez « AdminUser »/« AdminPassword » par les informations d’identification qui ont un accès administrateur aux machines de chargeur.

3. Remplacez « ChannelCategory » par le nom de la catégorie sous laquelle les canaux de contrainte ont été créés.

4. Remplacez « UserNamePattern » et « UserPasswordPattern » par un modèle qui correspond à vos informations d’identification utilisateur stressantes. {0} est remplacé par le numéro d’index de l’utilisateur.

5. Remplacez « Domaine » par le domaine SIP de votre topologie de test.

6. Remplacez « ConnectionString » par une chaîne de connexion pour votre base de données principale de conversation permanente.

7. Remplacez « UserIndexStart » par l’index du premier utilisateur stressé.

8. Remplacez « LyncFQDN » par le nom de domaine complet de votre pool frontal.

9. Modifiez la liste « Machines » pour inclure les noms d’ordinateurs pour toutes vos machines de chargeur.

10. Remplacez la baseAddress du point de terminaison de service (la valeur par défaut est « controller.contoso.com ») par le nom de domaine complet de votre ordinateur de contrôleur.

Utilisation

Une fois la configuration terminée, ouvrez StressLauncher.exe sur l’ordinateur du contrôleur. Vous pouvez lancer StressLauncher en tant qu’utilisateur. Les informations d’identification sous lesquelles les processus du chargeur démarrent sur les machines du chargeur doivent être spécifiées dans le fichier de configuration. Vous devez également donner une chaîne de connexion qui dispose d’un accès en lecture à la base de données principale de conversation permanente. Si cette chaîne de connexion utilise des Authentification Windows intégrés, vous devez lancer StressLauncher en tant qu’utilisateur disposant de cet accès.

Modifiez les paramètres du modèle utilisateur en fonction des besoins. Cliquez sur Démarrer la charge pour lancer une exécution. Au bout d’une minute, les utilisateurs commencent à se connecter et la barre de progression commence à se remplir. À ce stade, vous pouvez utiliser la machine du contrôleur et prendre des mesures de performances.

Description

ChatUpgradeVerifier est un outil de comparaison de base de données spécifique à la conversation permanente. L’outil compare la base de données Group Chat 2007 R2 ou Group Chat 2010 (2007/2010Db) à la base de données Conversation permanente 2013 (2013Db).

L’outil vérifie, un par un, chaque catégorie, salle de conversation permanente et complément dans 2007/2010Db pour voir s’il apparaît dans la base de données 2013Db. La comparaison inclut la vérification de tous les paramètres de la catégorie, de la salle de conversation ou du complément, de tous les principaux dans l’étendue de la catégorie et de tout principal dans un rôle sur la catégorie ou la salle de conversation. Si une catégorie ou une salle de conversation n’apparaît pas correctement dans 2013Db, les différences sont générées dans un fichier de conflits. Si, une fois la mise à niveau effectuée, la base de données 2007/2010Db est modifiée et que cet outil est exécuté, il y aura une sortie de différences dans le fichier de conflits. Notez que cette application est un outil de comparaison de base de données uniquement et ne valide pas le processus de mise à niveau.

Conditions requises

Installez les outils du Kit de ressources de conversation permanente sur un ordinateur joint à un domaine qui a accès aux bases de données back-end de conversation permanente (versions précédentes et actuelles pour la conversation permanente).

Le compte d’utilisateur sous lequel l’outil s’exécute doit disposer d’un accès en lecture aux bases de données de conversation permanente.

Le fichier ChatUpgradeVerifier.exe.config doit contenir le paramètre GroupChat2007R2Db ou le paramètre GroupChat2010Db, avec une chaîne de connexion à la base de données de conversation de groupe appropriée (Groupchat 2007R2 ou 2010). Il doit également contenir un paramètre PersistentChat2013Db, avec une chaîne de connexion à la base de données Persistent Chat 2013.

Utilisation

Exécutez ChatUpgradeVerifier sans aucun paramètre.

Exemple

Description

L’outil ChatUsageReport génère un rapport HTML sur l’utilisation du service conversation permanente.

Conditions requises

Installez les outils du Kit de ressources de conversation permanente sur un ordinateur joint à un domaine qui a accès à la base de données principale de conversation permanente.

Le compte d’utilisateur sous lequel l’outil est exécuté doit disposer d’un accès en lecture à la base de données principale de conversation permanente.

Le fichier, ChatUsageReport.exe.config, doit contenir une <section connectionStrings> définissant la chaîne de connexion à la base de données principale de conversation permanente. Le contenu du fichier de configuration par défaut est inclus ici, pour votre référence.

Utilisation

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

Ces paramètres définissent la sélection des données :

Startdate: Spécifie éventuellement la date de début UTC de la période de sélection. Par défaut : Date la plus ancienne

EndDate : Spécifie éventuellement la date de fin UTC de la période de sélection. Par défaut : maintenant

Ces paramètres définissent comment et quelles données sont affichées :

TopActiveUsers : Si cette valeur est spécifiée, le rapport inclut les n utilisateurs les plus actifs en termes de nombre de messages que l’utilisateur a publiés dans la salle de conversation pour la période sélectionnée. Valeur par défaut : 10

TopActiveRooms : Si cette valeur est spécifiée, le rapport inclut les n salles de conversation les plus actives en termes de nombre de messages publiés dans la salle pour la période sélectionnée. Valeur par défaut : 10

LeastActiveRooms : Si cette valeur est spécifiée, le rapport inclut les salles de conversation les moins actives en termes de nombre de messages publiés dans la salle de conversation pour la période sélectionnée. Les salles auront au moins un message publié. Valeur par défaut : 10

RoomsInactiveSince : Si cette valeur est spécifiée, le rapport inclut une liste de salles de conversation inactives depuis la date spécifiée. Valeur par défaut : temps entier

OutputFolder : Dossier dans lequel le ChatUsageReport.html et les images de graphe seront placés. Cela doit être défini dans le fichier de configuration ou sur la ligne de commande.

Toutes les valeurs des paramètres de ligne de commande peuvent également être spécifiées dans le fichier ChatUsageReport.exe.config qui se trouve dans le même répertoire que l’outil. Si une valeur est spécifiée à la fois dans le fichier de configuration et dans la ligne de commande, la valeur de ligne de commande remplace la valeur du fichier de configuration.

Sortie

Le rapport inclut toujours la sortie suivante :

• Top n salles de conversation les plus actives par nombre de messages pour la période sélectionnée.

• Nombre maximal d’utilisateurs actifs par nombre de messages pour la période sélectionnée.

• N premières salles de conversation les moins actives par nombre de publications de messages pour la période sélectionnée.

• Salles de conversation inactives pendant toute la durée de vie de la base de données, ou depuis la date spécifiée.

• Tendance quotidienne des publications de messages pour la période sélectionnée.

• Tendance hebdomadaire des publications de messages pour la période sélectionnée.

• Tendance de publication des messages mensuels pour la période sélectionnée.

• Nombre total de publications de messages pour la période sélectionnée.

• Nombre total de salles activées.

Exemple

L’exemple suivant génère un rapport d’utilisation pour l’ensemble de l’année 2001 et place le rapport dans le OutputFolder spécifié dans le 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>

Description

ScheduleADSyncForPrincipal est un script Microsoft SQL Server 2012 qui doit être exécuté directement à partir de SQL Server Management Studio lorsqu’il est connecté à la base de données principale de conversation permanente. Ce script vous permet de forcer la conversation permanente à synchroniser ses enregistrements d’un utilisateur avec ceux de services de domaine Active Directory, au lieu d’attendre l’heure de synchronisation planifiée.

Conditions requises

Le compte d’utilisateur sous lequel le script est exécuté doit avoir un accès propriétaire à la base de données principale de conversation permanente.

Utilisation

Voici le contenu du script par défaut :

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