Overview: The Next Generation Mass Storage Stack (September 2009)

–x Removes stale entries from the I/O configuration (devices for which there appears to be no hardware)
and associated DSFs.
–L Removes legacy DSFs and their entries in the I/O configuration. This option is typically used during
migration in conjunction with insf. The rmsf -L command disables legacy addressing support by
removing all legacy DSFs and legacy configuration information, while insf –L re-enables legacy
addressing support by recreating the legacy DSFs and configuration information. For more
information, see Migrating to the Agile View
.
ioinit(1M)
The ioinit command tests and maintains consistency between the kernel I/O data structures and the I/O
configuration files. It can also reassign instance numbers for devices. In HP-UX 11i v3, instance numbers are
assigned as devices are discovered, so instance numbers for a given device class may not be sequentially ordered
based on hardware path. Because persistent DSF names contain the instance number, you might want to reassign
instance numbers to remove “holes” in the numbering or create consistent DSF names for devices shared between
servers. As of HP-UX 11i v3, ioinit provides the ability to reassign instance numbers without a reboot, also
known as online instance number reassignment, and the ability to reassign all the instance numbers of a given
class, starting from zero, on the next boot.
The existing –f infile option, used to reassign instance numbers, is changed as follows:
• The infile must contain all the valid devices.
• If none of the drivers of the devices provided support online reassignment, you must reboot the system to
complete the instance number reassignment, as in previous releases of HP-UX.
• If all the drivers of the devices provided support online reassignment, the instance number reassignment
happens immediately, without rebooting the system.
• HP discourages using an infile containing a mix of drivers that support online instance number
reassignment and drivers that do not. HP recommends running ioinit twice, once with all the drivers
that support online instance number reassignment and then with all the drivers that do not. But vice versa
is not recommended. If you want to use both types of drivers in the same infile, you must halt the
special file daemon sfd before running ioinit. To do this, edit /etc/inittab to comment out the
entry related to sfd and run init q. To complete the instance number reassignment, you must then
reboot the system.
Note: Online instance number reassignment requires support in the device driver. If a driver supports
online instance number reassignment, it supports the is_inst_replaceable property. This
property is available in the HP-UX 11i v3 March 2008 release, or you can enable it by installing
PHKL_37458 and PHCO_37479. For more information, see ioscan(1M).
Note: If the infile has more than 14 devices whose drivers support online reassignment, you must
install patches PHKL_36333 and PHCO_36315 to complete the reassignment online.
The ioinit command also supports the following new options:
–rC class
Forces the kernel to reassign instance numbers starting from 0 for all devices belonging to the given
class. If the reassignment succeeds, ioinit reboots the system. Existing DSFs are not removed, but
their mappings might change; that is, old instance numbers might be reused. To create new DSFs for
the devices whose instance number has changed, run insf –e -C class. Use this option with
caution. You must be sure that the applications using these DSFs are modified to point to the newly
created DSFs.
21