Previous      Contents      Index      Next
Sun ONE Directory Server Resource Kit 5.2 Tools Reference

Chapter 27
The Search Operations Audit Tool

The searchplay tool will analyze a log file, detect the log entries for search operations, and replay the search operations on the specified directory server. This chapter provides instructions on how to use the searchplay tool. It contains the following sections:

Overview
Command Usage

---

Overview

The searchplay tool will analyze a log file, detect the log entries for search operations, and replay the search operations on the specified directory server. This functionality is useful for testing the integrity and consistency of directory contents. It may also be used to trace problems that occurred as a result of a sequence of events.

---

Command Usage

The searchplay tool is a simple tool that reads the access log file in the current directory and queries the directory server with all of the same search operations in the same order.

Syntax

The syntax of searchplay on the command-line takes the following form:

searchplay [options] [-f filename] ...

Where:

options are the command-line options described in Options.
filename is an optional parameter to specify a log file other than the current access log. Use this option to specify past log files that have been rotated. The -f filename option may be repeated to process more than one log file.

Options

The searchplay options and parameters are described in Table 27-1.

Table 27-1  Command-Line Options for the searchplay Tool 

Option	Parameter	Purpose
-d		Process the log file in “debug” mode: display the searches found in the log file but do not perform the operations again on the server.
-s		Suppress the display of statistics and information about the searches found in the log file. By default, the tool will display which searches it found and will perform again.
-w	seconds	Specify a time limit, in seconds, for the server to perform each replayed search operation.
-f	filename	Specify the filename of an alternate log file to replay. You may specify this option more than once to replay several log files. When this option is omitted, searchplay will replay the access log.
-h	host	Specify the hostname of an alternate directory server to replay the search requests. Use in conjunction with the -p port option to compare directory contents and search performance on different directories.
-p	port	Use in conjunction with -h host to specify the port of an alternate directory server to replay the search requests.

Previous      Contents      Index      Next

---

Copyright 2004 Sun Microsystems, Inc. All rights reserved.