Oraclue

Oracle internals, debugging and undocumented features

ORION (Oracle I/O Calibration Tool) included in 11g R2

Apparently Oracle  included this tool into 11g release 2 database.Orion binary is located under  $ORACLE_HOME/bin .

Quick run with help command will give very detail explanation how to use this tool.Also

Kevin Closson’s Oracle blog got post about Orion:

http://kevinclosson.wordpress.com/2006/12/11/a-tip-about-the-orion-io-generator-tool/

-bash-3.2$ orion -help
ORION: ORacle IO Numbers — Version 11.2.0.1.0

ORION runs IO performance tests that model Oracle RDBMS IO workloads.
It measures the performance of small (2-32K) IOs and large (128K+) IOs
at various load levels.

Each Orion data point is a test for a specific mix of small and large
IO loads sustained for a duration.  An Orion test consists of multiple
data point tests.  These data point tests can be represented as a
two-dimensional matrix.  Each column in the matrix represents data
point tests with the same small IO load, but varying large IO loads.
Each row represents data point tests with the same large IO load, but
varying small IO loads.  An Orion test can be for a single point, a
single row, a single column, or the whole matrix.

The ‘run’ parameter is the only mandatory parameter. Defaults
are indicated for all other parameters.  For additional information on
the user interface, see the Orion User Guide.

<testname> is the prefix used for all input and output filenames.  By
default, it is ‘orion’.  It can be specified with the ‘testname’
parameter.

<testname>.lun should contain a carriage-return-separated list of LUNs.

The output files for a test run are prefixed by <testname>_<date> where
date is “yyyymmdd_hhmm”.

The output files are:
<testname>_<date>_summary.txt –  Summary of the input parameters, along with
the minimum small IO latency (in usecs), the maximum
MBPS, and the maximum IOPS observed.
<testname>_<date>_mbps.csv – Performance results of large IOs in MBPS.
<testname>_<date>_iops.csv – Performance results of small IOs in IOPS.
<testname>_<date>_lat.csv – Latency of small IOs (in usecs).
<testname>_<date>_trace.txt – Extended, unprocessed output.

WARNING: IF YOU ARE PERFORMING WRITE TESTS, BE PREPARED TO LOSE ANY DATA STORED
ON THE LUNS.

Mandatory parameters:
run                     Type of workload to run (simple, normal, advanced, dss, oltp).
simple   – Tests random small (8K) IOs at various loads,
then random large (1M) IOs at various loads.
normal   – Tests combinations of random small (8K) IOs and
random large (1M) IOs.
advanced – Tests the workload specified by the user
using optional parameters.
dss      – Tests with random large (1M) IOs at increasing
loads to determine the maximum throughput.
oltp     – Tests with random small (8K) IOs at increasing
loads to determine the maximum IOPS.

Optional parameters:
testname                Name of the test run.

num_disks               Number of disks (physical spindles).  This number is
used to gauge the range of loads that Orion should test
at.  Increasing this parameter results in Orion using
heavier IO loads.  Default is the number of LUNs in
<testname>.lun.

size_small              Size of small IOs in KB.  Default is 8.

size_large              Size of large IOs in KB.  Default is 1024.

type                    Type of large IOs (rand, seq).  Default is rand.
rand – Randomly distributed large IOs.
seq  – Sequential streams of large IOs.

num_streamIO            Number of concurrent IOs per stream.  This parameter is only
used if -type is seq.  Default is 4.

simulate                Orion tests on a virtual LUN formed by combining the
specified LUNs in one of these ways.  This parameter is
typically only used if -type is seq.  Default is concat.
concat – A serial concatenation of the LUNs.  Each
sequential stream issues IOs to only one LUN.
raid0  – A RAID-0 mapping across the LUNs.  Each
sequential stream issues IOs across all LUNs,
using RAID-0 striping.

write                   Percentage of IOs that are writes (SEE WARNING ABOVE).
Default is 0.

cache_size              Size in MBs of the array’s cache.
Unless this option is set to 0, Orion issues a number
of unmeasured, random IOs before each large sequential
data point.  These IOs fill up the storage array’s cache
(if any) with random data so that IOs from one
data point do not result in cache hits for the next
data point.  Read tests are preceded with junk reads
and write tests are preceded with junk writes.  If
specified, this ‘cache warming’ is performed until
cache_size MBs of IO have been read or written.
Default behavior is to issue 2 minutes of unmeasured random
IOs before each data point.

duration                Duration of each data point in seconds.  Default is 60.

num_small               Number of outstanding small IOs.  This parameter controls the
small IO load.  Only used if -matrix is point, col, or max.
No default.

num_large               This parameter controls the large IO load.
For -type rand, number of outstanding large IOs.
For -type seq, number of sequential IO streams.  Only used
if -matrix is point, row, or max.  No default.

matrix                  An Orion test consists of multiple data point tests.  These data
point tests can be represented as a two-dimensional matrix.
Each column in the matrix represents data point tests with
the same small IO load, but varying large IO loads.  Each
row represents data point tests with the same large IO load,
but varying small IO loads.  An Orion test can be for a
single point, a single row, a single column, or the whole
matrix, depending on the matrix option setting below.
Default is basic.
basic    – Test small IOs only, then large IOs only.
detailed – Test entire matrix.
point    – Test with num_small small IOs, num_large large
IOs.
col      – Test a varying large IO load with num_small
small IOs.
row      – Test a varying small IO load with num_large
large IOs.
max      – Test varying loads up to the num_small and
num_large limits.

verbose                 Prints tracing information to standard output if set.
Not set by default.

Examples:
For a preliminary set of data
-run simple
For a basic set of data
-run normal
To evaluate storage for an OLTP database
-run oltp
To evaluate storage for a data warehouse
-run dss
To generate combinations of 32KB and 1MB reads to random locations
-run advanced
-size_small 32 -size_large 1024 -type rand
-matrix detailed
To generate multiple sequential 1MB write streams, simulating RAID0 striping
-run advanced
-simulate RAID0 -write 100 -type seq
-matrix col -num_small 0

Advertisements

4 responses to “ORION (Oracle I/O Calibration Tool) included in 11g R2

  1. coskan October 27, 2009 at 4:22 pm

    Miladin,

    Does this mean instead of modified Orion in 11GR1 actual Orion is being used by Oracle ?

  2. oraclue October 29, 2009 at 5:07 pm

    Coscan,

    Did not chance much to play with previous versions.I just discovered that this binary is included with R2 version.

    Miladin

  3. Pingback: Log Buffer #167: a Carnival of the Vanities for DBAs | Pythian Group Blog

  4. Pingback: Oracle Database 11g Release 2 Includes The Orion I/O Test Tool, But You Better Get That Full Path Name Right. « Kevin Closson’s Oracle Blog: Platform, Storage & Clustering Topics Related to Oracle Databases

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: