User's Guide: Beta 1 Draft

Transcription

1 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Lync Server Agent vnext User's Guide: Beta 1 Draft SC

2

3 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Lync Server Agent vnext User's Guide: Beta 1 Draft SC

4 Note Before using this information and the product it supports, read the information in Notices on page 435. This edition applies to vnext of IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Lync Server Agent (product number 5724-U18) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2011, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Tables vii Chapter 1. Overview of the agent IBM Tivoli Monitoring Functions of the monitoring agent New in this release Components of the IBM Tivoli Monitoring environment Agent Management Services User interface options Data sources Chapter 2. Agent installation and configuration Requirements Language pack installation Installing language packs on Windows systems 15 Installing language packs on UNIX or Linux systems Silent installation of language packs on Windows, UNIX, or Linux systems Prerequisites checking Running as a non-administrator user Chapter 3. Workspaces reference Predefined workspaces Workspace descriptions Microsoft Lync Server Navigator item Archiving Navigator item Audio Video Conferencing Server Navigator item 24 Availability Navigator item CDR Navigator item CWA Navigator item Event Log Navigator item IM Server Navigator item Lync Web App Navigator item QoE Monitoring Server Navigator item SIP Navigator item User Services Navigator item Web Conferencing Server Navigator item Cross-linked workspaces Chapter 4. Attributes reference Attribute groups for the monitoring agent Attributes in each attribute group Address Book File Download attribute group.. 48 Address Book Web Query attribute group Archiving Service DB Operations attribute group 58 Archiving Service Read attribute group Archiving Service Write attribute group Audio Video CCCP Processing attribute group 64 Audio Video MCU State and Performance attribute group Audio Video Operations attribute group Autodiscover attribute group Availability attribute group CDR Service DB Operations attribute group.. 80 CDR Service Read attribute group CDR Service Write attribute group CWA Authentication attribute group CWA Directory Search attribute group CWA Security attribute group CWA User Sessions attribute group Event Log attribute group IM CCCP Processing attribute group IM Conferencing attribute group IM MCU State and Performance attribute group 115 Instant Messaging attribute group Lync Media Quality attribute group Lync Server Roles attribute group Lync Web Relay attribute group Media Planning attribute group MSMQ Operations attribute group OCS2k7 Roles attribute group OCS2k7R2 Roles attribute group Performance Object Status attribute group QMS Agent attribute group QMS Media Quality Audio Video MCU attribute group QMS Media Quality Locations attribute group 148 Server attribute group SIP Networking attribute group SIP Peers attribute group SIP Protocols attribute group SIPEPS Transactions attribute group Throttling and Authentication attribute group 163 User Services Conference Control attribute group User Services Conference Control Notification attribute group User Services DBStore attribute group User Services Endpoint Cache attribute group 184 User Services HTTPS Transport attribute group 186 User Services MCU Allocation Latency attribute group User Services Pool Conference Statistics attribute group Web CCCP Processing attribute group Web Conferencing attribute group Web MCU State and Performance attribute group X INTERNAL Address Book File Download Lync attribute group X INTERNAL Address Book File Download Lync13 attribute group X INTERNAL Address Book Web Query lync attribute group X INTERNAL Address Book Web Query lync13 attribute group Copyright IBM Corp. 2011, 2013 iii

6 X INTERNAL Archiving Service DB Operations LYNC attribute group X INTERNAL Archiving Service DB Operations OCS attribute group X INTERNAL Archiving Service Read LYNC attribute group X INTERNAL Archiving Service Read OCS attribute group X INTERNAL Archiving Service Write LYNC attribute group X INTERNAL Archiving Service Write OCS attribute group X INTERNAL Audio Video CCCP Processing Lync attribute group X INTERNAL Audio Video CCCP Processing Lync13 attribute group X INTERNAL Audio Video CCCP Processing OCS attribute group X INTERNAL Audio Video MCU State and Performance LYNC attribute group X INTERNAL Audio Video MCU State and Performance LYNC13 attribute group X INTERNAL Audio Video MCU State and Performance OCS attribute group X INTERNAL Audio Video Operations LYNC attribute group X INTERNAL Audio Video Operations LYNC13 attribute group X INTERNAL Audio Video Operations OCS attribute group X INTERNAL CDR Service DB Operations LYNC attribute group X INTERNAL CDR Service DB Operations OCS attribute group X INTERNAL CDR Service Read LYNC attribute group X INTERNAL CDR Service Read OCS attribute group X INTERNAL CDR Service Write LYNC attribute group X INTERNAL CDR Service Write OCS attribute group X INTERNAL IM CCCP Processing LYNC attribute group X INTERNAL IM CCCP Processing LYNC13 attribute group X INTERNAL IM CCCP Processing OCS attribute group X INTERNAL IM Conferencing LYNC attribute group X INTERNAL IM Conferencing LYNC13 attribute group X INTERNAL IM Conferencing OCS attribute group X INTERNAL IM MCU State and Performance LYNC attribute group X INTERNAL IM MCU State and Performance LYNC13 attribute group X INTERNAL IM MCU State and Performance OCS attribute group X INTERNAL Instant Messaging LYNC attribute group X INTERNAL Instant Messaging LYNC13 attribute group X INTERNAL Instant Messaging OCS attribute group X INTERNAL Lync Media Quality attribute group X INTERNAL Lync Media Quality13 attribute group X INTERNAL Lync Web Relay attribute group 223 X INTERNAL Lync Web Relay13 attribute group 223 X INTERNAL Media Planning Lync attribute group X INTERNAL Media Planning Lync13 attribute group X INTERNAL Media Planning OCS attribute group X INTERNAL MSMQ Operations Lync attribute group X INTERNAL MSMQ Operations Lync13 attribute group X INTERNAL MSMQ Operations OCS attribute group X INTERNAL QMS Agent Lync attribute group 227 X INTERNAL QMS Agent OCS attribute group 227 X INTERNAL SIP Networking LYNC attribute group X INTERNAL SIP Networking LYNC13 attribute group X INTERNAL SIP Networking OCS attribute group X INTERNAL SIP Peers LYNC attribute group 229 X INTERNAL SIP Peers LYNC13 attribute group 230 X INTERNAL SIP Peers OCS attribute group 230 X INTERNAL SIP Protocols LYNC attribute group X INTERNAL SIP Protocols LYNC13 attribute group X INTERNAL SIP Protocols OCS attribute group 232 X INTERNAL SIPEPS Transactions LYNC attribute group X INTERNAL SIPEPS Transactions LYNC13 attribute group X INTERNAL SIPEPS Transactions OCS attribute group X INTERNAL Throttling and Authentication Lync attribute group X INTERNAL Throttling and Authentication Lync13 attribute group X INTERNAL USRV Conference Control LYNC attribute group X INTERNAL USRV Conference Control LYNC13 attribute group X INTERNAL USRV Conference Control Notification LYNC attribute group X INTERNAL USRV Conference Control Notification LYNC13 attribute group X INTERNAL USRV Conference Control Notification OCS attribute group iv Microsoft Lync Server agent: User's Guide

7 X INTERNAL USRV Conference Control OCS attribute group X INTERNAL USRV DBStore LYNC attribute group X INTERNAL USRV DBStore LYNC13 attribute group X INTERNAL USRV DBStore OCS attribute group X INTERNAL USRV EndpointCache LYNC attribute group X INTERNAL USRV EndpointCache LYNC13 attribute group X INTERNAL USRV EndpointCache OCS attribute group X INTERNAL USRV HTTPS Transport LYNC attribute group X INTERNAL USRV HTTPS Transport LYNC13 attribute group X INTERNAL USRV HTTPS Transport OCS attribute group X INTERNAL USRV MCU Allocation Latency LYNC attribute group X INTERNAL USRV MCU Allocation Latency LYNC13 attribute group X INTERNAL USRV MCU Allocation Latency OCS attribute group X INTERNAL USRV Pool Conference Statistics LYNC attribute group X INTERNAL USRV Pool Conference Statistics LYNC13 attribute group X INTERNAL USRV Pool Conference Statistics OCS attribute group X INTERNAL WEB CCCP Processing LYNC attribute group X INTERNAL WEB CCCP Processing LYNC13 attribute group X INTERNAL WEB CCCP Processing OCS attribute group X INTERNAL WEB Conferencing LYNC attribute group X INTERNAL WEB Conferencing LYNC13 attribute group X INTERNAL WEB Conferencing OCS attribute group X INTERNAL WEB MCU State and Performance LYNC attribute group X INTERNAL WEB MCU State and Performance LYNC13 attribute group X INTERNAL WEB MCU State and Performance OCS attribute group Disk capacity planning for historical data Chapter 5. Situations reference Predefined situations Situation descriptions Microsoft Lync Server Navigator item Archiving Navigator item Audio Video Conferencing Server Navigator item Availability Navigator item CDR Navigator item CWA Navigator item Event Log Navigator item IM Server Navigator item Lync Web App Navigator item QoE Monitoring Server Navigator item SIP Navigator item User Services Navigator item Web Conferencing Server Navigator item Chapter 6. Take Action commands reference Predefined Take Action commands Take Action command descriptions Start Access Edge Service action Start Application Host Service action Start Application Sharing Service action Start Archiving Service action Start Audio Test Service action Start Audio Video Authentication Service action 283 Start Audio Video Conferencing Service action 284 Start Audio Video Edge Service action Start Bandwidth Policy Service (Authentication) action Start Bandwidth Policy Service (Core) action 286 Start Call Detail Recording Service action Start Call Park Service action Start Centralized Logging Service Agent action 288 Start Conferencing Announcement Service action Start Conferencing Attendant Service action Start File Transfer Agent Service action Start Front End Service action Start IM Conferencing Service action Start Lync Response Group Service action Start Master Replicator Service action Start Mediation Service action Start Monitoring Agent Service action Start OCS Response Group Service action Start Outside Voice Control Service action Start QoE Monitoring Service action Start Replica Replicator Service action Start Telephony Conferencing Service action Start Web Conferencing Compatibility Service action Start Web Conferencing Edge Service action Start Web Conferencing Service action Start XMPP Translating Gateway Service action 303 Stop Access Edge Service action Stop Application Host Service action Stop Application Sharing Service action Stop Archiving Service action Stop Audio Test Service action Stop Audio Video Authentication Service action 308 Stop Audio Video Conferencing Service action 308 Stop Audio Video Edge Service action Stop Bandwidth Policy Service (Authentication) action Stop Bandwidth Policy Service (Core) action Stop Call Detail Recording Service action Stop Call Park Service action Stop Centralized Logging Service Agent action 313 Contents v

8 Stop Conferencing Announcement Service action 314 Stop Conferencing Attendant Service action Stop File Transfer Agent Service action Stop Front End Service action Stop IM Conferencing Service action Stop Lync Response Group Service action Stop Master Replicator Service action Stop Mediation Service action Stop Monitoring Agent Service action Stop OCS Response Group Service action Stop Outside Voice Control Service action Stop QoE Monitoring Service action Stop Replica Replicator Service action Stop Telephony Conferencing Service action Stop Web Conferencing Compatibility Service action Stop Web Conferencing Edge Service action Stop Web Conferencing Service action Stop XMPP Translating Gateway Service action 328 Chapter 7. Policies reference Predefined policies Chapter 8. Tivoli Common Reporting for the monitoring agent Cognos-based report packages Prerequisites Importing Cognos report packages Cognos data models and reports Chapter 9. Troubleshooting Trace logging Overview of log file management Principal trace log files Examples: Using trace logs RAS trace parameters Dynamic modification of trace settings Setting trace parameters for the Tivoli Enterprise Console server Problems and workarounds Installation and configuration troubleshooting 354 Remote deployment troubleshooting Agent troubleshooting Workspace troubleshooting Situation troubleshooting Take Action commands troubleshooting Support information Informational, warning, and error messages overview Message format Agent messages Tivoli Common Reporting troubleshooting Appendix A. Event mapping Appendix B. Documentation library 431 Prerequisite publications Related publications Other sources of documentation Notices Trademarks Index vi Microsoft Lync Server agent: User's Guide

9 Tables 1. Mechanisms used to gather attributes Cross-linked workspaces within the Lync Server agent Cross-linked workspaces to the Microsoft IIS agent Capacity planning for historical data logged by the Microsoft Lync Server agent IM CCCP Processing Statistics report MCU Allocation Latency Statistics report SIP Protocols Statistics report Top Services by Memory Utilization report Instant Messaging (IM) Conferencing Statistics report Information to gather before contacting IBM Software Support Trace log files for troubleshooting agents Problems and solutions for installation and configuration General problems and solutions for uninstallation Remote deployment problems and solutions Agent problems and solutions Workspace problems and solutions Situation problems and solutions Take Action commands problems and solutions Tivoli Common Reporting for Microsoft Lync Server agent problems and solutions Copyright IBM Corp. 2011, 2013 vii

10 viii Microsoft Lync Server agent: User's Guide

11 Chapter 1. Overview of the agent The IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Lync Server Agent provides you with the capability to monitor Microsoft Lync Server or Microsoft OCS. You can also use the agent to take basic actions with the Microsoft Lync Server or Microsoft OCS. IBM Tivoli Monitoring is the base software for the Microsoft Lync Server agent. The Microsoft Lync Server agent monitors the following functions: v Availability and resources v Performance v Error and event log v Historical data IBM Tivoli Monitoring IBM Tivoli Monitoring provides a way to monitor the availability and performance of all the systems in your enterprise from one or several designated workstations. It also provides useful historical data that you can use to track trends and to troubleshoot system problems. You can use IBM Tivoli Monitoring to achieve the following tasks: v Monitor for alerts on the systems that you are managing by using predefined situations or custom situations. v Establish your own performance thresholds. v Trace the causes leading to an alert. v Gather comprehensive data about system conditions. v Use policies to take actions, schedule work, and automate manual tasks. The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. You can use the consolidated view of your environment as seen in the Tivoli Enterprise Portal to monitor and resolve performance issues throughout the enterprise. See the IBM Tivoli Monitoring publications listed in Prerequisite publications on page 431 for complete information about IBM Tivoli Monitoring and the Tivoli Enterprise Functions of the monitoring agent Availability monitoring Monitors the following Microsoft OCS 2007 services, indicating when down: v Office Communications Server Front-End Service v Office Communications Server IM Conferencing Service v Office Communications Server Telephony Conferencing Service v Office Communications Server Web Conferencing Service v Office Communications Server Audio/Video Conferencing Service v Office Communications Server Archiving and CDR Service v Office Communications Server Audio/Video Authentication Service v Office Communications Server Audio/Video Edge Service v Office Communications Server Web Conferencing Edge Service Monitors the following OCS 2007 R2 services, indicating when down: Copyright IBM Corp. 2011,

12 v Office Communications Server Application Host Service v Office Communications Server Application Sharing Service v Office Communications Server Audio/Video Conferencing Service v Office Communications Server Conferencing Announcement Service v Office Communications Server Conferencing Attendant Service v Office Communications Server Front-End Service v Office Communications Server IM Conferencing Service v Office Communications Server Monitoring Agent Service v Office Communications Server Outside Voice Control Service v Office Communications Server Response Group Service v Office Communications Server Telephony Conferencing Service v Office Communications Server Web Conferencing Service v Office Communications Server Call Detail Recording Service v Office Communications Server QoE Monitoring Service v Office Communications Server Archiving Service v Office Communications Server Audio/Video Authentication Service v Office Communications Server Audio/Video Edge Service v Office Communications Server Web Conferencing Edge Service Monitors the following Microsoft Lync Server 2010 services, indicating when down: v Lync Server Application Sharing Service v Lync Server Audio Test Service v Lync Server Audio/Video Conferencing Service v Lync Server Call Park Service v Lync Server Front-End Service v Lync Server IM Conferencing Service v Lync Server Mediation Service v Lync Server Replica Replicator Agent Service v Lync Server Response Group Service v Lync Server Web Conferencing Service v Lync Server Web Conferencing Compatibility Service v Lync Server Bandwidth Policy Service (Authentication) v Lync Server Bandwidth Policy Service (Core) v Lync Server File Transfer Agent Service v Lync Server Master Replicator Agent Service v Lync Server Audio/Video Authentication Service v Lync Server Audio/Video Edge Service v Lync Server Web Conferencing Edge Service Error and Event log Monitoring Monitors for the following event sources that affect the Microsoft OCS availability or performance: v OCS A/V Authentication Edge Server v OCS A/V Edge Server v OCS ACP MCU v OCS Address Book and Distribution List Expansion Web Service v OCS Address Book Server 2 Microsoft Lync Server agent: User's Guide

13 v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v OCS AppDomain Host Process OCS Application Error OCS Application Server OCS ApplicationSharing Conferencing Server OCS ApplicationSharing Conferencing Server OCS Applications Module OCS Archiving Agent OCS Archiving Server OCS Audio-Video Conferencing Server OCS Auto Update Server OCS Call Detail Recording OCS Certificate Manager OCS Client Version Filter OCS Common Library OCS Communicator Mobile Component Session Service OCS Communicator Web Access Authentication OCS Communicator Web Access MMC Snap-In OCS Communicator Web Access Policy OCS Communicator Web Access Session Service OCS Communicator Web Access User Search OCS Conferencing Announcement Service OCS Conferencing Attendant OCS Data MCU OCS DB Access Layer OCS Exchange Unified Messaging Routing OCS IM MCU OCS Inbound Routing OCS Intelligent IM Filter OCS LDM OCS MCU Factory OCS MCU Infrastructure OCS Mediation Server OCS Outbound Routing OCS Outside Voice Control OCS Password Expiry Check OCS Protocol Stack OCS QoE Monitoring Agent OCS QoE Monitoring Service OCS Response Group Service OCS Script-Only Applications OCS Server OCS Setup OCS Snap-in OCS Software Update Service OCS Translation Service Chapter 1. Overview of the agent 3

14 v OCS UserPin Service v OCS User Replicator v OCS User Services v OCS Web Conferencing Edge Server v OCS WMI Consumer v OCS WMI Event Provider v OCS WMI Provider v OCS Archiving and CDR Server v OCS Distribution List Expansion Web Service v OCS QoE Monitoring Server Monitors for the following event sources that affect the Microsoft Lync Server availability or performance: v LS A/V Authentication Edge Server v LS A/V Edge Server v LS ACP MCU v LS Address Book and Distribution List Expansion Web Service v LS Address Book Server v LS AppDomain Host Process v LS Application Error v LS Application Server v LS ApplicationSharing Conferencing Server v LS Applications Module v LS Archiving Agent v LS Archiving Server v LS Audio-Video Conferencing Server v LS Auto Update Server v LS Bandwidth Policy Service (Authentication) v LS Bandwidth Policy Service (Core) v LS Call Detail Recording v LS Call Park Service v LS Certificate Manager v LS Client Version Filter v LS Common Library v LS Conferencing Announcement Service v LS Conferencing Attendant v LS Configuration Provider v LS Data MCU v LS DB Access Layer v LS Dialin Web Service v LS Exchange Unified Messaging Routing v LS File Transfer Agent Service v LS IM MCU v LS Inbound Routing v LS Incoming Federation Service v LS Intelligent IM Filter 4 Microsoft Lync Server agent: User's Guide

15 v LS InterCluster Routing v LS Join Launcher Web Service v LS LDM v LS Location Information Service v LS Lync Web App v LS Master Replicator Agent Service v LS MCU Factory v LS MCU Infrastructure v LS Mediation Server v LS Meeting MCU v LS MGC ADMIN TOOL v LS MGC CLIENT v LS MGC COMMON v LS MGC COMPLIANCE v LS MGC CONFIG v LS MGC ENDPOINT v LS MGC LOADER v LS MGC LOOKUP v LS MGC SERVER v LS MGC SERVICE v LS MGC TRANSPORT v LS Outbound Routing v LS Outgoing Federation Service v LS Password Expiry Check v LS Protocol Stack v LS Provisioning Service v LS QoE Monitoring Agent v LS QoE Monitoring Service v LS Remote PowerShell v LS Replica Replicator Agent Service v LS Response Group Service v LS Routing Data Sync Agent v LS Script-Only Applications v LS Server v LS Software Update Service v LS Translation Service v LS UserPin Service v LS User Replicator v LS User Services v LS Web Components Server v LS Web Conferencing Edge Server v LS Audio/Video Authentication Server Performance Monitoring Gathers performance attributes in the following areas, providing situations where appropriate: v Instant Messaging Chapter 1. Overview of the agent 5

16 v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v v IM Conferencing IM MCU State and Performance IM CCCP Processing Audio Video Operations Audio Video MCU State and Performance Audio Video CCCP Processing Web Conferencing Web MCU State and Performance Web CCCP Processing User Services Endpoint Cache User Services HTTPS Transport User Services Conference Control User Services Conference Control Notification User Services MCU Allocation Latency User Services Pool Conference Statistics User Services DBStore SIP Networking SIP Peers SIP Protocols SIPEPS Transactions Server QMS Agent QMS Media Quality Locations QMS Media Quality Audio Video MCU CDR Service DB Operations CDR Service Read CDR Service Write MSMQ Operations Archiving Service DB Operations Archiving Service Read Archiving Service Write CWA Directory Search CWA Authentication CWA Security CWA User Sessions Media Planning Media Private Lync Web Relay Address Book File Download Address Book Web Query Throttling and Authentication OCS2k7 Roles OCS2k7R2 Roles Lync Server Roles 6 Microsoft Lync Server agent: User's Guide

17 Actions Provides actions to start and stop the following Microsoft OCS and Microsoft Lync Server services: v IM Conferencing Service v Web Conferencing Service v Audio/Video Conferencing Service v Front-End Service v Application Sharing Service v OCS Application Host Service v OCS Conferencing Announcement Service v OCS Conferencing Attendant Service v OCS Monitoring Agent Service v OCS Outside Voice Control Service v OCS Response Group Service v OCS Telephony Conferencing Service v OCS Archiving Service v OCS Call Detail Recording Service v OCS QoE Monitoring Service v OCS Audio/Video Authentication Service v OCS Audio/Video Edge Service v OCS Web Conferencing Edge Service v OCS Access Edge Service v Lync Server Audio Test Service v Lync Server File Transfer Agent Service v Lync Server Master Replicator Agent Service v Lync Server Replica Replicator Agent Service v Lync Server Web Conferencing Compatibility Service v Lync Server Call Park Service v Lync Server Response Group Service v Lync Server Mediation Service v Lync Server Bandwidth Policy Service (Authentication) v Lync Server Bandwidth Policy Service (Core) v Lync Server Audio/Video Authentication Service v Lync Server Audio/Video Edge Service v Lync Server Web Conferencing Edge Service v Lync Server Access Edge Service Reporting Provides a history enablement file that enables the ability to generate reports for all attributes collected. New in this release For the Microsoft Lync Server agent, the following enhancements were made since version 6.3, including the fix packs: v New attribute groups: Autodiscover Chapter 1. Overview of the agent 7

18 v New or changed situations: KQL_ CentralizedLogging_SvcDown KQL_XMPPGateway_SvcDown v New Take Action or changed Take Action commands: Start Centralized Logging Service Agent Start XMPP Translating Gateway Service Stop Centralized Logging Service Agent Stop XMPP Translating Gateway Service v Updated the kql.baroc file to support Tivoli Enterprise Console event mapping changes Components of the IBM Tivoli Monitoring environment After you install and set up the Microsoft Lync Server agent, you have an environment that contains the client, server, and monitoring agent implementation for IBM Tivoli Monitoring. This IBM Tivoli Monitoring environment contains the following components: Tivoli Enterprise Portal client The portal has a user interface based on Java for viewing and monitoring your enterprise. Tivoli Enterprise Portal Server The portal server is placed between the client and the Tivoli Enterprise Monitoring Server and enables retrieval, manipulation, and analysis of data from the monitoring agents. The Tivoli Enterprise Portal Server is the central repository for all user data. Tivoli Enterprise Monitoring Server The monitoring server acts as a collection and control point for alerts received from the monitoring agents, and collects their performance and availability data. The Tivoli Enterprise Monitoring Server is also a repository for historical data. IBM Tivoli Enterprise Console The Tivoli Enterprise Console is an optional component that acts as a central collection point for events from a variety of sources, including events from other Tivoli software applications, Tivoli partner applications, custom applications, network management platforms, and relational database systems. You can view these events through the Tivoli Enterprise Portal (by using the event viewer), and you can forward events from IBM Tivoli Monitoring situations to the Tivoli Enterprise Console component. IBM Tivoli Netcool/OMNIbus Tivoli Netcool/OMNIbus is an optional component and an alternative to the Tivoli Enterprise Console. The Netcool/OMNIbus software is a service level management (SLM) system that delivers real-time, centralized monitoring of complex networks and IT domains. The Tivoli Netcool/OMNIbus components work together to collect and manage network event information. Tivoli Common Reporting Tivoli Common Reporting is a separately installable feature available to users of Tivoli software that provides a consistent approach to generating and customizing reports. Some individual products provide reports that are designed for use with Tivoli Common Reporting and have a consistent look and feel. Agent Management Services You can use IBM Tivoli Monitoring Agent Management Services to manage the Microsoft Lync Server agent. Agent Management Services is available for the following IBM Tivoli Monitoring OS agents: Windows, Linux, and UNIX. The services are designed to keep the Microsoft Lync Server agent available, and to 8 Microsoft Lync Server agent: User's Guide

19 provide information about the status of the product to the Tivoli Enterprise For more information about Agent Management Services, see "Agent Management Services" in the IBM Tivoli Monitoring Administrator's Guide. IBM Tivoli Monitoring V6.2.2, Fix Pack 2 or later provides support for Agent Management Services. User interface options Installation of the base IBM Tivoli Monitoring software and other integrated applications provides various interfaces that you can use to work with your resources and data. The following interfaces are available: Tivoli Enterprise Portal user interface You can run the Tivoli Enterprise Portal as a desktop application or a browser application. The client interface is a graphical user interface (GUI) based on Java on a Windows or Linux workstation. The browser application is automatically installed with the Tivoli Enterprise Portal Server. The desktop application is installed by using the Tivoli Monitoring installation media or with a Java Web Start application. To start the Tivoli Enterprise Portal browser client in your Internet browser, enter the URL for a specific Tivoli Enterprise Portal browser client installed on your Web server. Command-line interface You can use Tivoli Monitoring commands to manage the Tivoli Monitoring components and their configuration. You can also run commands at the Tivoli Enterprise Console event server or the Tivoli Netcool/OMNIbus ObjectServer to configure event synchronization for enterprise situations. Manage Tivoli Enterprise Monitoring Services window You can use the window for the Manage Tivoli Enterprise Monitoring Services utility to configure the agent and start Tivoli services not designated to start automatically. IBM Tivoli Netcool/OMNIbus event list You can use the Netcool/OMNIbus event list to monitor and manage events. An event is created when the Netcool/OMNIbus ObjectServer receives an event, alert, message, or data item. Each event is made up of columns (or fields) of information that are displayed in a row in the ObjectServer alerts.status table. The Tivoli Netcool/OMNIbus web GUI is also a web-based application that processes network events from one or more data sources and presents the event data in various graphical formats. IBM Tivoli Enterprise Console You can use the Tivoli Enterprise Console to help ensure the optimal availability of an IT service for an organization. The Tivoli Enterprise Console is an event management application that integrates system, network, database, and application management. If you do not already use Tivoli Enterprise Console and need an event management component, you can choose to use Tivoli Netcool/OMNIbus. IBM Tivoli Common Reporting Use the Tivoli Common Reporting web user interface for specifying report parameters and other report properties, generating formatted reports, scheduling reports, and viewing reports. This user interface is based on the Tivoli Integrated IBM Tivoli Application Dependency Discovery Manager The Discovery Management Console is the TADDM client user interface for managing discoveries. IBM Tivoli Business Service Manager The Tivoli Business Service Manager console provides a graphical user interface that you can use to logically link services and business requirements within the service model. The service model provides an operator with a second-by-second view of how an enterprise is performing at any moment in time or how the enterprise performed over a time period. Chapter 1. Overview of the agent 9

20 Data sources Monitoring agents collect data from specific data sources. The Microsoft Lync Server agent collects data from the following sources: Perfmon Use the Windows Performance Monitor, or Perfmon, to view various system and application performance metrics for collection and use by management applications. You typically view system metrics on a Windows system through the 'perfmon' application. Availability Use the agent to monitor availability of the application and related components in the following ways: v Monitor the status of the processes. v Monitor the Windows services used by the application. Scripts The agent uses application-specific commands and interfaces to gather metrics. Windows Event Log The agent collects Windows Event Log entries related to the monitored resource and forwards them to IBM Tivoli Monitoring. Table 1. Mechanisms used to gather attributes Attribute group Availability Performance Object Status Event Log Instant Messaging IM Conferencing IM MCU State and Performance IM CCCP Processing Audio Video Operations Audio Video MCU State and Performance Audio Video CCCP Processing Web Conferencing Web MCU State and Performance Web CCCP Processing User Services Endpoint Cache User Services HTTPS Transport User Services Conference Control User Services Conference Control Notification User Services MCU Allocation Latency User Services Pool Conference Statistics User Services DBStore SIP Networking SIP Peers SIP Protocols Collection source Operating System Agent NT Event Log Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter Filter 10 Microsoft Lync Server agent: User's Guide

21 Table 1. Mechanisms used to gather attributes (continued) Attribute group Collection source SIPEPS Transactions Filter MSMQ Operations Filter Archiving Service DB Operations Filter Archiving Service Read Filter Archiving Service Write Filter CDR Service DB Operations Filter CDR Service Read Filter CDR Service Write Filter X INTERNAL Archiving Service DB Operations OCS Perfmon X INTERNAL Archiving Service DB Operations Lync Perfmon X INTERNAL Archiving Service Read OCS Perfmon X INTERNAL Archiving Service Read Lync Perfmon X INTERNAL Archiving Service Write OCS Perfmon X INTERNAL Archiving Service Write Lync Perfmon X INTERNAL CDR Service DB Operations OCS Perfmon X INTERNAL CDR Service DB Operations Lync Perfmon X INTERNAL CDR Service Read OCS Perfmon X INTERNAL CDR Service Read Lync Perfmon X INTERNAL CDR Service Write OCS Perfmon X INTERNAL CDR Service Write Lync Perfmon X INTERNAL MSMQ Operations OCS Perfmon X INTERNAL MSMQ Operations Lync Perfmon Server Script X INTERNAL Instant Messaging OCS Perfmon X INTERNAL Instant Messaging Lync Perfmon X INTERNAL IM Conferencing OCS Perfmon X INTERNAL IM Conferencing Lync Perfmon X INTERNAL IM MCU State and Performance OCS Perfmon X INTERNAL IM MCU State and Performance Lync Perfmon X INTERNAL IM CCCP Processing OCS Perfmon X INTERNAL IM CCCP Processing Lync Perfmon X INTERNAL Audio Video Operations OCS Perfmon X INTERNAL Audio Video Operations Lync Perfmon X INTERNAL Audio Video MCU State and Performance Perfmon OCS X INTERNAL Audio Video MCU State and Performance Perfmon Lync X INTERNAL Audio Video CCCP Processing OCS Perfmon X INTERNAL Audio Video CCCP Processing Lync Perfmon X INTERNAL Web Conferencing OCS Perfmon Chapter 1. Overview of the agent 11

22 Table 1. Mechanisms used to gather attributes (continued) Attribute group Collection source X INTERNAL Web Conferencing Lync Perfmon X INTERNAL Web MCU State and Performance OCS Perfmon X INTERNAL Web MCU State and Performance Lync Perfmon X INTERNAL Web CCCP Processing OCS Perfmon X INTERNAL Web CCCP Processing Lync Perfmon X INTERNAL USRV Endpoint Cache OCS Perfmon X INTERNAL USRV Endpoint Cache Lync Perfmon X INTERNAL USRV HTTPS Transport OCS Perfmon X INTERNAL USRV HTTPS Transport Lync Perfmon X INTERNAL USRV Conference Control OCS Perfmon X INTERNAL USRV Conference Control Lync Perfmon X INTERNAL USRV Conference Control Notification Perfmon OCS X INTERNAL USRV Conference Control Notification Perfmon Lync X INTERNAL USRV MCU Allocation Latency OCS Perfmon X INTERNAL USRV MCU Allocation Latency Lync Perfmon X INTERNAL USRV Pool Conference Statistics OCS Perfmon X INTERNAL USRV Pool Conference Statistics Lync Perfmon X INTERNAL USRV DBStore OCS Perfmon X INTERNAL USRV DBStore Lync Perfmon X INTERNAL SIP Networking OCS Perfmon X INTERNAL SIP Networking Lync Perfmon X INTERNAL SIP Peers OCS Perfmon X INTERNAL SIP Peers Lync Perfmon X INTERNAL SIP Protocols OCS Perfmon X INTERNAL SIP Protocols Lync Perfmon X INTERNAL SIPEPS Transactions OCS Perfmon X INTERNAL SIPEPS Transactions Lync Perfmon X INTERNAL Media Planning OCS Perfmon X INTERNAL Media Planning Lync Perfmon CWA Security Perfmon CWA Directory Search Perfmon CWA Authentication Module Perfmon CWA User Session Service Perfmon Address Book Web Query Perfmon Address Book File Download Perfmon Lync Web Relay Perfmon Throttling and Authentication Perfmon Media Planning Filter 12 Microsoft Lync Server agent: User's Guide

23 Table 1. Mechanisms used to gather attributes (continued) Attribute group Collection source Lync Media Quality Perfmon QMS Agent Filter QMS Media Quality Locations Perfmon X INTERNAL QMS Agent OCS Perfmon X INTERNAL QMS Agent Lync Perfmon OCS 2k7 Roles Script OCS 2k7 R2 Roles Script Lync Server Roles Script Autodiscover Perfmon Chapter 1. Overview of the agent 13

24 14 Microsoft Lync Server agent: User's Guide

25 Chapter 2. Agent installation and configuration Agent installation and configuration requires the use of the IBM Tivoli Monitoring Installation and Setup Guide and agent-specific installation and configuration information. To install and configure the Microsoft Lync Server agent, use the Installing monitoring agents procedures in the IBM Tivoli Monitoring Installation and Setup Guide. If you are installing silently by using a response file, see Performing a silent installation of IBM Tivoli Monitoring in the IBM Tivoli Monitoring Installation and Setup Guide. With the self-describing agent capability, new or updated IBM Tivoli Monitoring agents using IBM Tivoli Monitoring V6.2.3 or later can become operational after installation without having to perform additional product support installation steps. To take advantage of this capability, see Enabling self-describing agent capability at the hub monitoring server in the IBM Tivoli Monitoring Installation and Setup Guide. Also, see Self-describing monitoring agents in the IBM Tivoli Monitoring Administrator's Guide. Requirements Before installing and configuring the agent, make sure your environment meets the requirements for the IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Lync Server Agent. For information about requirements, see the Prerequisites topic for the agent in the ( publib.boulder.ibm.com/infocenter/ tivihelp/v24r1/topic/com.ibm.itcamms.doc_6.3/ welcome_msapps63.html). Language pack installation The steps for installing language packs depend on which operating system and mode of installation you are using. To install a language pack for the agent support files on the Tivoli Enterprise Monitoring Server, the Tivoli Enterprise Monitoring Agent, and the Tivoli Enterprise Portal Server, make sure that you installed the product in the English language. Then use the steps for the operating system or mode of installation you are using: v Installing language packs on Windows systems v Installing language packs on UNIX or Linux systems on page 16 v Silent installation of language packs on Windows, UNIX, or Linux systems on page 16 Installing language packs on Windows systems You can install the language packs on a Windows system. Before you begin First, make sure that you installed the product in the English language. Procedure 1. On the language pack CD, double-click the lpinstaller.bat file to start the installation program. 2. Select the language of the installer and click OK. 3. In the Introduction panel, click Next Copyright IBM Corp. 2011,

26 4. Click Add/Update and click Next. 5. Select the folder where the National Language Support package (NLSPackage) files are located. Typically, the NLSPackage files are located in the nlspackage folder where the installer executable file is located. 6. Select the language support for the agent of your choice and click Next. To make multiple selections, press Ctrl and select the language that you want. 7. Select the languages that you want to install and click Next. 8. Examine the installation summary page and click Next to begin installation. 9. After installation completes, click Finish to exit the installer. 10. Restart the Tivoli Enterprise Portal, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of these components are installed. Installing language packs on UNIX or Linux systems You can install the language packs on a UNIX or Linux system. Before you begin First, make sure that you installed the product in the English language. Procedure 1. Enter the mkdir command to create a temporary directory on the computer, for example, mkdir dir_name. Make sure that the full path of the directory does not contain any spaces. 2. Mount the language pack CD to the temporary directory that you created. 3. Enter the following command to start the installation program: cd dir_name lpinstaller.sh -c install_dir where install_dir is where you installed IBM Tivoli Monitoring. Typically, the directory name is /opt/ibm/itm for UNIX and Linux systems. 4. Select the language of the installer and click OK. 5. In the Introduction panel, click Next. 6. Click Add/Update and click Next. 7. Select the folder where the National Language Support package (NLSPackage) files are located. Typically, the NLSPackage files are located in the nlspackage folder where the installer executable file is located. 8. Select the language support for the agent of your choice and click Next. To make multiple selections, press Ctrl and select the language that you want. 9. Select the languages that you want to install and click Next. 10. Examine the installation summary page and click Next to begin installation. 11. After installation completes, click Finish to exit the installer. 12. Restart the Tivoli Enterprise Portal, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of these components are installed. Silent installation of language packs on Windows, UNIX, or Linux systems You can use the silent-mode installation method to install the language packs. In silent mode, the installation process obtains the installation settings from a predefined response file. It does not prompt you for any information. Before you begin First, make sure that you installed the product in the English language. 16 Microsoft Lync Server agent: User's Guide

27 Procedure 1. Copy and paste the ITM_Agent_LP_silent.rsp response file template as shown in Response file example. 2. Change the following parameter settings: NLS_PACKAGE_FOLDER Folder where the National Language Support package (NLSPackage) files are located. Typically, the NLSPackage files are located in the nlspackage folder, for example: NLS_PACKAGE_FOLDER = //tmp//lp//nlspackage. PROD_SELECTION_PKG Name of the language pack to install. Several product components can be included in one language package. You might want to install only some of the available components in a language pack. BASE_AGENT_FOUND_PKG_LIST Agent for which you are installing language support. This value is usually the same as PROD_SELECTION_PKG. LANG_SELECTION_LIST Language you want to install. 3. Enter the command to install the language pack with a response file (silent installation): v For Windows systems: lpinstaller.bat -f path_to_response_file v For UNIX or Linux systems: lpinstaller.sh -c candle_home -f path_to_response_file where candle_home is the IBM Tivoli Monitoring base directory. Response file example # IBM Tivoli Monitoring Agent Language Pack Silent Installation Operation # #This is a sample response file for silent installation mode for the IBM Tivoli #Monitoring Common Language Pack Installer. #. #This file uses the IBM Tivoli Monitoring Common Agent Language Pack with the #install package as an example. #Note: #This response file is for the INSTALLATION of language packs only. #This file does not support UNINSTALLATION of language packs in silent mode. # # #To successfully complete a silent installation of the the example of Common Agent #localization pack, complete the following steps: # #1.Copy ITM_Agent_LP_silent.rsp to the directory where lpinstaller.bat or #lpinstaller.sh is located (IBM Tivoli Monitoring Agent Language Pack build #location). # #2.Modify the response file so that it is customized correctly and completely for #your site. # Complete all steps listed below in the response file. # #3.After customizing the response file, invoke the silent installation using the #following command: #For Windows: # lpinstaller.bat -f <path_to_response_file> #For UNIX and Linux: # lpinstaller.sh -c <candle_home> -f <path_to_response_file> #Note:<candle_home> is the IBM Tivoli Monitoring base directory. # Chapter 2. Agent installation and configuration 17

28 # #Force silent install mode. # INSTALLER_UI=silent # #Run add and update actions. # CHOSEN_INSTALL_SET=ADDUPD_SET # #NLS Package Folder, where the NLS Packages exist. #For Windows: # Use the backslash-backslash(\\) as a file separator (for example, #C:\\zosgmv\\LCD \\nlspackage). #For UNIX and Linux: # Use the slash-slash (//) as a file separator (for example, #//installtivoli//lpsilenttest//nlspackage). # #NLS_PACKAGE_FOLDER=C:\\zosgmv\\LCD \\nlspackage NLS_PACKAGE_FOLDER=//tmp//LP//nlspackage # #List the packages to process; both variables are required. #Each variable requires that full paths are specified. #Separate multiple entries with a semicolon (;). #For Windows: # Use the backslash-backslash(\\) as a file separator. #For Unix and Linux: # Use the slash-slash (//) as a file separator. # #PROD_SELECTION_PKG=C:\\zosgmv\\LCD \\nlspackage\\KIP_NLS.nlspkg #BASE_AGENT_FOUND_PKG_LIST=C:\\zosgmv\\LCD \\nlspackage\\KIP_NLS.nlspkg PROD_SELECTION_PKG=//tmp//LP//nlspackage//kex_nls.nlspkg;//tmp//LP//nlspackage// koq_nls.nlspkg BASE_AGENT_FOUND_PKG_LIST=//tmp//LP//nlspackage//kex_nls.nlspkg;// tmp//lp//nlspackage//koq_nls.nlspkg # #List the languages to process. #Separate multiple entries with semicolons. # LANG_SELECTION_LIST=pt_BR;fr;de;it;ja;ko;zh_CN;es;zh_TW Prerequisites checking The prerequisite checker utility verifies whether all the prerequisites that are required for the agent installation are met. The prerequisite checker creates a log file that contains a report of all the prerequisites checks when the prerequisite checker was run. For the Microsoft Lync Server agent, the prerequisite checker verifies the following requirements: v Memory v Disk v Operating systems v Microsoft Lync Server or Microsoft OCS versions Additionally, the prerequisite checker verifies whether the user, who installs the agent, is a member of the Administrators group. For detailed information about installation prerequisites, see the Prerequisites topic for the agent in the IBM Tivoli Composite Application Manager for Microsoft Applications Information Center ( welcome_msapps63.html).. 18 Microsoft Lync Server agent: User's Guide