Chapter 24   searchplay


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.

This chapter contains the following section:

• Syntax

• Options

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 searchplay tool has the following command-line syntax:

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

Where:

• options are the command line options described in Table 24-1.

• 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 the following table.

Table 24-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.