NetIQ AppManager for Microsoft Lync. Management Guide

Transcription

1 NetIQ AppManager for Microsoft Lync Management Guide December 2011

2 Legal Notice THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU. This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data. This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time NetIQ Corporation. All rights reserved. U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R (for Department of Defense (DOD) acquisitions) and 48 C.F.R and (for non-dod acquisitions), the government s rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement. Check Point, FireWall-1, VPN-1, Provider-1, and SiteManager-1 are trademarks or registered trademarks of Check Point Software Technologies Ltd. ActiveAudit, ActiveView, Aegis, AppManager, Change Administrator, Change Guardian, Compliance Suite, the cube logo design, Directory and Resource Administrator, Directory Security Administrator, Domain Migration Administrator, Exchange Administrator, File Security Administrator, Group Policy Administrator, Group Policy Guardian, Group Policy Suite, IntelliPolicy, Knowledge Scripts, NetConnect, NetIQ, the NetIQ logo, PSAudit, PSDetect, PSPasswordManager, PSSecure, Secure Configuration Manager, Security Administration Suite, Security Manager, Server Consolidator, VigilEnt, and Vivinet are trademarks or registered trademarks of NetIQ Corporation or its subsidiaries in the USA. All other company and product names mentioned are used only for identification purposes and may be trademarks or registered trademarks of their respective companies. For purposes of clarity, any module, adapter or other similar material ("Module") is licensed under the terms and conditions of the End User License Agreement for the applicable version of the NetIQ product or software to which it relates or interoperates with, and by accessing, copying or using a Module you agree to be bound by such terms. If you do not agree to the terms of the End User License Agreement you are not authorized to use, access or copy a Module and you must destroy all copies of the Module and contact NetIQ for further instructions.

3 Contents About this Book and the Library...v About NetIQ Corporation...vii Chapter 1 Introducing AppManager for Microsoft Lync 1 Features and Benefits...3 Understanding Features Specific to This Module...3 Counting AppManager Licenses...4 Chapter 2 Installing AppManager for Microsoft Lync 5 System Requirements...5 Installing the Module...6 Deploying the Module with Control Center...7 Silently Installing the Module...8 Setting Up User Permissions for Lync...8 Discovering Lync Resources...9 Chapter 3 Lync Knowledge Scripts 11 ArchivedVoIPCallActivity...12 ConferenceCallActivity...15 EdgeServerCallActivity...18 EdgeServerCallFailures...20 HealthCheck...21 MCUStatus...22 MediationServerCallActivity...23 MediationServerCallFailures...25 MediationServerHealth...26 MediationServerUsage...28 SessionCallActivity...29 SessionCallFailures...32 SystemUptime...34 SystemUsage...35 Contents iii

4 iv Management Guide

5 About this Book and the Library The NetIQ AppManager product (AppManager) is a comprehensive solution for managing, diagnosing, and analyzing performance, availability, and health for a broad spectrum of operating environments, applications, services, and server hardware. AppManager provides system administrators with a central, easy-to-use console to view critical server and application resources across the enterprise. With AppManager, administrative staff can monitor computer and application resources, check for potential problems, initiate responsive actions, automate routine tasks, and gather performance data for real-time and historical reporting and analysis. Intended Audience This guide provides information for individuals responsible for installing an AppManager module and monitoring specific applications with AppManager. Other Information in the Library The library provides the following information resources: Installation Guide for AppManager Provides complete information about AppManager pre-installation requirements and step-by-step installation procedures for all AppManager components. User Guide for AppManager Control Center Provides complete information about managing groups of computers, including running jobs, responding to events, creating reports, and working with Control Center. A separate guide is available for the AppManager Operator Console. Administrator Guide for AppManager Provides information about maintaining an AppManager management site, managing security, using scripts to handle AppManager tasks, and leveraging advanced configuration options. Upgrade and Migration Guide for AppManager Provides complete information about how to upgrade from a previous version of AppManager. Management guides Help Provide information about installing and monitoring specific applications with AppManager. Provides context-sensitive information and step-by-step guidance for common tasks, as well as definitions for each field on each window. The AppManager library is available in Adobe Acrobat (PDF) format from the NetIQ Web site: About this Book and the Library v

6 Conventions The library uses consistent conventions to help you identify items throughout the documentation. The following table summarizes these conventions. Convention Use Bold Window and menu items Technical terms, when introduced Italics Book and CD-ROM titles Variable names and values Emphasized words Fixed Font File and folder names Commands and code examples Text you must type Text (output) displayed in the command-line interface Brackets, such as [value] Optional parameters of a command Braces, such as {value} Required parameters of a command Logical OR, such as value1 value2 Exclusive parameters. Choose one parameter. vi Management Guide

7 About NetIQ Corporation NetIQ, an Attachmate business, is a global leader in systems and security management. With more than 12,000 customers in over 60 countries, NetIQ solutions maximize technology investments and enable IT process improvements to achieve measurable cost savings. The company s portfolio includes awardwinning management products for IT Process Automation, Systems Management, Security Management, Configuration Audit and Control, Enterprise Administration, and Unified Communications Management. For more information, please visit Contacting Sales Support For questions about products, pricing, and capabilities, please contact your local partner. If you cannot contact your partner, please contact our Sales Support team. Worldwide: United States and Canada: Web Site: Contacting Technical Support For specific product issues, please contact our Technical Support team. Worldwide: Contacting Documentation Support Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you. Contacting the Online User Community info@netiq.com North and South America: Europe, Middle East, and Africa: +353 (0) Web Site: support@netiq.com Qmunity, the NetIQ online community, is a collaborative network connecting you to your peers and NetIQ experts. By providing more immediate information, useful links to helpful resources, and access to NetIQ experts, Qmunity helps ensure you are mastering the knowledge you need to realize the full potential of IT investments upon which you rely. For more information, please visit About NetIQ Corporation vii

8 viii Management Guide

9 Chapter 1 Introducing AppManager for Microsoft Lync Microsoft Lync, formerly known as Office Communications Server (OCS), integrates enterprise-ready instant messaging, presence, conferencing, and unified communications in a single offering. Lync comes in a Standard Edition for smaller companies and an Enterprise Edition for larger companies. AppManager for Microsoft Lync provides performance and availability management for the following Lync components: Instant Messaging (IM) Conferencing server This server provides server-managed instant messaging sessions for two users and instant message conferences for more than two users. Audio/Video (A/V) Conferencing server This server provides audio and video peer-to-peer and conferencing capabilities. Web Conferencing server This server provides data collaboration and application-sharing capabilities. Teleconferencing server Enterprise pool This server enables audio conference integration with audio conferencing providers, or ACPs. An Enterprise pool is a collection of Enterprise Edition servers running behind a load balancer for increased performance and availability. Front-end server This server hosts the various conference servers, which Microsoft calls Multipoint Control Units, or MCUs. Chapter 1 Introducing AppManager for Microsoft Lync 1

10 AppManager for Microsoft Lync also monitors the following optional components: Mediation server Edge server This server provides signaling and media translation between the enterprise voice infrastructure and a basic media gateway. This server connects external users with the system so they can participate in meetings and conferences. The following Edge servers allow specific types of multimedia conferences: Access Edge server This server handles Session Initiation Protocol (SIP) traffic for calls from Lync users from outside the corporate firewall. Web Conferencing Edge server This server connects traffic between the Web Conferencing Server and external clients. A/V Conferencing Edge server Director Archiving server This server provides a single, trusted connection point through which both inbound and outbound media traffic can securely traverse network address translators, or NATs, and firewalls. This element authenticates users. If Director is not present, the front-end server handles authentication. This server archives instant messages for compliance purposes. Note that the AppManager for Microsoft Lync module discovers this component, but does not monitor it. Monitoring server Back-end server This server gathers both call data record (CDR) data and Quality of Experience (QoE) data. This server tracks all data and interactions. Note The Archiving, Monitoring, and Back-end servers require SQL Server database software. Supported versions include: Microsoft SQL Server 2008 R2 Microsoft SQL Server 2008 with Service Pack 1 or the latest service pack (64-bit only) Microsoft SQL Server 2005 with Service Pack 3 or the latest service pack (64-bit only) Note that the Archiving and Monitoring Server databases can reside on the same computer. For more information about configuring servers, see the following article: 2 Management Guide

11 Features and Benefits The following are some of the features and benefits of using AppManager for Microsoft Lync: Monitors the availablilty of Lync servers and the health of all services running on Lync servers Monitors the total CPU usage of a server using Lync Monitors the VoIP call metrics contained in the Monitoring (CDR) database Monitors the current call activity and call failure metrics of Edge Servers and Mediation Servers Tracks server uptime since last reboot Tracks the number, duration, and users involved in all sessions occurring on Lync servers Tracks the load placed on servers by ongoing conferences and sessions Tracks any failed conferences or sessions Understanding Features Specific to This Module The following features will help you maximize your usage of AppManager for Microsoft Lync. Lync Knowledge Script Group A Knowledge Script Group, or KSG, is a set of scripts that have their parameters already set to recommended values. To run all of the recommended scripts in a KSG at one time, simply drag and drop the KSG group onto a Lync resource in the left pane. The Lync KSG provides an easy way to get started, right out of the box. This KSG is displayed on the RECOMMENDED tab of the Knowledge Script pane, and includes the following scripts: HealthCheck, which monitors the active status of services on a Lync server. MCUStatus, which monitors the health and draining state of a Multipoint Control Unit (MCU). MediationServerHealth, which measures the global health and connectivity status of a Mediation server. SystemUptime, which monitors how long a server remains up and running after a reboot. SystemUsage, which monitors CPU usage of a Lync server and the processor time per service. Call Activity Knowledge Script Group Another Knowledge Script Group is the CallActivity KSG, which enables you to monitor call activity across all the server components that have been discovered. This KSG is displayed on the Lync tab, and contains the following scripts: ArchivedVoIPCallActivity, which monitors the various VoIP call metrics contained in the Monitoring database. ConferenceCallActivity, which monitors conferences and users in conferences on a Lync server. EdgeServerCallActivity, which monitors current call activity metrics for the Edge server. MediationServerCallActivity, which monitors inbound and outbound calls of a Mediation server. SessionCallActivity, which monitors the number of current sessions on a Lync server. Chapter 1 Introducing AppManager for Microsoft Lync 3

12 New AppManager TreeView Objects Lync discovery generates a new application view in the Operator Console. All the new objects that can be displayed as a result of discovery will rarely be contained under a single machine in the TreeView of AppManager. Note that you must run the Discovery script on each server hosting a Lync server component so that AppManager discovers each one separately. After discovery, AppManager displays the various Lync components under the server in the TreeView on the left side of the AppManager window. SystemUptime Knowledge Script To ensure that your monitored systems are being tracked after you install AppManager for Microsoft Lync, set up the parameters for the SystemUptime Knowledge Script immediately after installation. For more information, see SystemUptime on page 34. Counting AppManager Licenses AppManager for Microsoft Lync consumes one license for each resource that has Lync installed on it. 4 Management Guide

13 Chapter 2 Installing AppManager for Microsoft Lync This chapter provides installation instructions and describes system requirements for AppManager for Microsoft Lync. This chapter assumes you have AppManager installed. For more information about installing AppManager or about AppManager system requirements, see the Installation Guide for AppManager, which is available on the AppManager Documentation page. Important This release of AppManager for Microsoft Lync does not support an upgrade from the AppManager for Microsoft Office Communications Server (OCS) module. This module does not discover or monitor OCS components. If you plan to retain OCS components on any of your servers, run the AppManager for OCS module for those components. AppManager for Microsoft OCS does not support Microsoft Lync. To discover and monitor Lync components, use the AppManager for Microsoft Lync module. System Requirements For the latest information about supported software versions and the availability of module updates, visit the AppManager Supported Products page. Unless noted otherwise, this module supports all updates, hotfixes, and service packs for the releases listed below. AppManager for Microsoft Lync has the following system requirements: Software NetIQ AppManager installed on the AppManager repository (QDB) computer, on the Lync computers you want to monitor (agents), and on all console computers Microsoft Windows operating system on the agent computers AppManager for Microsoft Windows module installed on repository, agent, and console computers Version Microsoft Lync on the agent computers or later Support for Windows Server 2008 on AppManager 7.x requires AppManager Windows Agent hotfix or later. For more information, see the AppManager Suite Hotfixes page. One of the following: Windows Server 2008 R2 Windows Server 2008 (64-bit only) Support for Windows Server 2008 R2 on AppManager 7.x requires the AppManager for Windows module, version or later. For more information, see the AppManager Module Upgrades & Trials page. Chapter 2 Installing AppManager for Microsoft Lync 5

14 If you encounter problems using this module with a later version of your application, contact NetIQ Technical Support. Installing the Module Run the module installer only once on any computer. The module installer automatically identifies and updates all relevant AppManager components on a computer. Access the AM70-Lync-8.x.x.0.msi module installer from the AM70_Lync_8.x.x.0 self-extracting installation package on the AppManager Module Upgrades & Trials page. You can install the Knowledge Scripts into local or remote AppManager repositories (QDBs). Install these components only once per QDB. The module installer now installs Knowledge Scripts for each module directly into the QDB instead of to the \AppManager\qdb\kp folder as in previous releases of AppManager. You can install the module manually, or you can use Control Center to deploy the module on a remote computer where an agent is installed. For more information, see Deploying the Module with Control Center on page 7. However, if you do use Control Center to deploy the module, Control Center only installs the agent components of the module. The module installer installs the QDB and console components as well as the agent components on the agent computer. To install the module manually: 1. Double-click the module installer.msi file. 2. Accept the license agreement. 3. Review the results of the pre-installation check. You can expect one of the following three scenarios: No AppManager agent is present. In this scenario, the pre-installation check fails, and the installer does not install agent components. An AppManager agent is present, but some other prerequisite fails. In this scenario, the default is to not install agent components because of one or more missing prerequisites. However, you can override the default by selecting Install agent component locally. A missing application server for this particular module often causes this scenario. For example, installing the AppManager for Microsoft SharePoint module requires the presence of a Microsoft SharePoint server on the selected computer. All prerequisites are met. In this scenario, the installer will install the agent components. 4. To install the Knowledge Scripts into the QDB: a. Select Install Knowledge Scripts to install the repository components, including the Knowledge Scripts, object types, and SQL stored procedures. b. Specify the SQL Server name of the server hosting the QDB, as well as the case-sensitive QDB name. 5. If you use Control Center 7.x, run the module installer for each QDB attached to Control Center. 6. If you use Control Center 8.x, run the module installer only for the primary QDB, and Control Center will automatically replicate this module to secondary QDBs. 7. Run the module installer on all console computers to install the Help and console extensions. 6 Management Guide

15 8. Run the module installer on the Lync computers you want to monitor (agents) to install the agent components. 9. Set up the proper user permissions on the various Lync servers and SQL servers you will be using. 10. If you have not already discovered Microsoft Lync resources, run the Discovery_Lync Knowledge Script on all agent computers where you installed the module. For more information, see Discovering Lync Resources on page 9. After the installation has completed, the Lync_Install.log file, located in the \NetIQ\Temp\NetIQ_Debug\<ServerName> folder, lists any problems that occurred. Deploying the Module with Control Center You can use Control Center to deploy the module on a remote computer where an agent is installed. This topic briefly describes the steps involved in deploying a module and provides instructions for checking in the module installation package. For more information, see the Control Center User Guide for AppManager, which is available on the AppManager Documentation page. Deployment Overview This section describes the tasks required to deploy the module on an agent computer. To deploy the module on an agent computer: 1. Verify the default deployment credentials. 2. Check in an installation package. 3. Configure an address to receive notification of a deployment. 4. Create a deployment rule or modify an out-of-the-box deployment rule. 5. Approve the deployment task. 6. View the results. Checking In the Installation Package You must check in the installation package, AM70-Lync-8.x.x.0.xml, before you can deploy the module on an agent computer. To check in a module installation package: 1. Log on to Control Center and navigate to the Administration pane. 2. In the Deployment folder, select Packages. 3. On the Tasks view, click Check in Packages. 4. Navigate to the folder where you saved AM70-Lync-8.x.x.0.xml and select the file. 5. Click Open. The Deployment Package Check in Status dialog box displays the status of the package check in. Chapter 2 Installing AppManager for Microsoft Lync 7

16 Silently Installing the Module To silently (without user intervention) install a module on an agent computer using the default settings, run the following command from the folder in which you saved the module installer: msiexec.exe /i "AM70-Lync-8.x.x.0.msi" /qn where x.x is the actual version number of the module installer. To create a log file that describes the operations of the module installer, add the following flag to the command noted above: /L* "AM70-Lync-8.x.x.0.msi.log" The log file is created in the directory in which you saved the module installer. Setting Up User Permissions for Lync After installing AppManager for Microsoft Lync, you will need to establish special permissions for your user accounts. Creating a New Account Before you can begin discovering servers with AppManager for Microsoft Lync, you need to create a domain-based account with one of the following minimum permissions: Member of the Administrators group on the local computer Member of the Domain Administrators group Setting Up the NetIQmc Service For every Lync server you are monitoring, you will need to configure the NetIQ AppManager Client Resource Monitoring (NetIQmc) service to run under the new account you created in Creating a New Account on page 8. To set up the NetIQmc service: 1. On the Lync server, select the Services option from the Administrative Tools section of the Control Panel. 2. From the list of services, right-click NetIQ AppManager Client Resource Monitor and select Properties. 3. On the Log On tab, select This account and type the domain name and username of the user you created in the previous procedure, such as LYNCENT\NetIQService. You can also use an account name that fits your company standards, as needed. 4. Type the password you created for the new user and click OK. Note You will need to be logged in as an administrator to update this setting. 8 Management Guide

17 5. Restart the service by right-clicking NetIQ AppManager Client Resource Monitor from the list of services and selecting Restart. 6. Repeat this procedure on all the Lync servers you will be monitoring. Setting up SQL Servers The final step for user configuration is to give your user account Read access to the relevant Microsoft SQL servers. You will need to repeat this procedure on every SQL server hosting a Monitoring database. To set up SQL servers: 1. In SQL Server Management Studio or SQL Server Configuration Manager, navigate to the Logins directory from the Security directory of the relevant SQL server. 2. Right-click Logins and select New Login. 3. On the General page of the Login - New dialog box, type the domain name and username of the user you created in the previous procedure, such as LYNCENT\NetIQService. 4. Select Windows authentication. 5. In the Default database list, select the name of the Monitoring database, such as LcsCDR, the default name for the Monitoring database. 6. On the User Mappings page of the Login - New dialog box, select the LcsCDR database from the Users mapped to this login table. 7. Select db_datareader access and click OK. 8. Repeat this procedure for all the SQL servers hosting Monitoring databases you will be using with Lync. Discovering Lync Resources Use the Discovery_Lync Knowledge Script to discover all known resources on a Lync server. The script discovers Lync Enterprise and Standard editions, Mediation servers, and Edge servers. When AppManager discovers a Lync component, that component is displayed under the relevant server in the TreeView on the left side of the AppManager window. Before running discovery, ensure you have set up the proper user permissions on the various Lync servers and SQL servers you will be using. For more information, see Setting Up User Permissions for Lync on page 8. The default interval for this script is weekly; the default is Sundays at 3 A.M. Set the Values tab parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Raise event if discovery succeeds? How To Set It event that is raised when the discovery job fails. The default is 5. Set to Yes to raise an event when the discovery process is successful. The default is unchecked. Chapter 2 Installing AppManager for Microsoft Lync 9

18 Description Event severity when discovery succeeds Raise event if discovery succeeds with warnings? Event severity when discovery succeeds with warnings Raise event if discovery fails? Event severity when discovery fails How To Set It If you set this Knowledge Script to raise an event when the job succeeds, set the event severity level for a successful discovery. The default is 25. Set to Yes to raise an event when the discovery process succeeds but generates some warnings. The default is Yes. If you set this Knowledge Script to raise an event when the job succeeds, but with warnings, set the event severity level for a successful discovery. The default is 15. Set to Yes to raise an event when the discovery process fails. The default is Yes. If you set this Knowledge Script to raise an event when the job fails, set the event severity level for a failed discovery. The default is Management Guide

19 Chapter 3 Lync Knowledge Scripts Microsoft Lync combines enterprise-ready instant messaging, presence capabilities, conferencing, unified communications, and administrative controls in a single offering. Lync adds real-time conferencing hosted on servers inside the corporate firewall to existing features such as federation and public instantmessaging connectivity. AppManager for Microsoft Lync provides the following Knowledge Scripts for monitoring Microsoft Lync resources. From the Knowledge Script view of Control Center, you can access more information about any NetIQ-supported Knowledge Script by selecting it and clicking Help. In the Operator Console, click any Knowledge Script in the Knowledge Script pane and press F1. Knowledge Script ArchivedVoIPCallActivity ConferenceCallActivity EdgeServerCallActivity EdgeServerCallFailures HealthCheck MCUStatus MediationServerCallActivity MediationServerCallFailures MediationServerHealth MediationServerUsage SessionCallActivity SessionCallFailures SystemUptime SystemUsage What It Does Monitors the various VoIP call metrics contained in the Monitoring (CDR) database. Monitors the number of active conferences and the number of users in those conferences. Monitors current call activity metrics of an Edge server. Monitors current call failure metrics of an Edge server. Monitors the active status of Lync server services. Monitors the health and draining state of a Multipoint Control Unit (MCU). Monitors the current inbound and outbound calls of a Mediation server. Monitors the session failure metrics of a Mediation server. Monitors the server health metrics of a Mediation server. Monitors the server resource usage of a Mediation server. Monitors the session initiation rate of a Lync server. Monitors session failure metrics of a Lync server. Monitors the length of time a system has been up and running since a reboot. Monitors the total CPU and memory usage of a Lync server. Chapter 3 Lync Knowledge Scripts 11

20 ArchivedVoIPCallActivity Use this Knowledge Script to monitor the various Voice over IP (VoIP) call metrics contained in the Monitoring database. This script monitors the number of total VoIP calls made, the types of calls made, the average duration of calls, the number of redirected calls, and the number of calls per gateway. A gateway is third-party hardware that connects Microsoft Lync with a public switched telephone network (PSTN), private branch exchange (PBX), or other phone system. Resource Objects Lync_ArchivingandCDRFolder Lync_CDRObject Default Schedule The default interval for this script is 15 minutes. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Monitor Total Number of VoIP Calls Raise event if total number of VoIP calls exceeds the Threshold - Maximum total number of VoIP calls Event severity when total number of VoIP calls exceeds the threshold Collect data for total number of VoIP calls? Monitor Total Number of UC to PSTN Calls Raise event if total number of UC to PSTN calls exceeds Threshold - Maximum total number of UC to PSTN calls Event severity when total number of UC to PSTN calls exceeds threshold event that is raised when the job fails. The default is 5. Set to Yes to raise an event if the number of VoIP calls exceeds the threshold. The default is Yes. Specify the maximum number of VoIP calls that can be active before an event is raised. The default is 20. event that is raised when the number of VoIP calls exceeds the threshold. The default is 15. Set to Yes to collect data about the number of VoIP calls. The default is Yes. Set to Yes to raise an event if the number of unified communications (UC) calls to public switched telephone network (PSTN) calls exceeds the threshold. The default is Yes. Specify the maximum number of UC to PSTN calls that can be active before an event is raised. The default is 20. event that is raised when the number of calls exceeds the threshold. The default is Management Guide

21 Description Collect data for total number of Set to Yes to collect data about the number of UC to PSTN calls. The UC to PSTN calls? default is Yes. Monitor Total Number of PSTN to UC Calls Raise event if total number of PSTN to UC calls exceeds Threshold - Maximum total number of PSTN to UC calls Event severity when total number of PSTN to UC calls exceeds threshold Collect data for total number of PSTN to UC calls? Monitor Average Duration of Calls Raise event if average duration of calls exceeds Threshold - Maximum average duration of calls Event severity when the average duration of calls exceeds threshold Collect data for average duration of calls? Monitor Number of Redirected Calls Raise event if total number of redirected calls exceeds Threshold - Maximum total number of redirected calls Event severity when total number of redirected calls exceeds threshold Collect data for number of redirected calls? Monitor Number of Calls per Gateway Raise event if total number of calls per gateway exceeds Threshold - Maximum total number of calls per gateway Set to Yes to raise an event if the number of PSTN to UC calls exceeds the threshold. The default is Yes. Specify the maximum number of PSTN to UC calls that can be active before an event is raised. The default is 20. event that is raised when the number of calls exceeds the threshold. The default is 15. Set to Yes to collect data about the number of PSTN to UC calls. The default is Yes. Set to Yes to raise an event if the average duration of calls exceeds the threshold. The default is Yes. Specify the maximum average call duration that can occur before an event is raised. The default is 20. event that is raised when the average duration of calls exceeds the Set to Yes to collect data about the average duration of calls. The default is Yes. Set to Yes to raise an event if the number of redirected, or transferred, calls exceeds the threshold. The default is Yes. Specify the maximum number of calls that can be redirected before an event is raised. The default is 20. event that is raised when the number of redirected calls exceeds the Set to Yes to collect data about the number of redirected calls. The default is Yes. Set to Yes to raise an event if the number of calls per gateway exceeds the threshold. The default is Yes. Specify the maximum number of calls that the gateway can handle before an event is raised. The default is 20. Chapter 3 Lync Knowledge Scripts 13

22 Description Event severity when total number of calls per gateway exceeds threshold Collect data for number of calls per gateway? event that is raised when the number of calls exceeds the threshold. The default is 15. Set to Yes to collect data about the number of calls per gateway. The default is Yes. 14 Management Guide

23 ConferenceCallActivity Use this Knowledge Script to monitor the number of active conferences, and the number of users involved in those conferences, on a Lync server. The conference type can be instant message (IM), telephony, A/V, or Web. Resource Object Lync_ConferenceObject Default Schedule The default interval for this script is five minutes. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Monitor IM Conferences Raise event if number of IM conferences exceeds Threshold - Maximum number of IM conferences Event severity when number of IM conferences exceeds threshold Collect data for number of IM conferences? Monitor A/V Conferences Raise event if number of A/V conferences exceeds Threshold - Maximum number of A/V conferences Event severity when number of A/V conferences exceeds threshold Collect data for number of A/V conferences? event that is raised when the job fails. The default is 5. Set to Yes to raise an event if the number of instant message conferences exceeds the threshold. The default is Yes. Specify the maximum number of IM conferences that can be active before an event is raised. The default is 25. event that is raised when the number of IM conferences exceeds the Set to Yes to collect data about the number of IM conferences. The default is unchecked. Set to Yes to raise an event if the number of A/V conferences exceeds the threshold. The default is Yes. Specify the maximum number of A/V conferences that can be active before an event is raised. The default is 25. event that is raised when the number of A/V conferences exceeds the Set to Yes to collect data about the number of A/V conferences. The default is unchecked. Chapter 3 Lync Knowledge Scripts 15

24 Description Monitor Telephony Conferences Raise event if number of telephony conferences exceeds Threshold - Maximum number of telephony conferences Event severity when number of telephony conferences exceeds threshold Collect data for number of telephony conferences? Monitor Web Conferences Raise event if number of Web conferences exceeds Threshold - Maximum number of Web conferences Event severity when number of Web conferences exceeds threshold Collect data for number of Web conferences? Monitor IM Conference Users Raise event if number of IM conference users exceeds Threshold - Maximum number of IM conference users Event severity when number of IM conference users exceeds threshold Collect data for number of IM conference users? Monitor A/V Conference Users Raise event if number of A/V conference users exceeds Threshold - Maximum number of A/V conference users Event severity when number of A/V conference users exceeds threshold Set to Yes to raise an event if the number of telephony conferences exceeds the threshold. The default is Yes. Specify the maximum number of telephony conferences that can be active before an event is raised. The default is 25. event that is raised when the number of telephony conferences exceeds the Set to Yes to collect data about the number of telephony conferences. The default is Yes. Set to Yes to raise an event if the number of Web conferences exceeds the threshold. The default is Yes. Specify the maximum number of Web conferences that can be active before an event is raised. The default is 25. event that is raised when the number of Web conferences exceeds the Set to Yes to collect data about the number of Web conferences. The default is Yes. Set to Yes to raise an event if the number of IM conference users exceeds the threshold. The default is Yes. Specify the maximum number of IM conference users that can be active before an event is raised. The default is 10. event that is raised when the number of IM conference users exceeds the Set to Yes to collect data about the number of IM conference users. The default is Yes. Set to Yes to raise an event if the number of A/V conference users exceeds the threshold. The default is Yes. Specify the maximum number of A/V conference users that can be active before an event is raised. The default is 10. event that is raised when the number of A/V conference users exceeds the 16 Management Guide

25 Description Collect data for number of Set to Yes to collect data about the number of A/V conference users. The A/V conference users? default is Yes. Monitor Telephony Conference Users Raise event if number of telephony conference users exceeds Threshold - Maximum number of telephony conference users Event severity when number of telephony conference users exceeds threshold Collect data for number of telephony conference users? Monitor Web Conference Users Raise event if number of Web conference users exceeds Threshold - Maximum number of Web conference users Event severity when number of Web conference users exceeds threshold Collect data for number of Web conference users? Set to Yes to raise an event if the number of telephony conference users exceeds the threshold. The default is Yes. Specify the maximum number of telephony conference users that can be active before an event is raised. The default is 10. event that is raised when the number of telephony conference users exceeds the Set to Yes to collect data about the number of telephony conference users. The default is Yes. Set to Yes to raise an event if the number of Web conference users exceeds the threshold. The default is Yes. Specify the maximum number of Web conference users that can be active before an event is raised. The default is 10. event that is raised when the number of Web conference users exceeds the Set to Yes to collect data about the number of Web conference users. The default is Yes. Chapter 3 Lync Knowledge Scripts 17

26 EdgeServerCallActivity Use this Knowledge Script to monitor call activity metrics of an Edge Server, including the number of active server connections. This script also monitors the number of connections that are slow because they are overloaded, also known as throttling. In addition, this script monitors the number of disconnected server connections. Resource Object Lync_EdgeServerFolder Default Schedule The default interval for this script is five minutes. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job event fails that is raised when the job fails. The default is 5. Monitor Active Server Connections Raise event if the number of active server connections exceeds Threshold - Maximum active server connections Event severity when threshold is exceeded Set to Yes to raise an event if the number of active server connections exceeds the threshold. The default is Yes. Specify the maximum number of active server connections that can occur before an event is raised. The default is 100. event that is raised when the number of active server connections exceeds the Collect data for number of Set to Yes to collect data about the active server connections. The default is Yes. active server connections? Monitor Throttled Connections Raise event if number of throttled connections exceeds Threshold - Maximum number of throttled connections Event severity when threshold is exceeded Set to Yes to raise an event if the number of throttled connections exceeds the threshold. Throttled connections are when connections are slow as a result of being overloaded. The default is Yes. Specify the maximum number of throttled connections that can occur before an event is raised. The default is 15. event that is raised when the number of throttled connections exceeds the threshold. The default is Management Guide

27 Description Collect data for number of Set to Yes to collect data about the number of throttled server connections. The throttled server default is Yes. connections? Monitor Disconnected Server Connections Raise event if number of disconnected server connections exceeds Threshold - Maximum disconnected server connections Event severity when threshold is exceeded Collect data for number of server connections disconnected due to throttling? Set to Yes to raise an event if the number of disconnected server connections exceeds the threshold. The default is Yes. Specify the maximum number of disconnected server connections that can occur before an event is raised. The default is 25. event that is raised when the number of disconnected server connections exceeds the Set to Yes to collect data about the number of server connections disconnected because of throttling. The default is Yes. Chapter 3 Lync Knowledge Scripts 19

28 EdgeServerCallFailures Use this Knowledge Script to monitor current call failure metrics of an Edge server. This script generates a data stream for the number of connection failures and raises an event if the number of connection failures exceeds the specified threshold. Resource Object Lync_EdgeServerFolder Default Schedule The default interval for this script is five minutes. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Monitor Connection Failures Raise event if the number of connection failures exceeds Threshold - Maximum connection failures Event severity when threshold is exceeded Collect data for the number of connection failures? event that is raised when the job fails. The default is 5. Set to Yes to raise an event if the number of connection failures exceeds the threshold. The default is Yes. Specify the maximum number of connections that can fail before an event is raised. The default is 15. event that is raised when the number of connection failures exceeds the Set to Yes to collect data about the number of connection failures. The default is Yes. 20 Management Guide

29 HealthCheck Use this Knowledge Script to monitor the active status of Lync server services. You can run this script on a Front-end server, a Mediation server, or an Edge server to monitor the services on that server. This script raises an event if a service fails to start, stops and then starts again, or is disabled. It generates a data stream for service availability. Resource Object Lync_ServicesObject Default Schedule The default interval for this script is one minute. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Monitor Services Start a service if it is stopped? Collect data for service availability? Raise event if a service fails to start? Event severity when service fails to start Raise event if a stopped service has been started? Event severity when a stopped service has been started Raise event if service is disabled? Event severity when service is disabled event that is raised when the job fails. The default is 5. Set to Yes if you want to start a stopped service. The default is Yes. Set to Yes to collect data about service availability. The default is Yes. Set to Yes to raise an event if the service fails to start. The default is Yes. event that is raised when the service fails to start. The default is 5. Set to Yes to raise an event if the service has been started. The default is Yes. event that is raised when a stopped service has been started again. The default is 25. Set to Yes to raise an event if the service is disabled. The default is unchecked. event that is raised when the service is disabled. The default is 15. Chapter 3 Lync Knowledge Scripts 21

30 MCUStatus Use this Knowledge Script to monitor the health and draining state of a Multipoint Control Unit, or MCU. For example, IMMCU is an IM Conferencing server that runs as an IM service, and this script monitors the load for that server. The different health states display the level of use as well as the number of users on the server. Resource Object Lync_MCUObject Default Schedule The default interval for this script is five minutes. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Monitor MCU Health State Raise event if health state is Loaded? Event severity when health state is Loaded Raise event if health state is Full? Event severity when health state is Full Monitor MCU Draining State Raise event if draining state is Requesting to Drain? Event severity when draining state is Requesting to Drain Raise event if draining state is Draining? Event severity when draining state is Draining event that is raised when the job fails. The default is 5. Set to Yes to raise an event if the health state is Loaded. The default is unchecked. event that is raised when the health state is Loaded. The default is 20. Set to Yes to raise an event if the health state is Full. The default is Yes. event that is raised when the health state is Full. The default is 15. Set to Yes to raise an event if the draining state is Requesting to Drain, or attempting to close MCU services to reduce the load. The default is Yes. event that is raised when the draining state is Requesting to Drain. The default is 15. Set to Yes to raise an event if the draining state is set to Draining, the process of closing MCU services to reduce the load. The default is Yes. event that is raised when the draining state is set to Draining. The default is Management Guide

31 MediationServerCallActivity Use this Knowledge Script to monitor inbound and outbound calls of a Mediation server, an optional component that connects Lync to a phone system, such as a PSTN, POTS, PBX, or some other legacy system. Resource Object Lync_MediationFolder Default Schedule The default interval for this script is five minutes. Setting Parameter Values Set the following parameters as needed: Description General Settings Job Failure Notification Event severity when job fails Monitor Inbound Calls Raise event if number of inbound calls exceeds Threshold - Maximum number of inbound calls Event severity when threshold is exceeded Collect data for number of current inbound calls? Monitor Outbound Calls Raise event if number of outbound calls exceeds Threshold - Maximum number of outbound calls Event severity when threshold is exceeded Collect data for number of current outbound calls? event that is raised when the job fails. The default is 5. Set to Yes to raise an event if the number of inbound calls exceeds the threshold. The default is Yes. Specify the maximum number of inbound calls that can occur before an event is raised. The default is 25. event that is raised when the number of inbound calls exceeds the Set to Yes to collect data about the number of current inbound calls. The default is Yes. Set to Yes to raise an event if the number of outbound calls exceeds the threshold. The default is Yes. Specify the maximum number of outbound calls that can occur before an event is raised. The default is 25. event that is raised when the number of outbound calls exceeds the Set to Yes to collect data about the number of current outbound calls. The default is Yes. Chapter 3 Lync Knowledge Scripts 23