Vdbench 5.04.07
Copyright © 2000, 2018, Oracle and/or its affiliates. All rights reserved. 1
Vdbench
Users Guide
Version: 5.04.07
May 2018
Author: Henk Vandenbergh
Vdbench 5.04.07
Copyright © 2000, 2018, Oracle and/or its affiliates. All rights reserved. 2
1. Copyright Notice
Copyright © 2000, 2018, Oracle and/or its affiliates. All rights reserved.
2. Trademark Notice
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
3. License Restrictions Warranty/Consequential Damages Disclaimer
This software and related documentation are provided under a license agreement containing
restrictions on use and disclosure and are protected by intellectual property laws. Except as
expressly permitted in your license agreement or allowed by law, you may not use, copy,
reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish
or display any part, in any form, or by any means. Reverse engineering, disassembly, or
decompilation of this software, unless required by law for interoperability, is prohibited.
4. Warranty Disclaimer
The information contained herein is subject to change without notice and is not warranted to
be error-free. If you find any errors, please report them to us in writing.
5. Restricted Rights Notice
If this is software or related documentation that is delivered to the U.S. Government or
anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system,
integrated software, any programs installed on the hardware, and/or documentation,
delivered to U.S. Government end users are “commercial computer software” pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, use, duplication, disclosure, modification, and adaptation of the programs, including
any operating system, integrated software, any programs installed on the hardware, and/or
documentation, shall be subject to license terms and license restrictions applicable to the
programs. No other rights are granted to the U.S. Government.
6. Hazardous Applications Notice
This software or hardware is developed for general use in a variety of information
management applications. It is not developed or intended for use in any inherently dangerous
applications, including applications that may create a risk of personal injury. If you use this
software or hardware in dangerous applications, then you shall be responsible to take all
appropriate failsafe, backup, redundancy, and other measures to ensure its safe use. Oracle
Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
7. Third Party Content, Products, and Services Disclaimer
This software or hardware and documentation may provide access to or information on
content, products and services from third parties. Oracle Corporation and its affiliates are not
responsible for and expressly disclaim all warranties of any kind with respect to third-party
content, products, and services. Oracle Corporation and its affiliates will not be responsible
for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services.
Vdbench 5.04.07
Copyright © 2000, 2018, Oracle and/or its affiliates. All rights reserved. 3
TABLE OF CONTENTS :
Contents
VDBENCH ...................................................................................................................... 1
USERS GUIDE ............................................................................................................... 1
VERSION: 5.04.07 .......................................................................................................... 1
AUTHOR: HENK VANDENBERGH ............................................................................... 1
1 VDBENCH: DISK I/O WORKLOAD GENERATOR ................................................ 9
1.1 Introduction ....................................................................................................................... 9
1.2 Objective ............................................................................................................................ 9
1.3 Terminology..................................................................................................................... 10
1.4 Installing Vdbench .......................................................................................................... 10
1.5 How to start Vdbench:.................................................................................................... 11
1.6 Execution parameter overview ...................................................................................... 12
1.6.1 Execution Parameters.................................................................................................... 12
1.7 Parameter File(s) ............................................................................................................. 14
1.7.1 Variable substitution. .................................................................................................... 14
1.7.2 Multi-host parameter replication................................................................................... 14
1.7.3 include=parmfile ........................................................................................................... 15
1.7.4 General Parameters: Overview ..................................................................................... 15
1.7.5 Host Definition (HD) Parameter overview ................................................................... 17
1.7.6 Replay Group (RG) Parameter Overview ..................................................................... 18
1.7.7 Storage Definition (SD) Parameter Overview .............................................................. 19
1.7.8 File system Definition (FSD) Parameter Overview ...................................................... 20
1.7.9 Workload Definition (WD) Parameter Overview ......................................................... 20
1.7.10 File system Workload Definition (FWD) Parameter Overview ............................... 20
1.7.11 Run Definition (RD) Parameter Overview (For raw I/O testing) ............................. 21
1.8 Execution parameter detail ............................................................................................ 23
1.8.1 '-f xxx ': Workload Parameter File(s) ............................................................................ 23
1.8.2 '-oxxx': Output Directory .............................................................................................. 24
Vdbench 5.04.07
Copyright © 2000, 2018, Oracle and/or its affiliates. All rights reserved. 4
1.8.3 '-v': Activate Data Validation ........................................................................................ 24
1.8.4 '-j': Activate Data Validation and Journaling ................................................................ 25
1.8.5 '-s': Simulate Execution ................................................................................................. 25
1.8.6 '-k': Kstat Statistics on Console ..................................................................................... 25
1.8.7 '-m nn': Multi JVM Execution ...................................................................................... 26
1.8.8 ‘-t’ or '-tf': Sample Vdbench execution. ........................................................................ 26
1.8.9 ‘-e nn’ Override elapsed time ....................................................................................... 26
1.8.10 ‘-i nn’ Override report interval time. ........................................................................ 27
1.8.11 ‘-w nn’ Override warmup time. ................................................................................ 27
1.9 Vdbench utility functions. .............................................................................................. 28
1.9.1 ./vdbench sds: Generate Vdbench SD parameters. ....................................................... 28
1.9.2 ./vdbench jstack: Display java execution stacks of active Vdbench runs. ................... 28
1.9.3 ./vdbench rsh: Vdbench RSH daemon. ......................................................................... 28
1.9.4 ./vdbench print: Print any block on any lun or file. ...................................................... 28
1.9.5 ./vdbench edit: Simple full screen editor, or ‘back to the future’. ................................ 29
1.9.6 ./vdbench compare: Compare Vdbench test results. ..................................................... 29
1.9.7 ./vdbench parse: Parse Vdbench flatfile. ....................................................................... 29
1.9.8 ./vdbench csim: Compression simulator ....................................................................... 29
1.9.9 ./vdbench dsim: Dedup simulator ................................................................................. 29
1.9.10 ./vdbench printjournal: print (subset of) .jnl file ....................................................... 30
1.9.11 ./vdbench showlba: Visualize data access pattern .................................................... 30
1.10 General parameter detail ............................................................................................... 32
1.10.1 ‘include=parmfile’ .................................................................................................... 32
1.10.2 'data_errors=xxx': Terminate After Data Validation or I/O errors ........................... 32
1.10.3 'startcmd=' and 'endcmd=' ......................................................................................... 33
1.10.4 'pattern=: Data Pattern to be used ............................................................................. 34
1.10.5 ‘compratio=nn’: Set compression for data patterns .................................................. 35
1.10.6 ‘port=nnnn’: Specify port number for Java sockets. ................................................. 35
1.10.7 ‘create_anchors=yes’: Create anchor parent directory ............................................. 36
1.10.8 ‘report=’: Generate extra SD reports. ....................................................................... 36
1.10.9 ‘histogram=’: set bucket count and bucket size for response time histograms......... 36
1.10.10 ‘formatxfersize=nnnn’ .............................................................................................. 37
1.10.11 'monitor=', External control of Vdbench termination ............................................... 37
1.10.11.1 Shutdown via temporary file ............................................................................. 37
1.10.11.2 Shutdown via monitor= parameter ................................................................... 37
1.10.12 'messagescan=': suppress /var/xxx/messages scan .................................................... 38
1.10.13 timeout=(nn,script) ................................................................................................... 38
1.11 Replay Group (RG) parameter detail ........................................................................... 39
1.12 Host Definition parameter detail ................................................................................... 40
1.12.1 ‘hd=host_label’ ......................................................................................................... 40
1.12.2 ‘system=system_name’ ............................................................................................. 40
1.12.3 ‘master=system_name/IP address ............................................................................. 40
1.12.4 ‘jvms=nnn’ ................................................................................................................ 40
1.12.5 ‘vdbench=/vdbench/dir/name’ .................................................................................. 40
Vdbench 5.04.07
Copyright © 2000, 2018, Oracle and/or its affiliates. All rights reserved. 5
1.12.6 ‘shell=rsh | ssh | vdbench’ ......................................................................................... 41
1.12.7 ‘user=xxxx’ ............................................................................................................... 41
1.12.8 ‘mount=xxx’ ............................................................................................................. 41
1.13 Storage Definition parameter detail .............................................................................. 43
1.13.1 'sd=name': Storage Definition Name ........................................................................ 43
1.13.2 'lun=lun_name': LUN or File Name.......................................................................... 43
1.13.3 ‘host=name’ .............................................................................................................. 44
1.13.4 ‘count=(nn,mm)’ ....................................................................................................... 44
1.13.5 'size=nn: Size of LUN or File ................................................................................... 45
1.13.6 'range=(min,max)': Limit Seek Range ...................................................................... 45
1.13.7 'threads=nn': Maximum Number of Concurrent outstanding I/Os .......................... 46
1.13.8 'hitarea=nn': Storage Size for Cache Hits ................................................................. 46
1.13.9 'journal=name': Directory Name for Journal File ..................................................... 46
1.13.10 ‘offset=’: Don’t start at byte zero of a LUN ............................................................. 47
1.13.11 ‘align=’: Determine lba boundary for random seeks. ............................................... 47
1.13.12 ‘openflags=’: control over open and close of luns or files........................................ 48
1.13.13 streams=: Independent sequential streams. ............................................................... 50
1.14 Workload Definition parameter detail.......................................................................... 50
1.14.1 'wd=name': Workload Definition Name ................................................................... 51
1.14.2 ‘host=host_label’ ...................................................................................................... 51
1.14.3 'sd=name': SD names used in Workload ................................................................... 51
1.14.4 'rdpct=nn': Read Percentage ...................................................................................... 52
1.14.5 'rhpct=nn' and 'whpct=nn': Read and Write Hit Percentage...................................... 52
1.14.6 'xfersize=nn': Data Transfer Size .............................................................................. 52
1.14.7 'skew=nn': Percentage skew ...................................................................................... 53
1.14.8 'seekpct=nn': Percentage of Random Seeks .............................................................. 53
1.14.9 stride=(min,max): Skip-sequential I/O. .................................................................... 54
1.14.10 'range=nn': Limit Seek Range ................................................................................... 54
1.14.11 ‘iorate=’ Workload specific I/O rate. ........................................................................ 55
1.14.12 ‘priority=’ Workload specific I/O priority. ............................................................... 55
1.15 Run Definition for raw I/O parameter detail ............................................................... 56
1.15.1 'rd=name': Run Name ............................................................................................... 57
1.15.2 'wd=': Names of Workloads to Run .......................................................................... 57
1.15.3 ‘sd=xxx’ .................................................................................................................... 57
1.15.4 'iorate=nn': One or More I/O rates ............................................................................ 57
1.15.5 'curve=nn': Define Data points for Curve ................................................................. 58
1.15.6 'elapsed=nn: Elapsed Time ....................................................................................... 58
1.15.7 'interval=nn': Reporting Interval ............................................................................... 59
1.15.8 ‘warmup=nn’: Warmup period ................................................................................. 59
1.15.9 'maxdata=': stop after nnn bytes. ............................................................................... 59
1.15.10 'distribution=xxx': I/O arrival time distribution ........................................................ 60
1.15.11 'pause=nn': Sleep 'nn' Seconds .................................................................................. 60
1.15.12 Workload parameter specification in a Run Definition. ........................................... 60
1.15.12.1 ‘sd=xxx’ Specify SDs to use ............................................................................. 61
评论0