update_iscsi Command

Purpose

Lists and updates the configurations of devices for the iSCSI software initiator that is accessed through the iSCSI software initiator or the iSCSI TOE adapter.

Syntax

update_iscsi [ -l name ]

Description

The update_iscsi command lists and updates the devices for which configuration attributes are related to iSCSI and must be migrated to the Object Data Manager (ODM) of the rootvg image.

You can run the update_iscsi command in maintenance mode after all of the file systems that contain the base operating system in the rootvg image are mounted. Note that only the devices that are causing iSCSI boot problems should be updated.

To list the devices for which the iSCSI configuration attributes are changed, run the update_iscsi command without any argument.

To migrate the configuration of a listed device to the ODM of the rootvg image, run the update_iscsi command with the -l name flags. The name parameter represents the ODM name of a device in the RAM file system.

The update_iscsi command displays the devices that are listed in the iscsi_devlist file, which is located in the /etc/objrepos directory. The command lists these devices after matching them to the corresponding rootvg entries. If the iscsi_devlist file is missing, or if the file lists no devices, a message will be printed indicating that you did not set the ODM for the RAM file system.

Flags

Item Description
-l Specifies the ODM name of a device in the RAM file system. This flag is optional.

Parameters

Item Description
name The ODM name of a device in the RAM file system.

Sample Output

The following sample shows the output of the update_iscsi command with no flag specified:
RAM FS DEVICE NAME     ROOTVG DEVICE NAME       DESCRIPTION
inet0                  inet0                    Internet Network Extension
en0                    en1                      Standard Ethernet Network Interface
iscsi0                 iscsi0                   iSCSI Protocol Device

Exit Status

If the update_iscsi command cannot find the ODM name that the name parameter specifies, the value of the ROOTVG DEVICE NAME is set to New Device.

If the iscsi_devlist file is missing or empty, an error message is printed.

Location

/usr/sbin/

Files

Item Description
iscsi_devlist Contains a list of the devices with attributes that are set through the Network Disk Install menu.