background image

HP StorageWorks iSCSI Feature Pack User Guide

30

Example:

iscsicli file expand device=0:0:0:2 size=1024

show

Display file and status.

Example:

iscsicli file show

Storage Pool Commands

By default all physical storage, when reserved, exists within the context of a storage pool. 
The storage pool can contain one or more physical storage devices of potentially dissimilar 
categories: disk, volume or file. A storage pool must contain at least one device.

The operation class name is: 

pool

Under the device operational class you can specify the following sub-operations:

create

Create a storage pool.

Example:

iscsicli pool create pool=Pool1 device=0:0:0:1

Parameter

Type

Description

Device

O

The file device to display. The format is:

adapter:bus:target:lun

Parameter

Type

Description

Pool

R

Name of the new storage pool.

Device

O

The physical device to add to the newly created pool. The format is:

adapter:bus:target:lun

The storage must have been previously reserved.

Содержание StorageWorks 1200s

Страница 1: ...ck 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 ...

Страница 2: ...ranties 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 shall not be liable for technical or editorial errors or omissions contained herein Hewlett Packard Company shall not be liable for technical or editorial errors or omissions contained herein The i...

Страница 3: ... 8 Storage 9 Default Portal Template 11 License and Version Information 12 Server Configuration Files 12 Server Diagnostic File 13 3 Logical Units Creating a New Logical Unit 14 Importing a Logical Unit 15 Viewing Layout 16 Expanding a Logical Unit 17 Assigning Unassigning a Host to a Logical Unit 17 Viewing Logical Unit Properties 18 Deleting Logical Units 18 4 Hosts Creating a New Host 19 ...

Страница 4: ...ost 21 Managing Portals 22 Viewing Host 23 Deleting Hosts 23 5 Command Line Interface Command Line Basics 24 Global Options 26 Device Commands 27 File Storage Commands 29 Storage Pool Commands 30 Host Commands 32 Logical Unit Commands 37 Configuration Commands 40 iSNS Commands 41 iSCSI Commands 43 6 Glossary ...

Страница 5: ...r IP network infrastructure What is iSCSI You are probably already familiar with the Small Computer Systems Interface SCSI which enables host computers to perform block level data I O to a variety of peripheral devices such as disk and tape devices and printers The Internet SCSI iSCSI protocol adds dimension to SCSI and eliminates the distance limitation associated with it by enabling block level ...

Страница 6: ...ature Pack User Guide 4 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 ...

Страница 7: ...NAS system e g C iSCSI and make it a share with Full Control read write permission Connect to the share from a remote system that has a CD ROM drive using the Microsoft File Explorer From the remote system copy the contents of the CD ROM to the share on the NAS system On the NAS system use My Computer or the File Explorer to browse the directory that was created e g C iSCSI The contents of the iSC...

Страница 8: ...ack 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 You will need to specify how large it should be 5 Install an iSCSI initiator on each of your host systems iSCSI initiator software ...

Страница 9: ...lable before calling Technical support registration number if applicable Product serial numbers Product model names and numbers Applicable error messages Operating system type and revision level 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 s...

Страница 10: ... facilitates the naming registration and discovery of iSCSI Logical Units LU by host initiators By default iSNS is disabled If you have an external iSNS server you can set the system to use it If you do not have an external iSNS server you can use the local one that is provided by the iSCSI Feature Pack When enabled it runs as an independent Windows service 1 Select Configuration from the main iSC...

Страница 11: ...ect Configuration from the main iSCSI screen 2 Select Storage 3 Click New Pool 4 Enter a name for the pool 5 Select one or more available devices to include in the pool Adding Removing Devices From a Storage Pool 1 Click the checkbox to the left of the pool you want to modify 2 Click View Devices You will see a list of all iSCSI storage Information about each device including size type and usage i...

Страница 12: ...To expand a file based device 1 Click the checkbox to the left of the file based device 2 Click Expand File Device 3 Indicate how much space to add and click OK Deleting a File Based Device NOTE You can only disable a file based device if it is not being used 1 Click the checkbox to the left of the file based device 2 Click Delete File Device 3 Click OK to confirm Viewing Device Layout You can see...

Страница 13: ...list of available devices Default Portal Template Portals are access points used by hosts to communicate with the iSCSI Feature Pack Each portal is a combination of an IP address port number and port group number By default the iSCSI Feature Pack assigns each new host one portal for each network interface card NIC IP address used by the iSCSI Feature Pack with the default iSCSI port number 3260 an...

Страница 14: ...up data to a local system 4 Specify a location for the file You can restore your iSCSI Feature Pack configuration from a file that was created using Backup Changes made since the configuration was last saved will not be included in the restored configuration In addition actual LUs that may have been deleted after the configuration was saved will not be re created NOTE Restoring a configuration wil...

Страница 15: ...n 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 2 Select Server Diagnostic File 3 Select Create Diagnostic File 4 Specify a path for the file ...

Страница 16: ... screen you will see a list of all existing LUs Information about each LU is included here To search for a specific LU type its name or a few letters and click Go Only those LUs that match the letters you typed will be displayed From the Logical Units screen the following functions are available New Create a new LU and assign it to a host Import Import a hard drive with existing data to take advan...

Страница 17: ...ly this host can access the LU The host has both read and write access All others including Read Only will be denied access Read Write Non Exclusive Two hosts can connect at the same time with both read and write access NOTICE There is a potential for data corruption if you set the access rights to Read Write Non Exclusive and you have multiple hosts writing to a device at the same time 7 Confirm ...

Страница 18: ...ot contain any iSCSI file devices If you want to import a disk with existing data you must unmount all volumes on the disk i e unassign all drive letters in order to make it available for import To import a disk 1 On the Logical Units screen click Import 2 Enter a Name for the LU that is being created 3 Select the disk to import 4 Select the location where the disk information will be stored NOTE ...

Страница 19: ...ft of the LU that you want to expand 2 Click Expand 3 Indicate how much space to add and click OK NOTICE In order for a host to access the newly expanded LU you will have to take operating system specific actions If you are using the Microsoft iSCSI initiator you need to launch the initiator software on the host machine and log off from the Active Sessions tab and then log on from the Available Ta...

Страница 20: ...at the drive so that the host can use it Viewing Logical Unit Properties You can view the configuration of a LU or change the LU s name To do this 1 On the Logical Units screen click the checkbox to the left of the LU whose properties you want to view 2 Click Properties 3 If you want to change the LU s name type a new name in the box and click OK Deleting Logical Units You can delete one or more L...

Страница 21: ...ssigned to the host Portals Manage the IP portals that the host uses to communicate with the iSCSI Feature Pack Properties View configuration of a host or change authentication type Creating a New Host When you create a new host you select its authentication mode define its initiators and assign it LUs By default each new host is assigned one portal for each network interface card NIC IP address u...

Страница 22: ...tiator you can manually add it You can also register your host initiators with your iSCSI Feature Pack so that they become known to the iSCSI Feature Pack If you are using the Microsoft iSCSI initiator run Microsoft iSCSI Initiator on the host machine You can find the program in the Control Panel or on your desktop if you are the user that installed it Click Add on the Target Portals tab and enter...

Страница 23: ...s you must rescan disks via the system s Computer Management available through the Control Panel You will then need to write a signature create a partition and format the drive so that the host can use it Managing Host Initiators The iSCSI Feature Pack can use an iSNS Server from any iSCSI Feature Pack to locate existing iSCSI initiators However each initiator can only be associated with a single ...

Страница 24: ...l for each NIC IP address used by the iSCSI Feature Pack By default the portal is a combination of the default iSCSI port number 3260 and group 0 This default can be changed through the Default Portal Template from the Configuration screen You may want to customize the portals for a specific host For example if you have four NICs you may want to assign two for your messaging server and two for you...

Страница 25: ...ange the authentication type select it and then enter the appropriate username s and secret s NOTE You cannot change the authentication type while the host is connected to a LU 4 If you want to change how this host should connect to the server select the resolution method Deleting Hosts You can delete one or more hosts Any LU assignment to this host will be lost but the data on the LUs themselves ...

Страница 26: ...utput stdout Command Line Overview The basic command line usage model is iscsicli server server user username pw password q command operation parameters As an example to display a formatted list of all physical storage iscsicli device show Global Options These represent the command line options to control system wide modes and features of the command line These are required to be the first argumen...

Страница 27: ...f the command exit code ERRORLEVEL Possible return codes are 0 successful execution of request 1 must run command as Administrators 2 unable to login to iSCSI Feature Pack Pool Collection of one or more physical devices or files Create delete rename add remove merge and show Host iSCSI host that makes use of the logical units LUs Create delete add remove addportal removeportal assign unassign seta...

Страница 28: ...ure If no server is specified then the operations are assumed to be directed to the machine your running the iSCSICLI from the local host The complete definition of this option is server servername Remote iSCSI Feature Pack User Password user pw When configuring a remote iSCSI Feature Pack the login credentials for this server will be required The complete definition of this option is user usernam...

Страница 29: ... release device 0 0 0 2 pool Pool1 adopt Adopt a foreign iSCSI disk for the purposes of disaster recovery Example iscsicli device adopt device 1 0 0 2 Parameter Type Description Device R The physical device to reserve for use by iSCSI The format is adapter bus target lun Pool R Pool to add the storage into The pool must already exist Parameter Type Description Device R The physical device to relea...

Страница 30: ...ces their status and pool associations Example iscsicli device show device 0 0 0 2 showforeign List disks available to be adopted Example iscsicli device showforeign Parameter Type Description Device R The physical device for which to display the layout The format is adapter bus target lun Parameter Type Description Device O The physical device to display The format is adapter bus target lun If no...

Страница 31: ...030 size 2048 delete Remove a file from use and delete the file Example iscsicli file delete device 0 0 0 2 expand Expand a file used by iSCSI Parameter Type Description Volume R The volume to create the file storage for use by iSCSI Use the Device Show command to see the possible values Size O Size in MB of the file Default available space Parameter Type Description Device R The physical file bas...

Страница 32: ... disk volume or file A storage pool must contain at least one device The operation class name is pool Under the device operational class you can specify the following sub operations create Create a storage pool Example iscsicli pool create pool Pool1 device 0 0 0 1 Parameter Type Description Device O The file device to display The format is adapter bus target lun Parameter Type Description Pool R ...

Страница 33: ...ve Remove a physical device or file from a storage pool Parameter Type Description Pool R Name of the pool Parameter Type Description Pool R Name of the pool Newname R New name of the pool Parameter Type Description Pool R Name of the pool Device C The physical device to add to the pool The format is adapter bus target lun The storage must have been previously reserved Parameter Type Description P...

Страница 34: ...make use of LUs The operation class name is host Under the host operational class you can specify the following sub operations create Define a new host Parameter Type Description Pool R Name of the first pool Pool2 R Name of the second pool Newname R Name for the merged pool Parameter Type Description Pool O Name of the pool If not specified all pools will be displayed Parameter Type Description H...

Страница 35: ...thMode O Authentication mode used by this host Choices none chap mutualchap Default none User C User name for chap and mutual chap authentication type Chap C Server Target Chap secret for chap and mutual chap authentication type MutualChap C Initiator Host MutualChap secret for mutual chap authentication type ResolveBy O How the host should connect to the server Choices address name Default addres...

Страница 36: ...I portal from a host Example iscsicli host removeportal host MySQLServer portal 10 1 11 72 3260 1 assign Assign a LU to a host Parameter Type Description Host R Name of the host Initiator R iSCSI initiator name to remove Parameter Type Description Host R Name of the host Portal R iSCSI portal to add to the host The format is ipaddress port group Parameter Type Description Host R Name of the host P...

Страница 37: ...ost MySQLServer lu LU6 accessmode RWE setauth Change the authentication for the specified host LU R LU to assign to the host AccessMode O Type of access to grant to hosts Choices RO RW RWE Default RWE Parameter Type Description Host R Name of the host LU R LU to unassign from the host Parameter Type Description Host R Name of the host LU R LU to assign to the host AccessMode R Type of access to gr...

Страница 38: ...hMode O Authentication mode used by this host Choices none chap mutualchap Default none Chap C Server Target Chap secret for chap and mutual chap authentication type MutualChap C Initiator Host Mutual Chap secret for mutual chap authentication type Parameter Type Description Host R Name of the host ResolveBy R How the host should connect to the server Choices address name Default address dnsname C...

Страница 39: ...ort a physical device as a new LU Parameter Type Description LU R Name of the new LU Pool or Disk R Pool or Disk to provide storage for the LU Size O Size in MB of the new LU Default available space Host O Host to assign to the LU AccessMode O Type of access to grant to hosts Choices RO RW RWE Default RWE Parameter Type Description LU R Name of the new LU Device R The physical device to import The...

Страница 40: ... lu LU6 rename Rename a LU Example iscsicli lu rename lu LU6 newname MyLU6 expand Expand a LU Example iscsicli lu expand lu LU6 size 4096 AccessMode O Type of access to grant to hosts Choices RO RW RWE Default RWE Parameter Type Description LU R Name of the LU Parameter Type Description LU R Name of the LU Newname R New name of the LU Parameter Type Description LU R Name of the LU Size R Size in M...

Страница 41: ...ccess mode of a LU for an iSCSI host Example iscsicli lu setaccess lu LU6 host MySQLServer accessmode RO Parameter Type Description LU R Name of the LU Host R Host to assign to the LU AccessMode O Type of access to grant to hosts Choices RO RW RWE Default RWE Parameter Type Description LU R Name of the LU Host R Host to unassign from the LU Parameter Type Description LU R Name of the LU Host R Hos...

Страница 42: ...uration Under the configuration class you can specify the following sub operations backup Backup the configuration data to a file Example iscsicli configuration backup file C MyBackups iscsiserver cfg restore Restore the configuration data from a file Parameter Type Description LU R The LU for which to display the layout Parameter Type Description LU O Name of the LU If none specified all LUs will...

Страница 43: ... local iSNS Server as well as other remote iSNS Servers The operation class name is isns Under the iSNS operational class you can specify the following sub operations setmode Change iSNS settings Example iscsicli isns setmode isnsmode off iscsicli isns setmode isnsmode local iscsicli isns setmode isnsmode remote ip 10 1 11 69 Parameter Type Description File R File to save the xray information Para...

Страница 44: ...ide 42 show Display iSCSI initiators or iSCSI targets listed in the iSNS database or iSNS settings Example iscsicli isns show detail targets Parameter Type Description Detail O Information to display Choices Settings Initiators Default Settings ...

Страница 45: ...cli iscsi add license 12345678 remove Remove a license for a specified module that is installed on the iSCSI Feature Pack Example iscsicli iscsi remove license 12345678 show Show the options installed on the iSCSI Feature Pack Example iscsicli iscsi show detail version Parameter Type Description License R License Keycode Parameter Type Description License R License Keycode Parameter Type Descripti...

Страница 46: ...i 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 Parameter Type Description Portal R iSCSI portal to add The format is ipaddress port group Global O Add the portal to all hosts as well as...

Страница 47: ...wever each initiator can only be associated with a single host Logical Unit LU The basic unit of iSCSI storage a LU is a logically mapped disk device that is created from a physical disk or from a storage pool Physical Disk A single physical hard disk Raw disk A portion of a physical disk The contents of a raw disk are not managed by the operating system and cannot be accessed by users unlike with...

Страница 48: ...5 H host initiators manage 21 hosts create new 19 defined 19 delete 23 introduction 19 properties 23 HP authorized reseller 7 storage web site 7 technical support 7 I initiator defined 45 initiators manage 21 introduction 3 iSCSI storage 9 iSNS 8 configuration 8 iSNS server 21 K keycodes 12 L license 12 logical units 19 assign 17 create 14 delete 18 expand 17 import 15 introduction 14 manage 21 pr...

Страница 49: ...raid set 15 raw disk defined 45 rescan disks 15 21 S server restore configuration 12 save configuration 12 storage pool 15 configuration 9 T technical support HP 7 terminology host 45 iSCSI initiator 45 iSNS 45 logical unit 45 physical disk 45 raw disk 45 storage pool 45 virtual disk 45 W web sites HP storage 7 ...

Отзывы: