chiscsi Command

Purpose

Changes iSCSI target data.

Syntax

chiscsi -l AdapterName -g static -t TargetName [ -n PortNumber -i IPaddress ] [-p password] [-T NewTargetName] [-N NewPortNumber] [-I NewIPaddress]

chiscsi -l AdapterName -g auto -t TargetName [ -p password] [-T NewTargetName]

Description

The chiscsi command changes iSCSI target data in ODM. There are two categories of data stored in ODM. The first is for statically configured iSCSI targets, which require that all the relevant iSCSI target information (such as target name, IP address, and port number) are specified in order for AIX® to discover them. The 2nd category of iSCSI target data is for iSCSI target devices that can be configured automatically, but require authentication from the host (such as passwords). These two categories of iSCSI target data are associated with the static and auto groups, respectively, specified by the -g flag.

Flags

Item Description
-g group Specifies which group this iSCSI target is associated with. There two valid groups are static and auto. The static group is for iSCSI targets that cannot be automatically discovered from this host; all relevant iSCSI target information for them (such as target name, IP address, and port number) must be specified. The auto group is for iSCSI targets that are automatically discovered, but require authentication information such as passwords.
-I NewIPaddress Specifies the new IP address of the iSCSI target when it is being changed.
-i IPaddress Specifies the IP address of the iSCSI target.
-l AdapterName Specifies the adapter name for the iSCSI TCP/IP Offload Engine (TOE) adapter that is attached to this iSCSI target. It can also specify the iSCSI protocol device for the iSCSI software solution device.
-N NewPortNumber Specifies the new port number of the iSCSI target when it is being changed.
-n NewPortNumber Specifies the port number on which the iSCSI target is accessed. The default port number is 3260.
-p password Specifies the new password for this iSCSI target.
-T NewTargetName Specifies the new iSCSI target name when it is being changed.
-t TargetName Specifies the iSCSI target name (for example, iqn.sn9216.iscsi-hw1).

Exit Status

Item Description
0 The command completed successfully.
>0 An error occurred.

Security

The chiscsi command is executable only by root.

Examples

  1. To change the password of a statically configured iSCSI target to my password, enter:
    chiscsi -l ics0 -g static -t qn.mds9216.iscsi_hw -n 3260 -i 10.1.2.116 -p "my password"
  2. To change the IP address of a statically configured iSCSI target to 10.1.3.141, enter:
    chiscsi -l ics0 -g static -t qn.mds9216.iscsi_hw -n 3260 -i 10.1.2.116 -I 10.1.3.141

Location

/usr/sbin/chiscsi

Files

Item Description
src/bos/usr/sbin/iscsia Contains the common source files from which the iSCSI commands are built.