Home > Veritas Storage Foundation™ File System Manual Pages
QIOMKFILE (1) |
|
User Commands |
Table of contents
qiomkfile - create a VxFS Quick I/O device file
qiomkfile
[
-h
[
headersize
]] [
-a
]
-s
size
qiomkfile
[
-e
|
-r
]
size
VRTSvxfs
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.
-
-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.
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:
ls -oa
total 204802
drwxr-xr-x 3 oracle 96 Nov 23 14:05 .
drwxr-xr-x 38 root 1024 Nov 9 18:42 ..
-rw-r--r-- 1 oracle 1081344 Nov 23 14:16 .dbf
lrwxrwxrwx 1 oracle 16 Nov 23 14:16 dbf -> .dbf::cdev:vxfs:
-rw-r--r-- 1 oracle 1048576 Nov 23 14:05 .foo
lrwxrwxrwx 1 oracle 16 Nov 23 14:05 foo -> .foo::cdev:vxfs:
-rw-r--r-- 1 oracle 1048576 Nov 23 14:18 .sapdata1
lrwxrwxrwx 1 oracle 16 Nov 23 14:18 sapdata1 ->
/oradata/.sapdata1::cdev:vxfs:
drwx------ 2 root 96 Nov 20 11:54 lost+found
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
getext(1),
qioadmin(1),
qiostat(1),
setext(1),
vxtunefs(1M),
vxfsio(7)
Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.