sdiadd(1M)

sdiadd -- hot add mass storage peripheral devices to the kernel

Synopsis

/sbin/sdiadd [-n] device

Description

The sdiadd(1M) script is used to hot add SDI mass storage target device (such as a disk or tape driver) to the UnixWare system.

Options

sdiadd takes the following option and argument:

-n: Prevents sdiadd from prompting the user or quieting the SCSI bus. It also allows the command to be run outside the console.
device: This required argument specifies the new controller you want to add. For a list of the devices supported by your release of the UnixWare system, execute sdiadd without any arguments.

Usage

NOTE: If you are trying to add a new mass-storage peripheral device to an existing, working disk controller or SCSI host bus adapter already installed in your UnixWare system, you do not need to use this command. Shut down your system, power it off, install the new mass-storage device, and turn your system back on. Any reconfiguration that must take place to support your device will be automatic.

If the device you are adding is a disk device, you also need to use the diskadd(1M) utility to set up your new disk device and create filesystems on it. Do not attempt to run diskadd until after you have shut down and restarted your UnixWare system.

If the device you are installing is or requires a new controller, you must be able to determine some of the basic characteristics of your new controller. If you do not understand the terms DMA channel, interrupt vector, and memory address, read the documentation that came with your new device carefully. This should provide you with enough data to successfully install your new device in the UnixWare system.

Using SCSI hot addition/removal with sdiadd

Hot addition/removal is the ability to add and remove SCSI devices from a running system.

To use this feature, the HBA and target drivers must support hot addition/removal.

To add a device to the system, the system administrator:

Chooses a SCSI ID for the device, making sure it does not conflict with any on the SCSI bus. Failure to do this correctly will crash the system; this is a hardware limitation that cannot be addressed in software.
Ensures that adding the device to the system will maintain proper SCSI bus termination. Failure to do this correctly will crash the system; this is also a hardware limitation that cannot be addressed in software.
To simplify this problem, never have any termination on a device; instead, use terminators attached to the end of the SCSI bus cable. It is recommended that the device not provide termination power. Most devices have a jumper or switch to disable termpower.
Execute /sbin/sdiadd.
Add the device to the system.
Press the <Enter> key to inform sdiadd that the device has been added and that normal SCSI bus operation can resume.

Return values

References

disk.cfg(4dsp), diskadd(1M), idbuild(1M), idcheck(1M), sdirm(1M)

NOTE: If you change the hard disk configuration on your system (for example, you add or replace a hard disk), create new emergency recovery disks. For details, see emergency_disk(1M).