Spotlight on Messaging Data Recorder User Guide 75

8/2/2019 Spotlight on Messaging Data Recorder User Guide 75

http://slidepdf.com/reader/full/spotlight-on-messaging-data-recorder-user-guide-75 1/22

7.57.57.57.5Spotlight on MessagingSpotlight on MessagingSpotlight on MessagingSpotlight on MessagingDATA RECORDER

User Guide



© 2010 Quest Software, Inc.ALL RIGHTS RESERVED.

This guide contains proprietary information protected by copyright. The software described

in this guide is furnished under a software license or nondisclosure agreement. This

software may be used or copied only in accordance with the terms of the applicable

agreement. No part of this guide may be reproduced or transmitted in any form or by anymeans, electronic or mechanical, including photocopying and recording for any purpose

other than the purchaser's personal use without the written permission of Quest Software,

Inc.

The information in this document is provided in connection with Quest products. No

license, express or implied, by estoppel or otherwise, to any intellectual property right is

granted by this document or in connection with the sale of Quest products. EXCEPT AS SET

FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT

FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANYEXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING,

BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A

PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE

FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL

DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS,

BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR

INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE

POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with

respect to the accuracy or completeness of the contents of this document and reserves theright to make changes to specifications and product descriptions at any time without

notice. Quest does not make any commitment to update the information contained in this

document.

If you have any questions regarding your potential use of this material, contact:

Quest Software World Headquarters

LEGAL Dept

5 Polaris Way

Aliso Viejo, CA 92656 USA

www.quest.com

email: [email protected]

Refer to our Web site for regional and international office information.

TRADEMARKS

Quest, Quest Software, the Quest Software logo, Spotlight, vSpotlight are trademarks and

registered trademarks of Quest Software, Inc in the United States of America and other

countries. Other trademarks and registered trademarks used in this guide are property of their respective owners.

Quest Spotlight on Messaging Data Recorder User Guide

Updated - December 2010

Software Version - 7.5



iii

CONTENTS

CHAPTER 1INTRODUCING SPOTLIGHT ON MESSAGING DATA R ECORDER . . . . . . 5

ABOUT THIS GUIDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

ABOUT THIS PRODUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

DATA RECORDER MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

USING THE DATA RECORDER MODE . . . . . . . . . . . . . . . . . 8

HELP DESK MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

USING THE HELP DESK MODE . . . . . . . . . . . . . . . . . . . .11

CHAPTER 2FREQUENTLY ASKED QUESTIONS . . . . . . . . . . . . . . . . . . . . . . . 15

OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

DATA RECORDER MODE . . . . . . . . . . . . . . . . . . . . . . . . . . .16HELP DESK MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

THIRD PARTY CONTRIBUTIONS . . . . . . . . . . . . . . . . . . . . . . . . 19

ABOUT QUEST SOFTWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

CONTACTING QUEST SOFTWARE . . . . . . . . . . . . . . . . . . . . . .21

CONTACTING QUEST SUPPORT . . . . . . . . . . . . . . . . . . . . . . .21



Quest Spotlight on Messaging Data Recorder

iv



Introducing Spotlight on

Messaging Data Recorder

• About This Guide

• About This Product

• Data Recorder Mode• Help Desk Mode

1




6

About This Guide

This document has been prepared to assist you in becoming familiar with theSpotlight® on Messaging Data Recorder and its functions. It is intended fornetwork administrators, consultants, analysts, and any other IT professionals

using the Spotlight on Messaging Diagnostic Console.

About This Product

The Quest Spotlight on Messaging Data Recorder enhances the Spotlight on

Messaging Diagnostic Console by capturing server performance data, making iteasier for you as an administrator to troubleshoot and resolve possible issues.

Quest technical support staff can use the Spotlight on Messaging Data Recorderto record and analyze server performance data on customer sites.

The Data Recorder functions in one of two modes - Data Recorder or Help Desk,

and has a log file feature, which creates log entries for the Spotlight onMessaging Diagnostic Console. You can choose the mode in which to use the

Data Recorder by selecting the Record, Play, Stop, and Resume options

available under the Data Recorder and Help Desk labels, as shown in the

following image:

Spotlight on Messaging Diagnostic Console Mode Indicator

The Spotlight on Messaging Diagnostic Console user interface indicates the modein which the Spotlight on Messaging Diagnostic Console is operating.



About This Product

7

The following example indicates that the Spotlight on Messaging DiagnosticConsole is operating in Record Mode.

Debug Logging Feature

The Debug Logging feature provides you with more information when

troubleshooting possible problems with your server. When Debug Logging is

initialized, issues that occur when the Spotlight on Messaging Diagnostic Console

is running are entered into the SOE_INFO log file. You can view the SOE_INFO

log file to analyze the issues.

Minimum System Requirements

The system requirements for the Spotlight on Messaging Data Recorder are

based on the requirements for the Spotlight on Messaging Diagnostic Console.

Starting the Spotlight on Messaging Data Recorder

You can start the Data Recorder from the following location:

To start the Spotlight on Messaging Data Recorder

1. Select <Install Drive> | Program Files | Quest Software |

Spotlight | Plug-ins | DatasourceSOM.

2. Double-click DataRecorderConfig.exe.

3. Select a Data Recorder or Help Desk option.

4. Click OK.

5. Start the Spotlight on Messaging Diagnostic Console and connect to

any server.

You should disable the Debug Logging option during the Data Recorder Play

and Help Desk Play mode.

For details about system requirements and other information about Quest

Spotlight on Messaging Data Recorder, refer to the Quest Spotlight on

Messaging User Guide.




8

Data Recorder Mode

The Spotlight on Messaging Data Recorder allows you to take a snapshot of theperformance of a server and save it as a reference that can be reviewed at a later

time. The Spotlight on Messaging Data Recorder saves the data collected by theSpotlight on Messaging Diagnostic Console proxies to .xml files.

Using the Data Recorder Mode

Record

While recording, the Spotlight on Messaging Data Recorder generates .xml data

files for each server to which the Spotlight on Messaging Diagnostic Console is

connected. The .xml files are stored in the location you select. The directory and

the .xml files are named according to the server name. New .xml files are

created for each polling interval. After recording, you can view the .xml files.

To record data from a live server

1. Start the Data Recorder.

2. Select Record under the Data Recorder label.

3. Enter the location for the stored data files.

– OR –

Click to browse to the storage location.

4. Click OK.

5. Start the Spotlight on Messaging Diagnostic Console and connect toany server.

If you use the Spotlight on Messaging Data Recorder in Data Recorder mode,

you must have administrative access to a live server.

After recording for five minutes, the Spotlight on Messaging Data

Recorder produces data files that use approximately 1.5 MB of hard disk

space. Make sure you have adequate disk space before you record.



Data Recorder Mode

9

Play

When the Spotlight on Messaging Data Recorder plays back a recording, the

Spotlight on Messaging Diagnostic Console user interface reflects the recorded

data in the .xml files for each server to which you are connected.

To play data from a live server

1. Exit the Spotlight on Messaging Diagnostic Console.

2. Start the Data Recorder.3. Click Play under the Data Recorder label.


– OR –


5. Click OK.


the corresponding server for which the data is stored.

Stop

As previously mentioned, it is important to stop recording because of the amount

of hard disk space consumed by the data files. When the play option is stopped,the Spotlight on Messaging Diagnostic Console does not display the recorded

data and will establish a live connection with the server the next time you launch

the Spotlight on Messaging Diagnostic Console.

When you select Record, a new directory is created for each server. Thename of the directory reflects the connection name address. If the directory

already exists from a previous recording, the old data files are replaced with

new recordings. Select Resume if you do not want the old files to be

replaced.

You should disable the Debug Logging option during the Data Recorder

Play mode.

If no data files exist for a server connection, most Spotlight on Messaging

Diagnostic Console user interface components appear gray in color and some

will display "-2".




10

To stop recording from a live server


2. Start the Data Recorder.3. Select Stop under the Data Recorder label.

4. Click OK.

Resume

When you select Resume, data is appended to the existing data file.

To resume recording from a live server



3. Select Resume under the Data Recorder label.


– OR –


5. Click OK.


the corresponding server for which the data was recorded.

Help Desk Mode

Help Desk mode is a different form of Spotlight on Messaging Data Recorder

usage. When in Help Desk mode, the Spotlight on Messaging Data Recorder

provides a source of the information necessary to populate and activate the

Quest Spotlight on Messaging Data Recorder user interface without

administrator privileges to a specific live Exchange server. The data recorded by

one Spotlight on Messaging Diagnostic Console Help Desk server can be played

in real-time by one or more remote Spotlight on Messaging Help Desk clients.

Help Desk mode allows multiple Spotlight on Messaging Help Desk clients todisplay data from a specific server while collecting the data from that server only

once. It allows Spotlight on Messaging internet users to pass through firewall

protection using http protocol to collect data. Anyone with the right to access thenetwork share can view the server data.



Help Desk Mode

11

Using the Help Desk Mode

The following diagram demonstrates the Help Desk mode configuration:

Record

When you record in Help Desk mode, you make a connection to a live server.

The computer with the live connection is the source. The data on the source is

recorded to a shared directory. Non-administrators can read the data files from

a client with access to the shared directory. Data files are written for each server

to which you are connected, and are appended at each polling interval.

To record in Help Desk mode

1. Start the Data Recorder on the source computer.

2. Select Record under the Help Desk label.


– OR –


4. Click OK.


a server.

The data files must be stored to a shared or virtual directory.

Spotlight on Messaging client

set to Help Desk Play mode

S:\ Drive mapped to \\SoMMain\SoM

Data File path

Spotlight on Messaging client

set to Help Desk Play modeS:\ Drive mapped to \\SoMMain\SoM

Data File path

\\SoMMain

Spotlight on Messaging set to

Help Desk Record mode

Source:

Help Desk Record

Console

Server

Server

Server




12

Play

When you use the Help Desk mode, the stored data can be played on a remote

client with access to the shared or virtual directory.

To play data on the client computer using a shared directory

1. Obtain the server name and the name of the shared directorycontaining the Spotlight on Messaging Diagnostic Console data files

from the administrator.

2. Map a drive to the location of the shared directory.



– OR –

Click to browse to the location of the stored data files on themapped drive.

5. Select Play under the Help Desk label.

6. Click OK.

7. Start the Spotlight on Messaging Diagnostic Console and connect tothe corresponding server for which the data has been recorded.

The Spotlight on Messaging Diagnostic Console displays recorded data

from a live server stored on the source computer.

Stop

When Help Desk play mode is stopped on Spotlight on Messaging Help Desk

clients, the Spotlight on Messaging Diagnostic Console will not display therecorded data, but will establish a live connection with the server the next time

you launch the Spotlight on Messaging Diagnostic Console.

To stop recording or playing in Help Desk mode



3. Select Stop under the Help Desk label.4. Click OK.

You should disable the Debug Logging option during the Help Desk Play

mode.



Help Desk Mode

13

Using the Debug Logging Feature

When Debug Logging is initialized, issues that occur when the Spotlight on

Messaging Diagnostic Console is running are entered into the SOE_INFO log file.You can view the SOE_INFO log file to analyze the issues.

To start the Debug Logging feature



3. Select the Enable Debug Logging check box.

4. Click OK.

5. Start the Spotlight on Messaging Diagnostic Console and connect toa server.

To stop the Debug Logging feature.



3. Clear the Enable Debug Logging check box.

4. Click OK.

The SOE_INFO log file is stored in the <Install Drive>:\\Program Files\Quest

Software\Spotlight on Messaging\Diagnostic Console\Binaries directory.




14



Frequently Asked

Questions• Overview

• Data Recorder Mode

• Help Desk Mode

2




16

Overview

This chapter provides answers to some of the most commonly asked questionsabout the Spotlight on Messaging Data Recorder. Information and answers to

questions are presented for both Data Recorder Mode and Help Desk Mode.

Data Recorder Mode

The following section contains some common questions pertaining to the DataRecorder when the user is in the Data Recorder Mode.

Where are the Data Recorder files stored?

The Data Recorder .xml files are stored in the location specified by the user. For

more information about storage location, see “To record data from a live server” on page 8.

How can I tell if the Quest Spotlight on MessagingDiagnostic Console is playing recorded data?

There is a Data Recorder indicator on the Spotlight on Messaging Diagnostic

Console user interface. For more information, see “Spotlight on MessagingDiagnostic Console Mode Indicator” on page 6.

How can I view and edit the data files?

You can use Internet Explorer to read the data files. To edit the data files, youcan use Microsoft XML Notepad, which can be downloaded from the MicrosoftWeb site.

Help Desk Mode

The following section contains some common questions pertaining to the DataRecorder when the user is in the Help Desk Mode.

What is Help Desk mode?

The data recorded by one Help Desk server which can be replayed by one or

more remote Spotlight on Messaging Help Desk clients in real time.



Help Desk Mode

17

Why is Help Desk mode useful?

Help Desk mode provides the following functionality:

• Allows multiple Spotlight on Messaging Diagnostic Console clients theability to monitor the same server while collecting data only once.

• Allows users the ability to view data from a server without obtainingadministrative privileges.

• Allows Spotlight on Messaging Diagnostic Console Internet users theability to pass through firewall protection using proper HTTP protocol.




18



Third Party Contributions

Spotlight on Messaging 7.5 contains some third party components (listedbelow). Copies of their licenses may be found on our website athttp://www.quest.com/legal/third-party-licenses.aspx.

COMPONENT LICENSE OR ACKNOWLEDGEMENT

Blowfish v2 MIT 1.0

Indy Sockets 9.0.1 Mozilla Public License (MPL) 1.1

SNMP SharpNet 0.7.9 Copyright © 2007 Free Software Foundation, Inc.

GNU Lesser General Public License v3

ZipMaster 1.78 GNU Lesser General Public License v2.1

Zlib zlib 1.2.3

3

Q est Spotlight on Messaging



Quest Spotlight on Messaging

20



21

About Quest Software

Quest Software simplifies and reduces the cost of managing IT for more than

100,000 customers worldwide. Our innovative solutions make solving thetoughest IT management problems easier, enabling customers to save time and

money across physical, virtual and cloud environments. For more informationabout Quest go to www.quest.com.

Contacting Quest Software

Refer to our Web site for regional and international office information.

Contacting Quest SupportQuest Support is available to customers who have a trial version of a Questproduct or who have purchased a Quest product and have a valid maintenance

contract. Quest Support provides unlimited 24x7 access to SupportLink, ourself-service portal. Visit SupportLink at http://support.quest.com.

From SupportLink, you can do the following:

• Retrieve thousands of solutions from our online Knowledgebase

• Download the latest releases and service packs

• Create, update and review Support cases

View the Global Support Guide for a detailed explanation of support programs,

online services, contact information, policies and procedures. The guide isavailable at: http://support.quest.com.

Email [email protected]

Mail Quest Software, Inc.

World Headquarters5 Polaris Way

Aliso Viejo, CA 92656USA

Web site www.quest.com





22

Date post:	06-Apr-2018
Category:	Documents
Upload:	frederic-marinkovic
View:	215 times
Download:	0 times

Spotlight on Messaging Data Recorder User Guide 75

Documents