qiomkfile

NAME

qiomkfile - create a VxFS Quick I/O device file

SYNOPSIS

AVAILABILITY

VRTSvxfs

DESCRIPTION

qiomkfile creates a raw character device file using a file name extension and a regular file with preallocated, contiguous disk space. This improves Online Transaction Processing (OLTP), allowing databases to access a regular file as a raw device. qiomkfile also creates a symbolic link file with the character device name extension ::cdev:vxfs: so that the file can be accessed via the Quick I/O for Databases device driver in a VERITAS file system.

Use the -h headersize option to create Oracle-specific datafiles. If the size of the file including the header is not a multiple of the file system block size, it is rounded to a multiple of the file system block size before preallocation.

For other databases, omit the -h option to create files.

CLUSTER FILE SYSTEM ISSUES

Quick I/O works on VxFS cluster file systems, but Cached Quick I/O is not currently supported.

OPTIONS

-a

Creates a symbolic link with an absolute path name for the specified file. Omitting this option creates a symbolic link with a relative path name. Use -a when absolute path names are required (for example, when using Quick I/O with SAP).

-e size

Extends the size of the specified file by size to allow Oracle tablespace resizing. size can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, g, G, t, T, b, or B). The default is bytes. Maximum file size is two terabytes minus one.

-h " headersize"

Creates a file file with additional space allocated for the Oracle header. headersize can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, t, g, G, T, b, or B). The default is bytes. Oracle files require additional space equal to one Oracle block to store header information, so headersize should be equal to the Oracle block size. 32K is the default if headersize is omitted.

-r size

Increases the specified file to size to allow Oracle tablespace resizing. size can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, g, G, t, T, b, or B). The default is bytes. Maximum file size is two terabytes minus one.

-s size

Preallocates space size for a file. size can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, g, G, t, T, b, or B). The default is bytes.

EXAMPLES

Create a file named foo of 1 megabyte:

qiomkfile -s 1M foo 

Create a file named dbf of 1 megabyte as an Oracle datafile:

qiomkfile -h -s 1M dbf 

Create a file named sapdata1 of 1 megabyte, but use an absolute path name for the ::cdev:vxfs: device name extension:

qiomkfile -s 1M -a sapdata1 

The following example shows the result after running the above commands:

Increase the size of the file dbf by 20 megabytes:

qiomkfile -e 20M dbf 

Increase the size the file dbf to 100 megabytes:

qiomkfile -r 100M dbf 

SEE ALSO

qioadmin (1), qiostat (1), getext (1M), setext (1M), vxtunefs (1M), vxfsio (7)