Page 1
User Guide hp StorageWorks iSCSI Feature Pack Product Version: Version 1.5 First Edition (September 2004) Part Number: T3662-90901 HP StorageWorks iSCSI Feature Pack for HP NAS products provides virtualization, allocation of disk storage, and centralized management for iSCSI host applications.
Page 2
Hewlett-Packard. The information contained in this document is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty.
HP iSCSI Feature Pack is comprised of a Windows-compatible iSCSI target driver and an iSNS (Internet Storage Name Service) server. All software management has been integrated under a tabular “iSCSI” window in the Windows Server 2003 Web Administration screen.
Page 6
The following figure illustrates how your NAS system provides file-level storage for your workstations, and how your iSCSI Feature Pack provides block-level storage for your application and file servers. HP StorageWorks iSCSI Feature Pack User Guide...
NOTICE: You must use the ANSI machine name for the iSCSI Feature Pack system if you are running the system on a non-English language machine. NOTE: Your system will be rebooted after the installation. HP StorageWorks iSCSI Feature Pack User Guide...
Page 8
Feature Pack (and runs as an independent Windows service when enabled). The HP NAS 500s, 1200s, and 1500s systems have a single pre-allocated LUN and • single file system. To allocate storage to the iSCSI target, create a virtual file-based device using NTFS (NT File System) volume space.
• Detailed, specific questions HP Storage Web Site The HP web site has the latest information on this product, as well as the latest drivers. Access the storage site at: http://www.hp.com/country/us/eng/prodserv/storage.html. From this web site, select the appropriate product or solution.
NOTE: If you do not enable iSNS, you will need to register client initiators with your iSCSI Feature Pack. This enables the server to see the available initiators. Since this procedure can vary by vendor, you should refer to the documentation provided by the vendor. HP iSCSI Feature Pack User Guide...
3. Specify a name for the new pool. Deleting a Storage Pool NOTE: You can only delete a pool if it is empty or if all of the devices in the pool have zero usage. HP iSCSI Feature Pack User Guide...
Page 12
To view device layout for an iSCSI storage device that is not in a pool: 1. Click the checkbox to the left of the device you want to view. 2. Click View Device Layout. HP iSCSI Feature Pack User Guide...
3. To add a new portal, click Add, select an IP address, and enter a port number and port group. To delete a portal, click the checkbox to the left of it and click Remove. HP iSCSI Feature Pack User Guide...
2. Select Server Configuration Files. 3. Locate the saved file and click Restore. By default, the name of backed up file is: iscsicfg.tgz The iSCSI Feature Pack will be restarted once the restoration is complete. HP iSCSI Feature Pack User Guide...
Server Diagnostic File The iSCSI Feature Pack has a built-in diagnostic feature that captures information about your server into a file that can be sent to HP’s technical support team. To create a diagnostic File: 1. Select Configuration from the main iSCSI screen.
LU. Refer to the Configuring Your iSCSI System section for more details. 1. Select Logical Units from the main iSCSI screen. 2. Click New. 3. Enter a name for the new LU. HP StorageWorks iSCSI Feature Pack User Guide...
LU from an existing disk. Hard drives with existing data can be imported to make use of the iSCSI Feature Pack’s functionality without any migration/copying or modification of data. HP StorageWorks iSCSI Feature Pack User Guide...
You can see where a LU’s components are allocated (devices and sectors). To view the layout: 1. On the Logical Units screen, click the checkbox to the left of the LU that you want to view. 2. Click View Layout. HP StorageWorks iSCSI Feature Pack User Guide...
If you are using the Microsoft iSCSI initiator, you need to launch the initiator software on the host machine and log off HP StorageWorks iSCSI Feature Pack User Guide...
To delete a LU: 1. On the Logical Units screen, click the checkbox(es) to the left of the LU(s) you want to delete. 2. Click Delete. 3. Click OK to confirm the deletion. HP StorageWorks iSCSI Feature Pack User Guide...
3. Enter a name for the host. You must use the ANSI machine name for the host machine if you are running the system on a non-English language machine. 4. Indicate how the host should connect to the server. HP StorageWorks iSCSI Feature Pack User Guide...
Page 22
NOTE: If you set Read Only access rights for a LU that contains an NTFS partition, that partition will only be readable in Windows 2003. The LU will not show up properly in Windows versions prior to 2003. HP StorageWorks iSCSI Feature Pack User Guide...
To change a host’s LU assignments or access rights: 1. On the Host screen, click the checkbox to the left of the host whose assignment you want to change. 2. Click Logical Units. HP StorageWorks iSCSI Feature Pack User Guide...
To add/delete the portals for a host: 1. On the Host screen, click the checkbox to the left of the host that you want to manage. 2. Click Portals. A list of existing portals is displayed. HP StorageWorks iSCSI Feature Pack User Guide...
NOTE: You should not delete a host if it is attached to a LU. To delete a host: 1. On the Host screen, click the checkbox(es) to the left of the host(s) you want to delete. 2. Click Delete. 3. Click OK to confirm the deletion. HP StorageWorks iSCSI Feature Pack User Guide...
The primary command classes are: Command Class Description Operations Device Storage in the form of physical disks Reserve, release, adopt, rescan, layout, show, showforeign File Storage in the form of files Create, delete, expand, and show HP StorageWorks iSCSI Feature Pack User Guide...
Page 27
%ERRORLEVEL% Possible return codes are: • 0 – successful execution of request • 1 – must run command as Administrators • 2 – unable to login to iSCSI Feature Pack HP StorageWorks iSCSI Feature Pack User Guide...
Show basic command line syntax. Quiet Mode (/q) Suppresses the output of informational and error messages to stderr. Success or failure of the requested operation can be determined by examining the return code (see Command Line Status). HP StorageWorks iSCSI Feature Pack User Guide...
Adopt a foreign iSCSI disk for the purposes of disaster recovery. Parameter Type Description Device The physical device to adopt. The format is: adapter:bus:target:lun Example: iscsicli device adopt device=1:0:0:2 HP StorageWorks iSCSI Feature Pack User Guide...
Page 30
The physical device to display. The format is: adapter:bus:target:lun If not specified, all physical devices will be displayed. Example: iscsicli device show device=0:0:0:2 showforeign List disks available to be adopted. Example: iscsicli device showforeign HP StorageWorks iSCSI Feature Pack User Guide...
Expand a file used by iSCSI. Parameter Type Description Device The physical file based device to expand. The format is: adapter:bus:target:lun Size Size (in MB) of the file. HP StorageWorks iSCSI Feature Pack User Guide...
Name of the new storage pool. Device The physical device to add to the newly created pool. The format is: adapter:bus:target:lun The storage must have been previously reserved. Example: iscsicli pool create pool=Pool1 device=0:0:0:1 HP StorageWorks iSCSI Feature Pack User Guide...
Page 33
Remove a physical device or file from a storage pool. Parameter Type Description Pool Name of the pool. Device The physical device to remove from the pool. The format is: adapter:bus:target:lun HP StorageWorks iSCSI Feature Pack User Guide...
Under the host operational class you can specify the following sub-operations: create Define a new host. Parameter Type Description Host Name of the new host. Initiator iSCSI initiator to associate with this host. HP StorageWorks iSCSI Feature Pack User Guide...
Page 35
Example: iscsicli host delete host=MyServer Add an iSCSI initiator to a host. Parameter Type Description Host Name of the host. Initiator iSCSI initiator name to add. Example: iscsicli host add host=MySQLServer initiator=iqn.1991- 05.com.microsoft:mysqlserver HP StorageWorks iSCSI Feature Pack User Guide...
Page 36
Portal iSCSI portal to remove from the host. The format is: ipaddress[:port[:group]] Example: iscsicli host removeportal host=MySQLServer portal=10.1.11.72:3260:1 assign Assign a LU to a host. Parameter Type Description Host Name of the host. HP StorageWorks iSCSI Feature Pack User Guide...
Page 37
Type of access to grant to hosts. Choices: RO, RW, RWE Example: iscsicli host setaccess host=MySQLServer lu=LU6 accessmode=RWE setauth Change the authentication for the specified host. Parameter Type Description Host Name of the host. HP StorageWorks iSCSI Feature Pack User Guide...
Page 38
ResolveBy=address show Show information about one or more hosts. Parameter Type Description Host Name of the host. If not specified, all hosts will be displayed. Example: iscsicli host show host=MySQLServer HP StorageWorks iSCSI Feature Pack User Guide...
The storage must have been previously formatted by a supported operating system. Pool or Disk Pool or Disk to store the header information for the imported physical device. Host Host to assign the LU. HP StorageWorks iSCSI Feature Pack User Guide...
Page 40
New name of the LU. Example: iscsicli lu rename lu=LU6 newname=MyLU6 expand Expand a LU. Parameter Type Description Name of the LU. Size Size (in MB) to add to the LU. Example: iscsicli lu expand lu=LU6 size=4096 HP StorageWorks iSCSI Feature Pack User Guide...
Page 41
Parameter Type Description Name of the LU. Host Host to assign to the LU. AccessMode Type of access to grant to hosts. Choices: RO, RW, RWE Example: iscsicli lu setaccess lu=LU6 host=MySQLServer accessmode=RO HP StorageWorks iSCSI Feature Pack User Guide...
Parameter Type Description File File to save the configuration data. Example: iscsicli configuration backup file=C:\MyBackups\iscsiserver.cfg restore Restore the configuration data from a file. Parameter Type Description File File that contains the configuration data. HP StorageWorks iSCSI Feature Pack User Guide...
Change iSNS settings. Parameter Type Description iSNSMode iSNS Mode Choices: Off, Local, Remote IP address of the remote iSNS Server. Example: iscsicli isns setmode isnsmode=off iscsicli isns setmode isnsmode=local iscsicli isns setmode isnsmode=remote ip=10.1.11.69 HP StorageWorks iSCSI Feature Pack User Guide...
Page 44
Display iSCSI initiators or iSCSI targets listed in the iSNS database, or iSNS settings. Parameter Type Description Detail Information to display Choices: Settings, Initiators Default: Settings Example: iscsicli isns show detail=targets HP StorageWorks iSCSI Feature Pack User Guide...
License Keycode Example: iscsicli iscsi remove license=12345678 show Show the options installed on the iSCSI Feature Pack. Parameter Type Description Detail Information to display Choices: Version, Options Default: Version Example: iscsicli iscsi show detail=version HP StorageWorks iSCSI Feature Pack User Guide...
Page 46
Example: iscsicli iscsi removeportal portal=10.1.11.72:3260:1 global=no removeallportals Remove all iSCSI portals from the default global template. Example: iscsicli iscsi removeallportals showportal Lists all portals within the global portal template. Example: iscsicli iscsi showportal HP StorageWorks iSCSI Feature Pack User Guide...
Internet Storage Name Service (iSNS): Facilitates device discovery in storage networks. For the iSCSI Feature Pack, iSNS facilitates the naming, registration, and discovery of iSCSI Logical Units by host initiators. Your HP iSCSI Feature PackHP includes iSNS software that can be activated if Microsoft's iSNS software is not available.