Here's the updated case.
eric
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:
Aug 3, 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
/usr/benchmarks is a new directory for delivering benchmarks
into (Open)Solaris. Each benchmark will have its own directory
within /usr/benchmarks. For example, FileBench related files
will be located in the directory /usr/benchmarks/filebench and
libMicro related files will be located in the directory
/usr/benchmarks/libmicro.
This project delivers the following executable perl script:
/usr/benchmarks/filebench/bin/filebench
Additionial private implementation files will be delivered into
/usr/benchmarks/filebench and are listed below:
/usr/benchmarks/filebench/bin/go_filebench
/usr/benchmarks/filebench/bin/{i386,amd64,sparcv9}/go_filebench
/usr/benchmarks/filebench/config/fileio.prof
/usr/benchmarks/filebench/config/filemacro.prof
/usr/benchmarks/filebench/config/filemicro.prof
/usr/benchmarks/filebench/config/generic.func
/usr/benchmarks/filebench/config/seqread.prof
/usr/benchmarks/filebench/scripts/filebench_compare
/usr/benchmarks/filebench/scripts/fs_flush
/usr/benchmarks/filebench/workloads/bringover.f
/usr/benchmarks/filebench/workloads/copyfiles.f
/usr/benchmarks/filebench/workloads/createfiles.f
/usr/benchmarks/filebench/workloads/deletefiles.f
/usr/benchmarks/filebench/workloads/filemicro_create.f
/usr/benchmarks/filebench/workloads/filemicro_createfiles.f
/usr/benchmarks/filebench/workloads/filemicro_createrand.f
/usr/benchmarks/filebench/workloads/filemicro_delete.f
/usr/benchmarks/filebench/workloads/filemicro_rread.f
/usr/benchmarks/filebench/workloads/filemicro_rwrite.f
/usr/benchmarks/filebench/workloads/filemicro_rwritedsync.f
/usr/benchmarks/filebench/workloads/filemicro_rwritefsync.f
/usr/benchmarks/filebench/workloads/filemicro_seqread.f
/usr/benchmarks/filebench/workloads/filemicro_seqwrite.f
/usr/benchmarks/filebench/workloads/filemicro_seqwriterand.f
/usr/benchmarks/filebench/workloads/filemicro_writefsync.f
/usr/benchmarks/filebench/workloads/fileserver.f
/usr/benchmarks/filebench/workloads/mongo.f
/usr/benchmarks/filebench/workloads/multistreamread.f
/usr/benchmarks/filebench/workloads/multistreamreaddirect.f
/usr/benchmarks/filebench/workloads/multistreamwrite.f
/usr/benchmarks/filebench/workloads/multistreamwritedirect.f
/usr/benchmarks/filebench/workloads/oltp.f
/usr/benchmarks/filebench/workloads/randomread.f
/usr/benchmarks/filebench/workloads/randomrw.f
/usr/benchmarks/filebench/workloads/randomwrite.f
/usr/benchmarks/filebench/workloads/singlestreamread.f
/usr/benchmarks/filebench/workloads/singlestreamreaddirect.f
/usr/benchmarks/filebench/workloads/singlestreamwrite.f
/usr/benchmarks/filebench/workloads/singlestreamwritedirect.f
/usr/benchmarks/filebench/workloads/tpcso.f
/usr/benchmarks/filebench/workloads/varmail.f
/usr/benchmarks/filebench/workloads/webproxy.f
/usr/benchmarks/filebench/workloads/webserver.f
All relevant files will be delivered in a new single package:
SUNWfilebench.
3. Interfaces
/usr/benchmarks/filebench/bin/filebench
Location: Uncommited
Invocation: Volatile
Human-readable output: Not an Interface
/usr/share/man/man1bench/filebench.1bench
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. Manpages
6.1 filebench manpage
User Commands filebench
(1BENCH)
NAME
/usr/benchmarks/filebench/bin/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
configuration file named 'sqread.prof'.
# filebench sqread
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
(1BENCH)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWfilebench |
|_____________________________|_____________________________|
| Interface Stability | Uncommitted |
|_____________________________|_____________________________|
SEE ALSO
attributes(5)
6.2 filesystem(5) manpage update
/usr/aset
Directory for Automated Security Enhancement Tools
(ASET) programs and files.
+ /usr/benchmarks
+ Directory for benchmarks.
/usr/bin
Platform-dependent, user-invoked executables. These are
commands users expect to be run as part of their normal
$PATH. For executables that are different on a 64-bit
system than on a 32-bit system, a wrapper that selects
the appropriate executable is placed here. See
isaexec(3C). An approved installation location for bun-
dled Solaris software. The analogous location for add-on
system software or for applications is
/opt/packagename/bin.
