Herramientas del kit de recursos de chat persistente de Lync Server 2013
Última modificación del tema: 2013-02-24
Las herramientas del kit de recursos de chat persistente de Lync Server 2013 ayudan a facilitar las tareas rutinarias a los administradores de TI que implementan y administran Lync Server 2013 Persistent Chat Server. Además de las instrucciones de instalación, en este tema se describe el propósito de cada herramienta y ejemplos de su uso.
Instalación de las herramientas del kit de recursos
Para instalar Lync Server 2013, Resource Kit Tools, descargue PersistentChatReskit.msi. Ejecute PersistentChatReskit.msi para realizar una instalación sencilla. La .msi instala todas las herramientas en la siguiente ruta: \Archivos de programa\ Microsoft Lync Server 2013\Kit de recursos de servidor de chat persistente. Las herramientas que son ejecutables independientes se encuentran en esta carpeta. Las herramientas que también tienen archivos están en sus propias subcarpetas.
Importante
Después de instalar Lync Server 2013, Resource Kit Tools, debe instalar PsExec.exe y copiar PsExec.exe a la siguiente ruta: \Archivos de programa\ Microsoft Lync Server 2013\Persistent Chat Server Resource Kit\ChatStressTool. Si no copia PsExec.exe, la herramienta de esfuerzo de chat persistente producirá una excepción de error y no funcionará correctamente. Asegúrese de cumplir este requisito previo antes de ejecutar la herramienta. Para obtener más información sobre la instalación dePsExec.exe, consulta https://go.microsoft.com/fwlink/p/?LinkId=282246.
Entornos compatibles
Para obtener un rendimiento óptimo, las herramientas del kit de recursos de Lync Server 2013 deben instalarse en el mismo entorno y con las mismas especificaciones necesarias para Lync Server 2013.
Información general sobre las herramientas del kit de recursos
Estas son las herramientas que se proporcionan en el kit de recursos de chat persistente de Lync Server 2013. La siguiente sección proporciona una descripción de cada herramienta, incluidos los requisitos y el uso de ejemplo.
AffCheck
ChatMonitoringSummary
Herramienta ChatStress
ChatUpgradeVerifier
ChatUsageReport
ScheduleADSyncforPrincipal
AffCheck
Descripción
La herramienta AffCheck confirma que los registros de afiliación de grupo y usuario de la base de datos back-end de chat persistente coinciden con los de Servicios de dominio de Active Directory.
Requirements
La herramienta se instala con el instalador PersistentChatResKit en un equipo unido a un dominio.
La cuenta de usuario en la que se ejecuta la herramienta debe tener acceso de lectura a la base de datos back-end del chat persistente y Servicios de dominio de Active Directory.
Uso
Configure el archivo de AffCheck.exe.config según las instrucciones del archivo de configuración y ejecute la herramienta AffCheck sin parámetros de la línea de comandos. A continuación se muestran los contenidos de la AffCheck.exe.config predeterminada.
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
Descripción
La herramienta persistentChatMonitoringSummary mueve la información de supervisión de chat persistente de la base de datos de supervisión a un archivo de registro CSV especificado.
El archivo CSV contendrá un desglose de las sesiones de chat persistente por número de sesiones totales, sesiones correctas, errores inesperados, errores esperados y un desglose de los errores inesperados por id. de diagnóstico, número de errores y descripción de errores.
Requirements
Instale las herramientas del kit de recursos de chat persistente en un equipo unido a un dominio que tenga acceso a la base de datos de supervisión.
La cuenta de usuario en la que se ejecuta la herramienta debe tener acceso de lectura a la base de datos de supervisión.
El archivo, PersistentChatMonitoringSummary.exe.config, debe contener una <sección connectionStrings> que defina la cadena de conexión a la base de datos Supervisión. También debe contener una clave para el PersistentChatEndpointUri para la que se recopilarán los datos de supervisión y una ruta de acceso de archivo a una ubicación para el archivo CSV que se generará. Refiera al archivo de configuración instalado para los ejemplos. El archivo debe encontrarse en el mismo directorio que la herramienta.
Uso
PersistentChatMonitoringSummary [-StartDateTime <date>] [-EndDateTime <date>]
Estos parámetros definen la selección de datos:
StartDateTime: Opcionalmente, especifica la fecha de inicio del período de selección. Valor predeterminado: 1/1/1753 12:00:00 AM
EndDateTime: Opcionalmente, especifica la última fecha del período de selección. Valor predeterminado: Ahora
Ejemplo
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...
Herramienta de esfuerzo de chat persistente
Descripción
La herramienta Tensión de chat persistente proporciona una forma sencilla de simular el uso del chat persistente para probar el rendimiento real, incluidos diversos modelos de usuario para adaptarse mejor a los escenarios de uso esperados.
Requirements
Instale las herramientas del kit de recursos de chat persistente en un equipo unido a un dominio que tenga acceso a la base de datos back-end del chat persistente.
Además de esta máquina controladora , necesitarás varias máquinas cargadoras . Por cada 10 000 usuarios de su modelo de usuario, necesitará al menos 4 GB de RAM libre en una máquina cargadora. Por ejemplo, una ejecución con 80 000 usuarios requerirá aproximadamente 32 GB de RAM repartidos entre todas las máquinas cargadoras. Le recomendamos que tenga al menos tres cargadores, independientemente de la carga esperada.
Los equipos cargadores deben tener instalado .NET 4.5 Framework, así como Visual C++ 2012 Redistributable.
Configuración
Copie archivos ChatStressTool en una carpeta compartida accesible desde todos los equipos cargadores.
Cree usuarios y canales para su uso en la ejecución de la tensión:
Cree tantos usuarios como su modelo de usuario llame, habilítelos para Lync y establezca su directiva de chat persistente en Habilitado.
Cree una categoría para los canales de tensión y, a continuación, cree tantas salas como sean necesarias en esa categoría. La categoría debe tener todos los usuarios de esfuerzo en su lista De permitidos (mediante la adición de su unidad organizativa), y las salas de esfuerzo deben tener una configuración de privacidad de Abrir.
Se recomienda crear salas de esfuerzo adicionales. Puede crear 50 000 salas con el siguiente comando Windows PowerShell interfaz de línea de comandos:
for ($i = 0; $i -le 50000; $i++) { New-CsPersistentChatRoom -Category <parent category> -Name "StressChan_$i" -Privacy Open }
Edite los archivos de configuración para que se ajusten a la topología:
En LoaderProcess.exe.config, cambia "controller.contoso.com" por el nombre de dominio completo (FQDN) del equipo de controlador.
En StressLauncher.exe.config:
Cambie el valor de configuración "LoaderBinary" por la ruta de acceso de la carpeta compartida.
Cambie "AdminUser"/"AdminPassword" por credenciales que tengan acceso de administrador a los equipos cargadores.
Cambie "ChannelCategory" por el nombre de la categoría en la que se han creado los canales de esfuerzo.
Cambie "UserNamePattern" y "UserPasswordPattern" por una plantilla que coincida con sus credenciales de usuario de esfuerzo. {0} se reemplaza con el número de índice del usuario.
Cambie "Dominio" por el dominio SIP de la topología de prueba.
Cambie "ConnectionString" por una cadena de conexión para la base de datos back-end de Chat persistente.
Cambie "UserIndexStart" por el índice del primer usuario de esfuerzo.
Cambie "LyncFQDN" por el FQDN del grupo de servidores front-end.
Modifique la lista "Máquinas" para incluir los nombres de todas las máquinas cargadoras.
Cambie la dirección base del punto de conexión de servicio (el valor predeterminado es "controller.contoso.com") por el FQDN del equipo de controlador.
Uso
Una vez completada la configuración, abra StressLauncher.exe en el equipo del controlador. Puede iniciar StressLauncher como cualquier usuario. Las credenciales con las que se inician los procesos del cargador en las máquinas cargadoras deben especificarse en el archivo de configuración. También debe proporcionar una cadena de conexión que tenga acceso de lectura a la base de datos back-end de chat persistente. Si esta cadena de conexión usa autenticación de Windows integrados, debe iniciar StressLauncher como usuario que tenga este acceso.
Modifique la configuración del modelo de usuario según sea necesario. Haga clic en Iniciar carga para iniciar una ejecución. Después de un minuto, los usuarios empezarán a iniciar sesión y la barra de progreso comenzará a rellenarse. En este punto, es posible que la máquina controladora funcione y tome medidas de rendimiento.
ChatUpgradeVerifier
Descripción
ChatUpgradeVerifier es una herramienta de comparación de base de datos específica de Chat persistente. La herramienta compara la base de datos de Group Chat 2007 R2 o group chat 2010 (2007/2010Db) con la base de datos de chat persistente de 2013 (2013Db).
La herramienta comprobará, una por una, cada categoría, salón de chat persistente y complemento en 2007/2010Db para ver si aparece en la 2013Db. La comparación incluye comprobar toda la configuración de la categoría, el salón de chat o el complemento, las entidades de seguridad en el ámbito de la categoría y cualquier entidad de seguridad de un rol en la categoría o en el salón de chat. Si una categoría o un salón de chat no aparecen correctamente en 2013Db, las diferencias se mostrarán en un archivo de conflictos. Si, después de la actualización se ha producido, se cambia la 2007/2010Db y, a continuación, se ejecuta esta herramienta, habrá una salida de diferencias en el archivo de conflictos. Tenga en cuenta que esta aplicación es solo una herramienta de comparación de bases de datos y no valida el proceso de actualización.
Requirements
Instale las herramientas del kit de recursos de chat persistente en un equipo unido a un dominio que tenga acceso a las bases de datos back-end del chat persistente (versiones anteriores y actuales de chat persistente).
La cuenta de usuario en la que se ejecuta la herramienta debe tener acceso de lectura a las bases de datos de chat persistente.
El archivo de ChatUpgradeVerifier.exe.config debe contener el parámetro GroupChat2007R2Db o el parámetro GroupChat2010Db, con una cadena de conexión a la base de datos de chat de grupo correspondiente (Ya sea Groupchat 2007R2 o 2010). También debe contener un parámetro PersistentChat2013Db, con una cadena de conexión a la base de datos de Chat persistente 2013.
Uso
Ejecute ChatUpgradeVerifier sin ningún parámetro.
Ejemplo
.jpg "Ejecución de ChatUpgradeVerifier.exe.")
Informe de uso de chat persistente
Descripción
La herramienta ChatUsageReport genera un informe HTML del uso del servicio de chat persistente.
Requirements
Instale las herramientas del kit de recursos de chat persistente en un equipo unido a un dominio que tenga acceso a la base de datos back-end de chat persistente.
La cuenta de usuario en la que se ejecuta la herramienta debe tener acceso de lectura a la base de datos back-end de chat persistente.
El archivo, ChatUsageReport.exe.config, debe contener una <sección connectionStrings> que defina la cadena de conexión a la base de datos back-end de Chat persistente. El contenido del archivo de configuración predeterminado se incluye aquí, como referencia.
Uso
ChatUsageReport [-StartDate {date}] [-EndDate {date}] [-TopActiveUsers {n}] [-TopActiveRooms {n}] [-LeastActiveRooms {n}] [-RoomsInactiveSince {Date}] [-OutputFolder {path}]
Estos parámetros definen la selección de datos:
FechaInicio: Opcionalmente, especifica la fecha de inicio UTC del período de selección. Valor predeterminado: fecha más temprana
Enddate: Opcionalmente, especifica la fecha de finalización UTC del período de selección. Valor predeterminado: Ahora
Estos parámetros definen cómo y qué datos se muestran:
TopActiveUsers: Si se especifica esto, el informe incluirá los n usuarios más activos en cuanto al número de mensajes que el usuario ha publicado en el salón de chat durante el período seleccionado. Valor predeterminado: 10
TopActiveRooms: Si se especifica esto, el informe incluirá los n salones de chat más activos en cuanto al número de mensajes publicados en el salón durante el período seleccionado. Valor predeterminado: 10
LeastActiveRooms: Si se especifica esto, el informe incluirá los n salones de chat menos activos en cuanto al número de mensajes publicados en el salón de chat durante el período seleccionado. Las salas tendrán al menos un mensaje publicado. Valor predeterminado: 10
SalasInactiveSince: Si se especifica esto, el informe incluirá una lista de salones de chat que han estado inactivos desde la fecha especificada. Valor predeterminado: todo el tiempo
OutputFolder: La carpeta donde se colocarán el ChatUsageReport.html y las imágenes gráficas. Esto debe definirse en el archivo de configuración o en la línea de comandos.
Todos los valores de parámetros de la línea de comandos también se pueden especificar en el archivo de ChatUsageReport.exe.config que se encuentra en el mismo directorio que la herramienta. Si se especifica cualquier valor tanto en el archivo de configuración como en la línea de comandos, el valor de la línea de comandos invalidará el valor del archivo de configuración.
Salida
El informe siempre incluirá el siguiente resultado:
N salones de chat principales más activos por número de publicaciones de mensajes para el período seleccionado.
N usuarios principales más activos por número de publicaciones de mensajes para el período seleccionado.
N salones de chat menos activos principales por número de publicaciones de mensajes para el período seleccionado.
Salones de chat que están inactivos durante toda la vida de la base de datos o desde la fecha especificada.
Tendencia de publicación de mensajes diarios para el período seleccionado.
Tendencia de publicación de mensajes semanales para el período seleccionado.
Tendencia de publicación de mensajes mensuales para el período seleccionado.
Total de publicaciones de mensajes del período seleccionado.
Número total de salas habilitadas.
Ejemplo
En el ejemplo siguiente se genera un informe de uso para todo el año 2001 y se coloca el informe en la carpeta De salida especificada en la 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
Descripción
ScheduleADSyncForPrincipal es un script de Microsoft SQL Server 2012 que se debe ejecutar directamente desde dentro de SQL Server Management Studio cuando se conecta a la base de datos back-end de Chat persistente. Este script le permite obligar al chat persistente a sincronizar sus registros de un usuario con los de Servicios de dominio de Active Directory, en lugar de esperar el tiempo de sincronización programado.
Requirements
La cuenta de usuario en la que se ejecuta el script debe tener acceso de propietario a la base de datos back-end del chat persistente.
Uso
A continuación se muestran los contenidos del script predeterminado:
/*
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>