AppManager for Microsoft Office SharePoint Server

NetIQ® AppManager® for Microsoft Office SharePoint Server

Management GuideMarch 2007

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

© 1995-2007 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. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (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.

ActiveAgent, ActiveAnalytics, ActiveAudit, ActiveReporting, ADcheck, AppAnalyzer, AppManager, the cube logo design, Directory and Resource Administrator, Directory Security Administrator, Domain Migration Administrator, Exchange Administrator, File Security Administrator, IntelliPolicy, Knowing is Everything, Knowledge Scripts, Mission Critical Software for E-Business, MP3check, NetConnect, NetIQ, the NetIQ logo, NetIQ Change Administrator, NetIQ Change Guardian, NetIQ Compliance Suite, NetIQ Group Policy Administrator, NetIQ Group Policy Guardian, NetIQ Group Policy Suite, the NetIQ Partner Network design, NetIQ Patch Manager, NetIQ Risk and Compliance Center, NetIQ Secure Configuration Manager, NetIQ Security Administration Suite, NetIQ Security Analyzer, NetIQ Security Manager, NetIQ Vulnerability Manager, PSAudit, PSDetect, PSPasswordManager, PSSecure, Server Consolidator, VigilEnt, Vivinet, Work Smarter, and XMP are trademarks or registered trademarks of NetIQ Corporation or its subsidiaries in the United States and other jurisdictions. All other company and product names mentioned are used only for identification purposes and may be trademarks or registered trademarks of their respective companies.

Contents

About This Guide 3

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Conventions Used in this Guide . . . . . . . . . . . . . . . . . . . 4Using Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Other Information in the Library . . . . . . . . . . . . . . . . . . . 5About Attachmate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Chapter 1 Introduction to AppManager for Microsoft Office SharePoint Server9What’s New in this Release . . . . . . . . . . . . . . . . . . . . . . 9Why Monitor SharePoint? . . . . . . . . . . . . . . . . . . . . . . 10How AppManager Can Help . . . . . . . . . . . . . . . . . . . . . 11

Chapter 2 Installing AppManager for Microsoft Office SharePoint Server13

Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Understanding the SharePoint Managed Object . . . . . 13System and Account Requirements . . . . . . . . . . . . . . . 14Downloading and Extracting the Software Package . . 15Installing AppManager for Microsoft Office SharePoint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Upgrading Existing Knowledge Script Jobs . . . . . . . . . 17Configuring AppManager for Microsoft Office SharePoint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Discovering and Viewing Microsoft Office SharePoint

i

Server Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 3 SharePoint Knowledge Scripts 27

How Knowledge Scripts Access SharePoint Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29BytesTransfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30ConnectionsInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32DBSpaceUtil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34HealthCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36IsolatedApps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38ServerUptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40ServiceUptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41SiteInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42SiteUsage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45WebPagePerf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47WebPartInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49Report_ServerUptime . . . . . . . . . . . . . . . . . . . . . . . . . . .51Report_SiteInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55Report_SiteUsage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59Report_WebPartInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . .63Discovery_SharePoint . . . . . . . . . . . . . . . . . . . . . . . . . . .67

Contents ii

About This Guide

The NetIQ® AppManager® Suite (or AppManager) is a comprehensive solution for managing, diagnosing, and analyzing performance, availability, and server health for a broad spectrum of operating environments, applications, 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 AudienceThis management guide, AppManager for Microsoft Office SharePoint Server, provides information to ensure a successful installation of NetIQ AppManager components. This guide is intended for system administrators and users responsible for installing all or part of the AppManager Suite software.

For more information about working with AppManager, see the User Guides for the Operator Console or Control Center. For more information about configuring and maintaining an AppManager management site, see the Administrator Guide.

3

Conventions Used in this GuideThis guide uses consistent conventions to help you identify items throughout the documentation. The following table summarizes these conventions.

Using Online HelpAppManager provides task-based, reference, and context-sensitive online Help.

To access task-based Help or search for Help topics, click Help Topics on the Help menu. To view context-sensitive Help within dialog boxes, click Help or press F1.

You can get help on individual Knowledge Scripts in one of the following ways:● On the Values tab of the Knowledge Script Properties

dialog box, click Help or press F1.

● In the Knowledge Script pane of the Operator Console, highlight a Knowledge Script and press F1.

● In the Knowledge Script view of the Control Center Console, highlight a Knowledge Script and press F1.

Convention Use

Bold • Window and menu items• Technical terms, when introduced

Italics • Book and installation kit 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

4 AppManager for Microsoft Office SharePoint Server

Other Information in the LibraryThe library provides the following information resources:● Installation Guide: Provides complete information about

AppManager pre-installation requirements and step-by-step installation procedures for all AppManager components.

● Control Center User Guide: Provides complete information about managing groups of computers, including running jobs, responding to events, creating reports, and working with the Control Center Console. A separate guide is available for the AppManager Operator Console.

● Administrator Guide: 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: Provides complete information on how to upgrade from a previous version of AppManager.

● Management Guides: Provide information about installing and monitoring specific applications with AppManager.

The AppManager library is available in Adobe Acrobat (PDF) format and is located in the \Documentation folder of the AppManager installation kit.

NetIQ Online Support and Extended Support Web sites provide other resources:● Downloads, including hotfixes, service packs, and product

upgrades.

● Documentation, including white papers and the most current information about version support for the systems and applications monitored by AppManager.

Note You can access NetIQ Support without a password or registration. To access the Extended Support site, you must be

About This Guide 5

a registered AppManager customer.

In addition to the AppManager documentation, you may want to consult the documentation for your Microsoft Windows or UNIX operating system, or other application- or system-specific documentation for reference and conceptual information. This background information can help you get the most out of your AppManager installation.

About AttachmateAttachmate, owned by an investment group led by Francisco Partners, Golden Gate Capital and Thoma Cressey Equity Partners, enables IT organizations to extend mission critical services and assure they are managed, secure and compliant. Attachmate’s leading solutions include host connectivity, systems and security management, and PC lifecycle management. Our goal is to empower IT organizations to deliver trusted applications, manage service levels, and ensure compliance by leveraging knowledge, automation and secured connectivity. For more information, visit www.attachmate.com.

NetIQ Solutions from Attachmate

Attachmate provides a wide selection of systems and security management solutions to help you manage and secure all your essential platforms, including Windows, Unix, Linux, and iSeries. These Knowledge-Based Service Assurance products and solutions include embedded knowledge and tools to implement industry best practices and to better ensure operational integrity, manage service levels and risk, and ensure policy compliance. Our modular, best-of-breed solutions for Performance and Availability Management, Security Management, Configuration and Vulnerability Management, and Operational Change Control integrate through an open, service-oriented architecture allowing for common reporting, analytics and dashboards. Attachmate


http://www.attachmate.com

offers the following systems and security management solutions:● Performance and Availability Management These

products offer rapid time-to-value solutions that enable you to align your IT operations with business priorities and optimize the delivery of your IT-based business services. This solution automates the complete IT service management lifecycle: assessment of requirements, definition of Service Level Agreements, management of day-to-day operations, and review of operational metrics.

● Security Management These easy-to-install-and-deploy products provide effective protection from and response to security-related threats. This solution provides powerful features, such as real-time security event monitoring, mapping of threat indicators, policy violation alerts, and expedited incident forensics and resolution. These products reduce the time required to identify and resolve security threats.

● Configuration and Vulnerability Management These products allow you to quickly and easily assess vulnerabilities, manage security risks, and assure policy compliance. This powerful solution measures and enforces compliance to configuration baselines based on your corporate policies, regulations, and evolving security threats. You can use the latest security knowledge, which is updated in real time, to resolve compliance and configuration issues.

● Operational Change Control These products enable IT organizations to control, manage, and audit operational changes to servers, Active Directory, and Group Policy with unprecedented levels of accountability. NetIQ’s Operational Change Control (OCC) solutions enable enterprise customers to meet IT compliance and operational integrity needs in the most cost-effective manner, by delegating

About This Guide 7

access control, managing changes according to policy, and alerting and reporting on change activities and entitlements.

Contacting NetIQ Solutions Support

Please contact us with your questions and comments. We look forward to hearing from you.

Sales Email: [email protected]

Telephone: 713.418.5555 (United States) +353 (0) 91 782 677 (Europe, Middle East, and Africa)For other locations, see our Support Contact Information Web site at www.netiq.com/support

Support: www.netiq.com/support

Support Web Site: www.netiq.com


mailto:[email protected]

http://www.netiq.com/support


http://www.netiq.com

Chapter 1

Introduction to AppManager for Microsoft Office SharePoint Server

Microsoft Office SharePoint Server is a collaborative portal application based on the Microsoft Windows SharePoint services platform.

SharePoint technology integrates Microsoft Windows with the World Wide Web using a combination of HTTP, XML, XSL, and SOAP technologies. Typical components of SharePoint include ASP.NET pages served using Internet Information Server version 6 or later, and a Microsoft SQL Server for storing data.

This chapter provides a brief introduction to Microsoft Office SharePoint Server and an overview of key concepts and terminology. This chapter also summarizes the ways AppManager can help you monitor Microsoft Office SharePoint Server.

The following topics are covered:● “What’s New in this Release” on page 9

● “Why Monitor SharePoint?” on page 10

● “How AppManager Can Help” on page 11

What’s New in this ReleaseAppManager for Microsoft Office SharePoint Server version 7.0 adds several improvements in terms of performance, functionality and Knowledge Scripts.

This release of AppManager for Microsoft Office SharePoint Server comprises the following changes:

9

● Support for Windows SharePoint Services versions 2.0 and 3.0

● Support for both Microsoft SharePoint Portal Server 2003 and Microsoft Office SharePoint Server 2007 running on AppManager versions 6.0.2 or later.

● Consolidation of the SiteDateInfo and SiteSpaceUtil Knowledge Scripts into a single Knowledge Script called SiteInfo.

● New report Knowledge Script called Report_SiteInfo to collect information from the SiteInfo Knowledge Script and display it in report format.

Why Monitor SharePoint?SharePoint provides real-time collaboration for enterprises spread over disparate geographical locations. You can configure Microsoft SharePoint to run separate content for intranet, extranet, and internet locations. For example, you can integrate your customers’ information systems with your SharePoint portal for quicker and better collaboration.

SharePoint also enables you to search for resources outside your enterprise and add them to your internal SharePoint portal.

From a user’s perspective, SharePoint enables access to folders, files, and documents on the Web by implementing the Web storage system. Users with little technical skills can add, modify, delete, and search for documents. Additionally, users can set up discussions on documents, assign categories, and create taxonomy for corporate data. Any number of user groups can perform these activities concurrently.

Continuously monitor the performance of your SharePoint portal to ensure these functions run without any problems. Monitoring is critical if your customers’ information systems


are integrated with your SharePoint portal. Typically, performance monitoring helps you identify performance bottlenecks and take corrective action. Regular performance monitoring helps you recognize trends and prevent future performance problems.

How AppManager Can Help AppManager for Microsoft Office SharePoint Server provides several Knowledge Scripts that enable you to identify and monitor the availability and connectivity to a Microsoft Office SharePoint Server and server database. These Knowledge Scripts provide a complete view of how SharePoint performs in your environment.

SharePoint Knowledge Scripts include the following capabilities:● Monitoring the complete SharePoint server environment

● Monitoring connectivity to the SharePoint content database server

● Analyzing and reporting database space usage by different SharePoint sites

● Monitoring and reporting the performance of web parts in the SharePoint environment

● Monitoring the duration for which the system has been operational since the last reboot

● Tracking the availability and performance of Web pages of a Web application within the SharePoint environment

● Displaying all sites available within the enterprise SharePoint environment including sites newly added, modified or deleted

● Monitoring the number of current connections available to a SharePoint Web site from anonymous and non-anonymous accounts

Chapter 1 • Introduction to AppManager for Microsoft Office SharePoint Server 11

● Monitoring the number of bytes transferred per second to and from a SharePoint Web site

● Monitoring the status of SharePoint services and Web sites


Chapter 2

Installing AppManager for Microsoft Office SharePoint Server

This chapter describes the procedure for installing AppManager for Microsoft Office SharePoint Server. The information in this chapter applies only if you have installed AppManager 6.0.2 and 7.0.

Installation ChecklistInstall AppManager for Microsoft Office SharePoint Server by completing the following checklist:

Understanding the SharePoint Managed ObjectAppManager for Microsoft Office SharePoint Server includes an updated managed object for SharePoint and Knowledge Scripts to discover SharePoint resources and monitor the SharePoint environment.

Steps Section to Review

1 Verify system and account requirements.

“System and Account Requirements” on page 14

2 Obtain the latest product version.

“Downloading and Extracting the Software Package” on page 15

3 Run the setup program on the local computer.

“Installing AppManager for Microsoft Office SharePoint Server” on page 17

4 Upgrade existing Knowledge Script jobs.

“Upgrading Existing Knowledge Script Jobs” on page 17

5 Configure Microsoft Office SharePoint Server.

“Configuring AppManager for Microsoft Office SharePoint Server” on page 17

13

For more information about SharePoint Knowledge Scripts, see Chapter 3, “SharePoint Knowledge Scripts.”

System and Account RequirementsThe pre-installation check program, which runs automatically when you launch the setup program, verifies system requirements. To successfully monitor SharePoint, your environment must meet the following requirements:

Item Requirement Description

AppManager Version 6.0.2 or later The AppManager repository, management server, and Operator Console must be installed.

Monitored Server—Microsoft SharePoint Portal Server 2003

• AppManager Agent version 6.0.2 or later

• Internet Information Server 6.0 or later

• ASP.NET• Microsoft

SharePoint Portal Server 2003

• Microsoft Windows SharePoint Services 2.0

• Microsoft SharePoint Portal Server 2003 with Service Pack 2 running on Microsoft SQL Server 2000

These components need to be installed on each SharePoint Server that you want to monitor. AppManager for Microsoft SharePoint Portal Server 2003 also supports Internet Information Server running on 32-bit computers. AppManager for Microsoft SharePoint Portal Server 2003 does not support earlier versions of SharePoint Portal Server, for example, SharePoint Portal Server 2001.


Downloading and Extracting the Software PackageTo verify whether you have the most recent version of AppManager for Microsoft Office SharePoint Server, access a list of the latest software versions and service packs in the Support area of the NetIQ Web site: http://www.netiq.com/support.

Download the appropriate package of AppManager for Microsoft Office SharePoint Server from the NetIQ Web site to a Microsoft Windows computer that has access to the computer you want to monitor.

Monitored Server—Microsoft Office SharePoint Server 2007

• AppManager Agent version 6.0.2 or later

• Internet Information Server 6.0 or later

• ASP.NET version 2.0

• Microsoft Windows SharePoint Services 3.0

• Microsoft Office SharePoint Server 2007

• Microsoft SQL Server 2005

These components need to be installed on each Microsoft Office SharePoint Server 2007 that you want to monitor. You need to install Microsoft .NET Framework 3.0 to enable Microsoft Office SharePoint Server 2007 for Search.The Setup program for Microsoft Office SharePoint Server 2007 automatically detects whether you have Microsoft SQL Server 2005 on your computer. If Microsoft SQL Server 2005 is not available on your computer, the Setup program installs MSDE, a “lite” version of Microsoft SQL Server 2005.

Operating System Windows Server 2003 on 32-bit computers only

You cannot install SharePoint on other Microsoft Windows operating systems such as Windows 2000.

Accounts/Permissions

Administrator or Power User

All users who monitor the SharePoint environment must have either an administrator account or an account with Power User permissions

Item Requirement Description

Chapter 2 • Installing AppManager for Microsoft Office SharePoint Server 15




The following packages are available:

When the download is complete, the files are automatically extracted from the software package and placed in the folder you specified.

If you are downloading AppManager for Microsoft Office SharePoint Server for AppManager version 6.0.2, the download package automatically extracts the following files:● AMxx_SharePoint_setup.exe

● AppManagerForSharePoint.pdf

● AppManagerForSharePoint_ReadMe.htm

● AM-English-SharePoint.kbc

If you are downloading AppManager for Microsoft Office SharePoint Server for AppManager version 7.0, the download package automatically extracts the following files:● AMxx-SharePoint-xx.msi

● AMxx-SharePoint-xx.xml

● AMxx-SharePoint-xx.ini

● AppManagerForSharePoint_ReadMe.htm

AppManager version

Microsoft SharePoint Version

Download Package

AppManager 6.0.2 Microsoft SharePoint Portal Server 2003

AM602_SharePoint2003_70.exe

Microsoft Office SharePoint Server 2007


AppManager 7.0 Microsoft SharePoint Portal Server 2003


Microsoft Office SharePoint Server 2007



● AppManagerForSharePoint.pdf

● AM-English-SharePoint.kbc

● ckSharePoint.exe

Installing AppManager for Microsoft Office SharePoint Server

You can install AppManager for Microsoft Office SharePoint Server in one of the following ways:● Use Control Center to install the module on a remote

computer where an AppManager agent is installed.

● Run the AppManager setup program, and install the module when installing AppManager.

For more information about installing modules, see the AppManager Installation Guide.

Upgrading Existing Knowledge Script JobsIf you have Knowledge Scripts from previous versions of AppManager for Microsoft Office SharePoint Server already running in your environment, upgrade these Knowledge Scripts to the latest version. For more information about upgrading Knowledge Script jobs, see the AppManager Upgrade and Migration Guide.

Configuring AppManager for Microsoft Office SharePoint Server

This section describes the procedure for configuring AppManager for Microsoft Office SharePoint Server to enable AppManager to discover your SharePoint environment. You must log in either as an administrator or a power user to configure Microsoft Office SharePoint Server.


Configuring Microsoft Office SharePoint Server comprises the following steps:● “Verifying SharePoint-related Services” on page 18

● “Extending a Virtual Server” on page 19

● “Creating a Portal Site” on page 20

● “Enabling Logging” on page 20

● “Enabling Portal Usage Reporting” on page 22

● “Activating Portal Usage Reporting” on page 23

Verifying SharePoint-related Services

When you install Microsoft Office SharePoint Server, the following services are created:● Microsoft SharePointPS Search

● SharePoint Portal Administration

● SharePoint Portal Alert

● SharePoint Timer Service

● Microsoft Single Sign-on Service

● World wide web publishing Service (w3svc)

Note Microsoft Single Sign-on Service is not a SharePoint-specific service. It is a shared service that you can use if you want to enable the single sign-on feature for your SharePoint portal.

To successfully discover SharePoint, ensure all of these services are running.

To verify whether these services are running:

1 On the computer where you have installed Microsoft Office SharePoint Server, click Start > Settings > Control Panel.

2 Click Administrative Tools > Services.


3 Verify that the Status column displays Started for the following services:

■ Microsoft SharePointPS Search

■ SharePoint Portal Administration

■ SharePoint Portal Alert

■ SharePoint Timer Service

■ Microsoft Single Sign-on Service

■ World wide web publishing Service (w3svc)

4 If the service is not running, right-click the service and select Start.

Extending a Virtual Server

A virtual server is a virtual computer that resides on an HTTP server but appears to the user as a separate HTTP server. Several virtual servers can reside on the same computer. Each virtual server is capable of running its own programs and can have its own domain name and IP address.

Microsoft SharePoint Services uses virtual servers to host Web sites on your server. The process of applying SharePoint Services to a virtual server is called extending a virtual server.

You need to extend at least one virtual server in your SharePoint environment so that you can discover and monitor it.

Installing Microsoft Office SharePoint Server extends a default virtual server that you can use. For more information on extending virtual servers, see the Microsoft Office SharePoint Server Administrator’s Guide that ships with Microsoft Office SharePoint Server.

Note Each time you extend a new virtual server, you need to run the Discovery_SharePoint Knowledge Script to discover it. After the new virtual server has been successfully discovered, it


is automatically displayed as the last item under the Virtual Servers icon.

Creating a Portal Site

Microsoft Office SharePoint Server lets you specify the maximum number of defined portal sites. This number is typically set by the SharePoint administrator. However, at least one portal site must be available in your SharePoint environment so that you can discover and monitor it.

SharePoint does not create a default portal site when you install it. You need to create portal sites manually. For more information on creating portal sites, see the Microsoft Office SharePoint Server Administrator’s Guide that ships with Microsoft Office SharePoint Server.

Enabling Logging

Microsoft Office SharePoint Server includes a logging feature that enables you to track how Web sites on your server are being used. By default, logging is disabled for your Microsoft Office SharePoint Server. Enable logging so AppManager for Microsoft Office SharePoint Server can track and report usage data for your SharePoint environment.

Note You need to enable logging to run the SiteUsage and WebPagePerf Knowledge Scripts.

To enable logging in Microsoft SharePoint Portal Server 2003:

1 Click Start > Programs > SharePoint Portal Server > SharePoint Central Administration.

2 Under Component Configuration, click Configure usage analysis processing.

3 In the Logging Settings section, select Enable logging.


4 Enter the location to store the Log files. The default location for the log file is C:\Windows\system32\LogFiles\STS.

5 In Number of log files to create, enter a number between 1 and 30. SharePoint permits a maximum of 30 log files.

6 In the Processing Settings section, select Enable usage analysis processing.

7 Under Run processing between these times daily, specify the time range to start the usage analysis log processing.

8 Enter the time range in the Start and End fields.

9 Click OK to complete the configuration.

To enable logging in Microsoft Office SharePoint Server 2007:

1 Click Start > Programs > Microsoft Office Server > SharePoint 3.0 Central Administration.

2 Click the Operations tab.

3 Under Logging and Reporting, click Usage analysis processing.

4 Select Enabling Logging.

5 In Log file location, enter the location where you want to store the log files. The default location is C:\Program Files\Common Files\Microsoft Shared\Web Server

Extensions\12\Logs.

6 In Number of log files to create, enter a number between 1 and 30. SharePoint permits a maximum of 30 log files.

7 Select Enable usage analysis processing.


8 Under Run processing between these times daily, specify the time range to start the usage analysis log processing.

9 Enter the time range in the Start and End fields.


Note If the SharePoint configuration and content databases are installed on a SQL clustered environment, NetIQ services should be run only by a SharePoint administrator on the computer where you have installed the Microsoft Office SharePoint Server.

Enabling Portal Usage Reporting

Microsoft Office SharePoint Server includes a reporting feature that creates reports about information in Windows SharePoint Services. By default, reporting is disabled for your Microsoft Office SharePoint Server. Enable reporting so AppManager for Microsoft Office SharePoint Server can use the reports in your SharePoint environment. You must enable the portal usage reporting service after Windows SharePoint Services usage logging is enabled in the server farm.

Note Portal usage enabling is required to run the SiteUsage Knowledge Script in Microsoft Office SharePoint Server 2007.

To enable portal usage reporting:


2 Under Shared Services Administration, click on the portal site for which you want to enable reporting.

3 Under Office SharePoint Usage Reporting, click Usage reporting.


4 Under Processing Settings, click Enable advanced usage analysis processing.

5 Under Search Query Logging , click Enable search query logging.


Activating Portal Usage Reporting

You must activate the reporting feature for a SharePoint Server portal after enabling usage reporting. The portal usage reports are not available if you do not activate portal usage reporting.

To activate portal usage reporting:


2 Under Shared Services Administration, click on the portal site for which you want to enable reporting.

3 In the Site Actions menu, click Site Settings.

4 Under Site Collection Administration, click Site collection features.

5 Locate Reporting in the Name column.

6 Click Activate.

Discovering and Viewing Microsoft Office SharePoint Server Resources

To discover Microsoft Office SharePoint Server for the first time, ensure you have configured the Microsoft Office SharePoint Server. For more information about configuring the Microsoft Office SharePoint Server, see “Configuring AppManager for Microsoft Office SharePoint Server” on page 17.


When you discover SharePoint resources for the first time, the TreeView pane in the AppManager Operator Console or Control Center Console displays the following information about the SharePoint environment:● Microsoft Office SharePoint Server with the following

naming convention: SharePoint Server:<server name>

● SharePoint Server resources:

■ Services

■ Database: All content databases defined on the SharePoint portal.

■ Virtual Servers: All virtual servers defined on the SharePoint portal.

To discover SharePoint resources in your AppManager Operator Console or Control Center Console:

1 Install the NetIQ AppManager agent and the AppManager for Microsoft Office SharePoint Server managed object on computers where SharePoint is running.

2 Add these computers to the Operator Console or Control Center Console TreeView.

3 Install the SharePoint Knowledge Scripts on the AppManager repository computer.

4 In the Knowledge Script pane, click the Discovery tab.

5 Drag the Discovery_SharePoint Knowledge Script to the computers in the TreeView pane where you have installed the AppManager agent, and the SharePoint managed object.

6 Click the Schedule tab to review the schedule. By default, Discovery jobs are set to Run once.

7 Click the Values tab, and set the event severity levels for successful and failed Discovery events.


8 Click OK to start the Discovery job.

After you run the Discovery_SharePoint Knowledge Script, you should see the new SharePoint view and SharePoint Knowledge Script category in the Operator Console or Control Center Console. You are now ready to begin monitoring the Microsoft Office SharePoint Server through the Operator Console or Control Center Console.

Note Each time you extend a new virtual server, you need to run the Discovery_SharePoint Knowledge Script to discover it. After the new virtual server has been successfully discovered, it is automatically displayed as the last item under the Virtual Servers object in the TreeView pane of the Operator Console or Control Center Console.



Chapter 3

SharePoint Knowledge Scripts

The SharePoint category provides the following Knowledge Scripts to monitor the operation of Microsoft Microsoft Office SharePoint Server on Microsoft Windows computers.

For information about requirements to run SharePoint Knowledge Scripts, see “How Knowledge Scripts Access SharePoint Resources,” on page 29.

From the Knowledge Script view of the Control Center Console, you can access more information about any Knowledge Script by selecting it and pressing F1. In the Operator Console, click any Knowledge Script in the Knowledge Script pane and press F1.

Knowledge Script What It Does

BytesTransfer Monitors the total number of bytes transferred per second to and from a Web site.

ConnectionsInterval Monitors the number of Web site connections from anonymous and non-anonymous (or user) accounts.

DBSpaceUtil Monitors the percentage of space utilized by the SharePoint content database.

HealthCheck Monitors the status of SharePoint services and Web sites.

IsolatedApps Monitors the number of isolated applications in your SharePoint environment.

ServerUptime Monitors the number of hours the SharePoint Server has been operational since the last reboot.

27

Note If the IIS Admin Service is down, running any SharePoint Knowledge Script automatically restarts the service. This functionality is built into SharePoint.

ServiceUptime Monitors the uptime of Web sites in your Microsoft Office SharePoint Server.

SiteInfo Monitors date and space utilization information about each site on the SharePoint Server.

SiteUsage Displays specific information about each site on the Microsoft Office SharePoint Server.

WebPagePerf Identifies and monitors the availability and performance of a Web application’s Web pages in your Microsoft Office SharePoint Server.

WebPartInfo Monitors the status and availability of web parts used by the SharePoint server.

Report_ServerUptime Generates a report about the number of hours the Microsoft Office SharePoint Server has been operational since the last reboot.

Report_SiteInfo Generates a report of information about each site on the Microsoft Office SharePoint Server sorted by date.

Report_SiteUsage Generates a report that contains usage information about each Web site on the Microsoft Office SharePoint Server.

Report_WebPartInfo Generates a report about the status and availability of web parts used by the Microsoft Office SharePoint Server.

Discovery_SharePoint Discovers configuration and resource information for SharePoint Portal Servers.

Knowledge Script What It Does


How Knowledge Scripts Access SharePoint Resources

To gather the statistics and resource information needed to monitor your SharePoint environment, a SharePoint Knowledge Script must log on to that environment. Typically, SharePoint Central Administration controls access to your SharePoint environment. However, the AppManager user’s Windows account determines the security privileges available to the user relative to SharePoint. Therefore, not all users can run all Knowledge Scripts.

To ensure security, some Knowledge Scripts can be run only by users with either the Administrator or power user privileges.

For information about configuring Microsoft Microsoft Office SharePoint Server, see Chapter 2, “Installing AppManager for Microsoft Office SharePoint Server.” More information is also available on the NetIQ AppManager Extended Support Web page at www.netiq.com/support.

Chapter 3 • SharePoint Knowledge Scripts 29


BytesTransferUse this Knowledge Script to monitor the total number of bytes transferred per second to and from a Web site. If the total number of transferred bytes exceeds the threshold you set, an event is raised.

Resource Objects

SharePoint Server: Virtual Server and Virtual Server icon.

Default Schedule

The default interval for this script is Every 30 minutes.

Setting Parameter Values

Set the following parameters as needed:

Description How to Set It

Raise event if number of bytes transferred per second exceeds a threshold?

Set to Yes to raise an event if the number of bytes transferred per second exceeds the threshold you have specified.By default, events are enabled.

Collect data for current transfer rate (bytes sent, bytes received)?

Set to Yes to collect data for charts and reports. If you select Yes, byte transfer rate data is collected for the server.By default, data is not collected.

Threshold -- Maximum bytes received per second

Enter the maximum number of bytes per second that can be received by the server before an event is raised.The default is 64000 bytes per second.


Threshold -- Maximum bytes sent per second

Enter the maximum number of bytes per second that can be sent by the server before an event is raised. The default is 64000 bytes per second.

Event severity when bytes transferred exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a threshold is exceeded.The default severity level is 10.



ConnectionsIntervalUse this Knowledge Script to monitor the number of Web site connections—and totals for all Web sites—from anonymous and non-anonymous (or user) accounts during the monitoring interval. If the number of Web site connections exceeds any threshold, an event is raised. You can set the following thresholds:

● Maximum number of connections from anonymous accounts

● Maximum number of connections from non-anonymous accounts

● Maximum total number of connections to Web sites from anonymous accounts

● Maximum total number of connections to Web sites from non-anonymous accounts

Note Before you can run this Knowledge Script, you need to first enable anonymous access to Web sites in your SharePoint portal. For information on enabling anonymous access, see your Microsoft Microsoft Office SharePoint Server documentation.

Resource Objects


Default Schedule


Note If the schedule is set to Run once, the value returned is the current total.





Raise event if number of connections exceeds any threshold?

Set to Yes to raise an event if the number of connections exceeds the threshold you have specified.By default, events are enabled.

Collect data for number of connections?

Set to Yes to collect data for charts and reports. If you select Yes, the number of Web server connections during the monitoring interval is returned. By default, data is not collected.

Threshold -- Maximum connections to Web site from anonymous accounts

Enter the maximum number of Web site connections from anonymous accounts that can be open during the monitoring interval. The default is 64.

Threshold -- Maximum connections to Web site from non-anonymous accounts

Enter the maximum number of Web site connections from non-anonymous (user) accounts that can be open during the monitoring interval. The default is 64.

Threshold -- Maximum total connections to Web site from anonymous accounts

Enter the maximum total number of connections to all monitored Web sites from anonymous accounts that can be open during the monitoring interval. The default is 64.

Threshold -- Maximum total connections to Web site from non-anonymous accounts

Enter the maximum total number of connections to all monitored Web sites from non-anonymous (user) accounts that can be open during the monitoring interval. The default is 64.

Event severity when current connections exceed the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a threshold is exceeded. The default is 12.


DBSpaceUtilUse this Knowledge Script to monitor the percentage of space used by the SharePoint content database. Space usage is measured as a percentage of the total database space available to the SharePoint site.

You need to meet the following prerequisites before running the DBSpaceUtil Knowledge Script:

● At least one SharePoint portal site should be available

● SharePoint content database should be defined

● You must be logged in with power user and/or administrator privileges (using Windows authentication)

You can specify a threshold for the maximum percentage of space used by the SharePoint content database. If the space used exceeds this threshold, an event is raised.

Resource Objects

SharePoint Server: Database and Database icon.

Default Schedule





Raise event if database space utilized exceeds threshold?

Set to Yes to raise an event if the database space used exceeds the threshold you have specified. By default, events are enabled.

Collect data for used database space?

Set to Yes to collect data points to measure the space utilized by the SharePoint content database.By default, data collection is not enabled.


Threshold--Maximum percentage of utilized database space

Enter the maximum percentage of space the SharePoint content database can use. An event is raised if the space used by the content database exceeds this percentage. The default is 75 percent.

Event severity when the percentage of utilized database space exceeds the threshold

Set the event severity level from 1 to 40, to indicate the importance of an event in which a threshold is exceeded. The default is 5.



HealthCheckUse this Knowledge Script to monitor the status of SharePoint services and Web sites. This Knowledge Script typically checks the performance and availability of all SharePoint services and Web sites in your portal. It can automatically restart any service or Web site that is down. It also monitors the queue length for blocked I/O requests.

Note SharePoint does not use the FTP publishing service. However, if the IIS Admin service is down, all associated services—FTP, HTTP and WWW—services also become unavailable. In this case, the HealthCheck Knowledge Script automatically restarts all services except FTP.

Resource Objects

SharePoint Server: Services and Virtual Server.

Default Schedule

The default interval is Every 5 minutes.




Auto-start service or Web site?

Set to Yes to automatically restart SharePoint services or Web sites that are down. By default, SharePoint services and Web sites are automatically restarted.

Event severity when Auto-start fails

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the service or Web site is down and AppManager cannot restart it. The default severity level is 5.


Event severity when Auto-start succeeds

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the service or Web site is down and AppManager can successfully restart it. The default severity level is 25.

Event severity when Site or service is down and auto-start is not enabled:

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the service or Web site is down and auto-start is not enabled. The default severity level is 18.

Threshold -- Maximum blocked I/O requests

Enter the maximum queue length for blocked I/O requests. The default is 0 requests.

Event severity when blocked I/O requests exceed the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of blocked I/O requests exceeds the threshold. Default severity level is 5.

Collect data for site or service status and blocked I/O requests?

Set to Yes to collect data for SharePoint services and Web sites. When you select Yes, the following data is collected: • the number of blocked I/O requests held in queue • the up/down status of SharePoint services and Web

sitesBy default, data is not collected.



IsolatedAppsUse this Knowledge Script to monitor isolated applications in your SharePoint environment. An isolated application runs out-of-process, directly from the Web Server. Typically, an isolated application shares its resources with other components in that application.

It is important to monitor isolated applications because the performance of SharePoint may be affected if several isolated applications run at the same time. You can monitor the number of isolated applications by specifying a threshold for it. If the number of isolated applications exceed the threshold, an event is raised.

Resource Objects


Default Schedule

The default interval for this script is Every 24 hours.




Raise event if number of isolated applications exceeds threshold?

Set to Yes to raise an event if the number of isolated applications exceeds the threshold limit you have set.By default, events are enabled.

Collect data for number of isolated applications?

Set to Yes to collect data for isolated applications.By default, collecting data for isolated applications is disabled.


Threshold -- Maximum isolated applications

Enter the maximum number of isolated applications that are allowed. If the number of isolated applications exceeds this limit, an event is raised. The default threshold is 10.

Event severity when the number of isolated applications exceeds the threshold

Set the severity level, from 1 to 40, to indicate the importance of an event when the threshold is exceeded.The default severity is 8.



ServerUptimeUse this Knowledge Script to monitor the number of hours the SharePoint Server has been operational since the last reboot. If you reboot the SharePoint Server at any time during the monitoring interval, an event is raised.

This Knowledge Script is useful because it helps you obtain real-time data about the availability of your SharePoint Server.

Resource Object

SharePoint Server.

Default Schedule





Raise an event if the system is rebooted during the monitoring interval.

Set to Yes to raise an event if the SharePoint Server is rebooted during the monitoring interval.By default, events are enabled.

Collect data for SharePoint Server reboot?

Set to Yes to collect data about SharePoint Server reboot.By default, collecting data for SharePoint server reboot is disabled.

Event severity level when system is rebooted

Set the severity level, from 1 to 40, to indicate the importance of the event if the system is rebooted during the monitoring interval.The default severity is 5.


ServiceUptimeUse this Knowledge Script to monitor the uptime of Web sites in your Microsoft Office SharePoint Server. Uptime is defined as the minimum time (threshold) that Web sites in your Microsoft Office SharePoint Server should run. If Web sites fail to meet this threshold, an event is raised.

Resource Objects


Default Schedule

The default interval for this script is Every 1 hour.




Raise event if uptime falls below threshold?

Set to Yes to raise an event if the duration for which a Web site has been running fails to meet the threshold you have specified.By default, events are enabled.

Collect data for Web site or service uptime?

Set to Yes to collect data about Web site or service uptime.By default, collecting Web site or service uptime data is disabled.

Threshold -- Minimum uptime

Enter the minimum uptime duration (in seconds) for which a Web site must be running. The default threshold is 10000 seconds.

Event severity when uptime falls below threshold

Set the severity level, from 1 to 40, to indicate the importance of the event if the Web site or service uptime falls below the threshold you have set.The default severity is 5.


SiteInfoUse this Knowledge Script to view and monitor date and space utilization information about each site on the SharePoint Server.

Space utilization information includes the number of sites newly added, existing sites modified, and sites that have been deleted. You can obtain detailed information about SharePoint site types such as documents, document libraries, and lists in report format.

The parameters of this Knowledge Script are distinctly grouped based on the functionality of each parameter-group.

The SiteInfo Knowledge Script helps an administrator quickly locate the sites that are using the maximum amount of space. An event is raised if the date or space utilization exceeds the threshold you have specified. You can (optionally) customize the format in which information is displayed in the report.

Resource Objects


Default Schedule






Site Information

Date information Set to Yes to allow the Knowledge Script to collect date information about sites. If enabled, information about when (date) sites were created, and last modified, is displayed.By default, date information is not collected.

Space utilization information

Set to Yes to allow the Knowledge Script to collect information about space utilized by each site on the SharePoint Server. If enabled, information about how much space each site utilizes, is displayed.By default, space utilization information is not collected.

Event Notification

Raise event for date information?

Set to Yes to allow the Knowledge Script to raise an event when date information is collected for sites on the SharePoint server.By default, events are enabled.

Event severity when site date information is collected successfully

Set the event severity level, from 1 to 40, to indicate the importance of an event in which site date information is successfully collected. The default severity level is 25.

Raise event for space utilization?

Set to Yes to allow the Knowledge Script to raise an event when space utilization information is collected for sites on the SharePoint server.By default, events are enabled.

Event severity when space utilization data is collected successfully

Set the event severity level, from 1 to 40, to indicate the importance of an event in which space utilization information about sites is successfully collected. The default severity level is 25.

Data Collection


Collect site date information?

Set to Yes to allow the Knowledge Script to collect date information about all sites in the SharePoint Server. If enabled, information about when (date) sites were created, and last modified, is displayed.By default, date information is not collected.

Collect site space utilization data?

Set to Yes to allow the Knowledge Script to collect information about space utilized by each site on the SharePoint Server. If enabled, information about how much space each site utilizes, is displayed.By default, space utilization information is not collected.

Monitoring

Enter date in the format mm/dd/yyyy

Enter the format for displaying dates in the report as follows: mm/dd/yyyy. The default is blank. For example: 05/30/2006. In case you alter the date format, the report displays an error.

Select site type: Select the type of SharePoint site that you want to view in the report. This Knowledge Script identifies site types using codes. Select:0-All: to view all site types in the report1-Lists: to view only the “lists” site type in the report2-Document Library: to view only the “document library” site type in the report3-Document: to view only the “documents” site type in the report.If you do not enter a specific site type, all site types are displayed in the report by default.

Threshold--MaximumKB of space utilized by each site

Enter the threshold (in KB) for space utilization by SharePoint sites. If a SharePoint site exceeds this threshold, an event is raised.

Display report in ascending order?

Set to Yes to view the report items in the ascending order of the items’ last modified date. By default, the report items are displayed in descending order.



SiteUsageUse this Knowledge Script to view usage information about each Web site on the Microsoft Office SharePoint Server. This Knowledge Script collects usage information based on the following parameters:

● URL

● User

● Operating System

● Browser

● Referring URL

Site usage information is displayed in report format. You can (optionally) customize the format in which information is displayed in the report.

Resource Objects


Default Schedule

The default interval for this script is Every 1 hour.




Raise event when report of site usage is created?

Set to Yes to raise an event when report of site usage information is generated.By default, events are enabled.

Collect site usage data on the SharePoint server?

Set to Yes to collect usage data for Web sites on your Microsoft Office SharePoint Server.By default, Web site usage data is not collected.


Event severity when site data collection is successful

Set the event severity level, from 1 to 40, to indicate the importance of an event in which Web site usage data is successfully collected. The default severity level is 25.

Select report type: Select the report type that you want to view. The report type dictates how data is filtered (included or excluded).This Knowledge Script identifies report types using codes. Select the code to view the report based on that code. 0—URL: URLs of pages that are visited, or of pages for lists that are updated. 1—User: Names of users who visited the site.2—OS: The operating system used on the client computer. All Web site usage data refers specifically to visits from referring URLs external to the site.3—Browser: The type of Web browser used to visit the SharePoint site. All usage data refers specifically to visits from referring URLs external to the site.4—RefURL: External URLs through which users navigated to the SharePoint site.By default, 0—URL is selected.

Select report format (past 31 days):

Select the format in which you want to view the report:0—Day-wise: Data is displayed individually for each day for the past 31 days.1—Summary: Data for the past 31 days is displayed as a summary.



WebPagePerfUse this Knowledge Script to identify and monitor the performance of a Web application’s Web pages in the SharePoint portal. This Knowledge Script retrieves performance information by scanning the SharePoint log entries. The Knowledge Script uses the current date’s log file to retrieve the performance information. Performance is measured in terms of the bandwidth you specify. Bandwidth is the number of bytes transferred to and from sites in your SharePoint portal. If any log entry exceeds the bandwidth

specified, an event is raised.

Resource Objects


Default Schedule





Raise event if log entries exceed the bandwidth filter?

Set to Yes to raise an event when log entries exceed the bandwidth filter you have specified.By default, events are enabled.

Collect data for matching log entries?

Set to Yes to collect data for charts and reports. By default, data is not collected.


Filter: Bandwidth greater than

Enter the bandwidth filter in number of Kilobytes (transferred). If any log entry exceeds this bandwidth filter, an event is raised.The default bandwidth filter is 1 KB. The job supports a maximum bandwidth of 200 KB.

Event severity when bandwidth exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the bandwidth exceeds the threshold. The default severity level is 8.



WebPartInfoUse this Knowledge Script to monitor the status and availability of web parts used by the SharePoint server. A web part is a modular unit of information located within your SharePoint portal. A typical example of a web part is a digital dashboard on your company’s SharePoint portal, which integrates numerous information sources, enterprise applications, and other resources on a single page. It is therefore crucial to continually monitor web parts of your SharePoint portal.

It is essential to extend at least one virtual server before you can use the WebPartInfo Knowledge Script. For more information about extending virtual servers, see “Extending a Virtual Server” on page 19. Extending a Virtual Server in the Management Guide.

The WebPartInfo Knowledge Script generates an event when it collects information about web parts and displays it in report format.

Resource Objects


Default Schedule






Raise event when report of Web Parts used by the SharePoint server is displayed?

Set to Yes to raise an event when details of web parts used by the SharePoint server are collected.By default, events are enabled.

Collect data for web parts on the SharePoint server?

Set to Yes to collect data points for all web parts on your SharePoint portal.By default, data for web parts is not collected.

Event severity when web parts data collection is successful

Set the event severity level, from 1 to 40, to indicate the importance of an event in which web part details are successfully collected.The default severity level is 25.


Report_ServerUptimeUse this Report script to generate a report about the number of hours the SharePoint Server has been operational since the last reboot. This report allows you to make a statistical analysis of the data point values.

This report uses data collected by the ServerUptime Knowledge Script.

Resource Object

Report Agent > Microsoft Office SharePoint Server > AppManager Repositories > SharePoint

Default Schedule

The default schedule is Run once.




Data source Use the following parameters to select the data for your report.

Select computer(s) Click the Browse [...] button to start the data wizard. Use the data wizard to select the computers for your report.

Select time range Click the Browse [...] button to open the time browser. Set a specific or sliding time range for data included in your report.

Select peak weekday(s) Click the Browse [...] button to select the days of the week to include in your report.


Select the style Select the style for the report:• By computer shows one value for each computer you

selected.• By legend shows one value for each different legend

(the legend is a truncated form of the data stream legend visible in the Operator Console).

• By computer and legend shows one value for each unique legend from each computer.

Data settings Use the following parameters to define the statistical calculation applied to data, and which of the data is displayed.

Statistics to show Select a statistical method by which to display data in the report:• Average: Average value of data points for the time

range of the report• Minimum: Minimum value of data points for the time

range of the report• Maximum: Maximum value of data points for the time

range of the report• Min/Avg/Max: Minimum, average, and maximum

values of data points for the time range of the report• Range: Range of values in the data stream (maximum -

minimum = range)• StandardDeviation: Measure of how widely values are

dispersed from the mean• Sum: Total value of data points for the time range of the

report• Close: Last value for the time range of the report• Change: Difference between the first and last values

for the time range of the report (close - open = change)• Count: Number of data points for the time range of the

report



Select sorting/display option

Select whether data is sorted, or the method of display:• No sort: Data is not sorted• Sort: Data is sorted by value (lowest to highest from

front to back; highest to lowest from left to right)• Top %: Chart only the top N % of selected data (sorted

by default)• Top N: Chart only the top N of selected data (sorted by

default)• Bottom %: Chart only the bottom N % of data (sorted

by default)• Bottom N: Chart only the bottom N of selected data

(sorted by default)

Percentage/count for top/bottom

Enter a number for either the percent or count defined in the previous parameter (for example, Top 10%, or Top 10).The default is 25.

Truncate top/bottom? If set to yes, then the data table shows only the top or bottom N or % (for example, only the top 10%).Otherwise, the table shows all data.The default is no.

Show totals on the table?

If set to yes, then additional calculations are made for each column of numbers in a table, and the following values are listed at the end of the table:• Report Average: Average of all values in a column• Report Minimum: Minimum value in a column• Report Maximum: Maximum value in a column• Report Total: Total of all values in a columnThe default is no.

Report settings Use the following parameters to define the graphical presentation of data, the folder where the report is generated, and properties that identify the report.

Include parameter help card?

Set to yes to include a table in the report that lists parameter settings for the report script. The default is yes.

Include table? Set to yes to include a table of data stream values in the report. The default is yes.

Include chart? Set to yes to include a chart of data stream values in the report. The default is yes.



Select chart style Click the Browse [...] button to open the Chart Settings dialog box. Define the graphic properties of the charts in your report.

Select output folder Click in the Value column, and click the Browse [...] button to set parameters for the output folder.

Add job ID to output folder name?

Set to yes to append the job ID to the name of the output folder.This is helpful to correlate a specific instance of a Report Script and the corresponding report.The default is no.

Select properties Click in the Value column, and click the Browse [...] button to open the Report Properties dialog box. Set the properties parameters as desired.

Add time stamp to title? Set to yes to append a timestamp to the title of the report, making each title unique. The timestamp is composed of the date and time the report was generated.Adding a timestamp lets you run consecutive iterations of the same report without overwriting previous output.The default is no.

Event notification Use the following parameters to raise events associated with generating the report, and to set severity levels for those events.

Event for report success?

Set to yes to raise an event when the report is successfully generated. The default is yes.

Severity level for report success

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 35.

Severity level for report with no data


Severity level for report failure.




Report_SiteInfoUse this Report script to generate a report of information about each site on the SharePoint Server sorted by date, and space utilized (in KB). This report allows you to make a statistical analysis of the data point values.

This report uses data collected by the SiteInfo Knowledge Script.

Resource Object


Default Schedule






Select computerwizard Click the Browse [...] button to start the data wizard. Use the data wizard to select the computers for your report.


selected.• By data stream shows one value for each different

legend on the report• By computer and data stream shows one value for

each unique legend from each computer.• By Knowledge Script shows values based on this

Knowledge Script.• All data streams on one page shows values of all

data streams on a single page.




Aggregation by Select an aggregation method by which to display data in the report:Minute: Average values based on minutes.Hour: Average values based on hours.Day: Average values based on days.The default is Hour.

Aggregation interval Select an aggregation interval by which to display data in the report. You can select an aggregation interval in the range of 1 through 90. Data in the report is displayed based both on the aggregation method and interval. For example, 90 hours, 24 minutes, 7 days, and so on.

Statistics to show per period

Select a statistical method by which to display data in the report:• Average: Average value of data points for the time



range of the report• Count: Number of data points for the time range of the

report• Sum: Total value of data points for the time range of the

report• 3Sigma: The average + (3 * standard deviation) and

average - (3 * standard deviation).• Std: Measure of how widely values are dispersed from

the mean.• Box:Lower fence, 25% point, median, 75% point, and

upper fence for the aggregation interval.• Open: The first value for the aggregation interval.• Close: Last value for the time range of the report.



























Report_SiteUsageUse this Report script to generate a report that contains usage information about each Web site on the Microsoft Office SharePoint Server. This report allows you to make a statistical analysis of the data point values.

This report uses data collected by the SiteUsage Knowledge Script.

Resource Object


Default Schedule






















































Report_WebPartInfoUse this Report script to generate a report about the status and availability of web parts used by the Microsoft Office SharePoint Server. This report allows you to make a statistical analysis of the data point values.

This report uses data collected by the WebPartInfo Knowledge Script.

Resource Object


Default Schedule






















































Discovery_SharePointUse this Knowledge Script to discover configuration and resource information for SharePoint Portal Servers. Discovery_SharePoint also tracks, displays, and provides various alerts about SharePoint services.

Ensure that you meet the following prerequisites in order to successfully discover SharePoint configuration and resource information:

● You have administrator or power user privileges when you login.

● You have extended at least one virtual server in your Microsoft Office SharePoint Server.

● You have created at least one portal site in your Microsoft Office SharePoint Server.

● You have enabled logging so that log files are created.

Resource Objects

Microsoft Office SharePoint Servers.

Default Schedule

By default, this script is only run once for each computer.



Set the following parameters as needed.


Event for successful discovery?

Set to Yes to raise an event when this Knowledge Script succeeds in discovering SharePoint resources.By default, events are not enabled.

Event severity when discovery succeeds

Set the event severity level between 1 to 40, to reflect the importance when discovery is successful. The default event severity level is 21.

Event severity when discovery fails

Set the event severity level between 1 to 40, to reflect the importance when discovery fails. The default event severity level is 5.


Date post:	03-Feb-2022
Category:	Documents
Upload:	others
View:	19 times
Download:	0 times

AppManager for Microsoft Office SharePoint Server

Documents