Fio-detach, Fio-format – HP IO Accelerator for BladeSystem c-Class User Manual

Page 32

Advertising
background image

Utilities 32

For example, the filename for a bug report file named
fio-bugreport-20111006.173256-sc07HE.tar.gz indicates the following:

Date (20111006)

Time (173256, or 17:32:56)

Misc. information (sc07HE.tar.gz)

fio-detach

CAUTION:

Before using this utility, be sure that the IO Accelerator to be detached is not currently

mounted or otherwise in use (for example, as a datastore). The driver cannot determine whether
the drive is in use at the time of detaching. Detaching a drive while it is in use might cause errors,

data loss, and corruption.

The fio-detach utility detaches the IO Accelerator from the operating system one device at a time. By

default, the command displays a progress bar and percentage as it completes the process.
Syntax
fio-detach <device> [options]
where <device> is the name of the device node (/dev/fctx), where x indicates the card number: 0, 1,

2, and so on. For example, /dev/fct0 indicates the first IO Accelerator installed on the system.
Options

Option

Description

-i

Immediate: Causes a forced, immediate detach (does not save metadata). This command

will fail if the device is in use by the operating system.

-q

Quiet: Disables the display of the progress bar and percentage.

With version 2.0 and later of the driver, attempting to detach an IO Accelerator might fail with an error
indicating that the device is busy. This error typically might occur if the IO Accelerator is in use by VM or

other process, or some process has the device open.

fio-format

You must detach the IO Accelerator before running this command. For more information, see "fio-detach (on

page

32

)."

Description
The fio-format command performs a low-level format of the IO Accelerator. This format is different from

a format performed by the operating system. The utility displays a progress bar and percentage as it

completes the format.
The IO Accelerator ships pre-formatted, so you only have to run the fio-format command if you need to

change the logical size of the device.

CAUTION:

Use this utility with care since it deletes all user information on the IO Accelerator.

NOTE:

VMFS, the default filesystem employed by ESX, requires a 512-byte sector size.

Advertising