Use the commands in this section to set up Challenge Handshake Authentication Protocol (CHAP) user names and passwords for the logical devices on your iSCSI Storage Appliance.
Changes made using these commands take effect immediately.
To enter the chap context, enter:
chap
Info
This command displays all CHAP user names that have been set:
info
Logical (Device) Commands
Password
Note Administrator access only.
This command sets the CHAP secret. You will be prompted to enter the password twice and then confirm the password. Enter:
password
When prompted, enter the password twice.
When prompted, confirm the password.
Notes 1) If your password doesn’t meet the minimum iSCSI RFC 3720 protocol, you are prompted to create a different password; enter either yes or no, as desired. 2) If you are using CHAP with the Microsoft iSCSI initiator, the CHAP secret must be 12–16 characters long or it will be rejected by the iSCSI initiator.
User
This command sets the CHAP user name:
user user_name
Create
Note Administrator access only.
This command creates a new logical device. The complete command syntax is:
create logical_device_name pool_name logical_device_size Where:
• logical_device_name is a unique name for the logical device
• pool_name is the name of the pool from which to build the logical device
• logical_device_size is either:
• the size of the logical device (for example, 10GB), or
• available (the logical device will use all available pool space)
When the logical device is created, the IQN that the iSCSI initiator uses to access the logical device is generated automatically.
To create a new logical device of a specific size, enter:
create logical_device_name pool_name logical_device_size
Logical (Device) Commands
Destroy
Note Administrator access only.
This command deletes a specified logical device. You must specify the logical device by its name. (To find the name of a logical device, enter list.) You will be prompted to confirm that you want to delete the specified logical device.
To delete a logical device, enter:
destroy logical_device_name yes
To delete multiple logical devices simultaneously, enter:
down logical_device_name_list yes
Down
Note Administrator access only.
This command takes down a specified logical device. You must specify the logical device by its name. (To find the name of a logical device, enter list.) You will be prompted to confirm that you want to take down the specified logical device.
To take down a logical device, enter:
down logical_device_name yes
To take down multiple logical devices simultaneously, enter:
down logical_device_name_list yes
Info
In the logical context, this command displays information about one or more logical devices, including status, the amount of space used, and auto-discovery control lists. You must specify each logical device by its name. (To find the name of a logical device, enter list.)
To display information about all logical devices associated with your iSCSI Storage Appliance, enter:
info
Logical (Device) Commands
List
In the logical context, this command lists all known logical devices associated with your iSCSI Storage Appliance:
list
Manage Commands
Note Administrator access only, except for the info command.
Use these commands to modify a specified logical device. For instance, you can control access to the logical device, increase the size of a logical device, and manage authentication settings. You must specify each logical device by its name. (To find the name of a logical device, enter list.) To enter the manage context for a logical device, enter:
manage logical_device_name
Allow
This command adds specified iSCSI initiators to the logical device’s auto-discovery control list. You must specify each iSCSI initiator by its name. (To find the name of an iSCSI initiator, see “List” on page 27.) If you specify read-only (readonly), the iSCSI initiator will have read-only access to the logical device.
To add specified iSCSI initiators to the logical device’s auto-discovery control list, enter:
allow iSCSI_initiator_name_list
To give specified iSCSI initiators read-only access to the logical device, enter:
allow readonly iSCSI_initiator_name_list
Authentication
This command sets authentication for the logical device. You can choose between CHAP, SRP, and none. (These commands are not case-sensitive.)
To change the authentication setting for the logical device, enter:
authentication authentication_setting
Logical (Device) Commands
Chapusers Commands
Use these commands to manage CHAP authentication settings on the logical device. To enter the chapusers context, enter:
chapusers
• List
In the chapusers context, this command lists all CHAP users of the logical device:
list
• Password
This command sets a new CHAP secret:
password new_CHAP_secret
• Remove
This command removes one or more specified CHAP users from the list of those allowed to access the logical device. You must specify each CHAP user by name.
(To find the name of a CHAP user, see “Info” on page 36.) To remove one or more CHAP users, enter:
remove chap_user_name_list
Note For more CHAP commands, see page 36.
Deny
This command removes specified iSCSI initiators from the logical device’s auto-discovery control list. You must specify each iSCSI initiator by its name. (To find the name of an iSCSI initiator, see “List” on page 27.)
To complete the removal of the iSCSI initiator, you will be prompted to enter a CHAP user name and secret for that initiator.
To remove specified iSCSI initiators from the logical device’s auto-discovery control list, enter:
allow iSCSI_initiator_name_list CHAP_user_name
CHAP_password CHAP_password
Logical (Device) Commands
Growby
This command grows (or expands) a logical device by a specified size or by a percentage of the available pool space. If you specify the percentage, you can choose any whole percentage between 1 and 99; partial percentages (for instance, .5) are not supported.
To expand a logical device, enter:
growby size_or_percentage For example:
growby 10GB or
growby 25%
Growto
This command grows (or expands) a logical device to a specific size:
growto new_logical_drive_size For example:
growto 50GB
Info
In the manage context, this command displays information about the logical device, including its status, the amount of space used, and its auto-discovery control list:
info
Interface
This command specifies the iSCSI interface(s) through which the logical device can be accessed. You can specify a single iSCSI interface, multiple interfaces, or all interfaces.
To allow access to the logical device through one or more iSCSI interfaces, enter:
interface iSCSI_interface_list
To allow access to the logical device through all iSCSI interfaces, enter:
interface all
Rename
Logical (Device) Commands