Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
This information is Copyright 2007 Sun Microsystems
1. Introduction
1.1. Project/Component Working Name:
Filebench
1.2. Name of Document Author/Supplier:
Author: Eric Kustarz
1.3 Date of This Document:
02 August, 2007
4. Technical Description
1. Introduction
1.1. Project/Component Working Name:
Add FileBench into Solaris
1.2. Name of Document Author/Supplier:
Author: Eric Kustarz
1.3 Date of This Document:
July 30, 2007
4. Technical Description
1. Summary
This project integrates filebench into Solaris.
This project requests patch release binding.
2. Background
FileBench is a framework of file system workloads for measuring
and comparing file system performance. It runs under a variety
of platforms, and is licensed under CDDL.
More information is available at:
http://www.opensolaris.org/os/community/performance/filebench/
http://www.solarisinternals.com/wiki/index.php/FileBench
3. Details
This project delivers the following executable perl script:
/usr/benchmarks/filebench/filebench
Additionial private implementation files will be delivered into
/usr/lib/filebench and are listed below:
/usr/lib/filebench/bin/go_filebench
/usr/lib/filebench/bin/{i386,amd64,sparcv9}/go_filebench
/usr/lib/filebench/config/fileio.prof
/usr/lib/filebench/config/filemacro.prof
/usr/lib/filebench/config/filemicro.prof
/usr/lib/filebench/config/generic.func
/usr/lib/filebench/config/seqread.prof
/usr/lib/filebench/scripts/filebench_compare
/usr/lib/filebench/scripts/fs_flush
/usr/lib/filebench/workloads/bringover.f
/usr/lib/filebench/workloads/copyfiles.f
/usr/lib/filebench/workloads/createfiles.f
/usr/lib/filebench/workloads/deletefiles.f
/usr/lib/filebench/workloads/filemicro_create.f
/usr/lib/filebench/workloads/filemicro_createfiles.f
/usr/lib/filebench/workloads/filemicro_createrand.f
/usr/lib/filebench/workloads/filemicro_delete.f
/usr/lib/filebench/workloads/filemicro_rread.f
/usr/lib/filebench/workloads/filemicro_rwrite.f
/usr/lib/filebench/workloads/filemicro_rwritedsync.f
/usr/lib/filebench/workloads/filemicro_rwritefsync.f
/usr/lib/filebench/workloads/filemicro_seqread.f
/usr/lib/filebench/workloads/filemicro_seqwrite.f
/usr/lib/filebench/workloads/filemicro_seqwriterand.f
/usr/lib/filebench/workloads/filemicro_writefsync.f
/usr/lib/filebench/workloads/fileserver.f
/usr/lib/filebench/workloads/mongo.f
/usr/lib/filebench/workloads/multistreamread.f
/usr/lib/filebench/workloads/multistreamreaddirect.f
/usr/lib/filebench/workloads/multistreamwrite.f
/usr/lib/filebench/workloads/multistreamwritedirect.f
/usr/lib/filebench/workloads/oltp.f
/usr/lib/filebench/workloads/randomread.f
/usr/lib/filebench/workloads/randomrw.f
/usr/lib/filebench/workloads/randomwrite.f
/usr/lib/filebench/workloads/singlestreamread.f
/usr/lib/filebench/workloads/singlestreamreaddirect.f
/usr/lib/filebench/workloads/singlestreamwrite.f
/usr/lib/filebench/workloads/singlestreamwritedirect.f
/usr/lib/filebench/workloads/tpcso.f
/usr/lib/filebench/workloads/varmail.f
/usr/lib/filebench/workloads/webproxy.f
/usr/lib/filebench/workloads/webserver.f
All relevant files will be delivered in a new single package:
SUNWfilebench.
3. Interfaces
/usr/benchmarks/filebench/filebench
Location: Commited
Invocation: Uncommited
Human-readable output: Not an Interface
/usr/share/man/man1/filebench.1
Location Uncommited
4. Bug/RFE Numbers
6581098 FileBench should be included in Solaris
5. References
http://www.opensolaris.org/os/community/performance/filebench/
http://www.solarisinternals.com/wiki/index.php/FileBench
6. Manpage
User Commands filebench(1)
NAME
filebench - framework of workloads to measure and compare
filesystem performance
SYNOPSIS
filebench profile
filebench -c stats_dir...
DESCRIPTION
The filebench command runs workloads in order to measure and
compare filesystem performance.
'profile' is the name of the configuration file ending in '.prof'.
The configuration file specifies what workloads to run, what
parameters to run with, the directory path to operate on, and
the directory path to store the results.
Full documentation can be found at:
http://www.opensolaris.org/os/community/performance/filebench/
OPTIONS
-c stats_dir...
Generates a HTML file ('index.html') that is a comparison
of the specified directories.
EXAMPLES
Example 1 Running the multi-stream sequential read workload
The following command runs the workloads described in the
profile named 'seqread.prof'.
# filebench seqread
Example 2 Comparing multiple runs
The following command compares the results of two previous runs.
This assumes the results from the two previous runs were located
in the directories: /stats/wombat-zfs-noel-Jun_27_2007-15h_45m_33s
and /stats/wombat-ufs-noel-Jun_27_2007-15h_52m_11s. This command
will generate a HTML file named 'index.html' in your current working
directory.
# filebench -c /stats/wombat-zfs-noel-Jun_27_2007-15h_45m_33s \
/stats/wombat-ufs-noel-Jun_27_2007-15h_52m_11s
EXIT STATUS
The following exit values are returned:
0 The run was successfull.
1 An error was detected.
2 Invalid command line options were specified.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
System Administration Commands filebench(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWfilebench |
|_____________________________|_____________________________|
| Interface Stability | Uncommitted |
|_____________________________|_____________________________|
SEE ALSO
attributes(5)
6. Resources and Schedule
6.4. Steering Committee requested information
6.4.1. Consolidation C-team Name:
ON
6.5. ARC review type: FastTrack
6.6. ARC Exposure: open
