cpiscsi Command

Purpose

Copies the configuration settings of internet Small Computer System Interface (iSCSI) target devices from a device to another device.

Syntax

cpiscsi -l destination_device -s source_device

Description

When you use multiple iSCSI software initiator devices, you can use the cpiscsi command to copy the configuration settings of the iSCSI target devices from an initiator device to another initiator device. If two devices must access the same target devices, copying the configuration settings from the source device to the destination device is the easiest method to configure the destination device.

When you run the cpiscsi command, all the configuration settings of the iSCSI target devices from the source device are copied. The configuration settings include any specified Challenge Handshake Authentication Protocol (CHAP) user names and passwords. If the configuration settings for the destination device are similar but not the same as the source device, you can first use the cpiscsi command and then use the chiscsi command for minor changes. Existing configuration settings for the destination device are not changed.

Flags

-l destination_device: Specifies the name of the destination device to which the configuration settings are copied.
-s source_device: Specifies the name of the source device from which the configuration settings are copied.

Example

To copy the configuration settings of the iSCSI target devices from the iscsi0 device to the iscsi1 device, run the following command:

cpiscsi -l iscsi1 -s iscsi0

This command copies all the current configuration settings from the iscsi0 device to the iscsi1 device. Thus, the iscsi1 device can access all of the target devices by using the same TCP/IP addresses and port numbers, as are accessed by the iscsi0 device. When the iscsi1 device accesses the specified target devices, it uses the initiator device name that is specified by the initiator_name attribute of the iscsi1 device.