Host PowerTools User Manual

Transcription

1 Host PowerTools User Manual

2 Introduction to Host PowerTools What is INFINIDAT Host PowerTools Installing Host PowerTools Host PowerTools installation instructions Provisioning storage using Host PowerTools Administrative provisioning tasks Allocating storage resources to the host Mounting the volume Provisioning volumes using Host PowerTools Viewing the volumes Operating Host PowerTools via the GUI Accessing the Host PowerTools GUI Getting the Windows host ready Provisioning volumes from the Host PowerTools GUI Setting up iscsi via the Host PowerTools GUI Operating Host PowerTools via the CLI Connecting Host PowerTools to an InfiniBox Invoking infinihost

3 Introduction to Host PowerTools What is INFINIDAT Host PowerTools INFINIDAT Host PowerTools TM is an application that provides the host administrators with provisioning capabilities by assisting and easing the process of provisioning volumes. INFINIDAT encourages a close cooperation between the storage administrator and application administrators. According to this vision, the storage administrator maintains an overall control over the storage environment, and sets policies to be followed by all of the applications. Application administrators are granted with the autonomy to provision storage and to operate within the policies set by the storage administrator. This approach enables InfiniBox to intelligently automate most of the processes, and to monitor the administrator actions so as to prevent mistakes that can lead to downtime. INFINIDAT strongly encourages organizations to adopt this policy-driven approach which accelerates business processes, but of course customers may also opt out of it. Working in this approach, Host PowerTools offers a read-only mode for the host administrator, where all changes are carried out by the storage team only. Host PowerTools TM is a trademark of INFINIDAT. Terminology InfiniBox Pool Host Volume LUN The INFINIDAT storage system that Host PowerTools connects to. The pool is a logical space that contains volume, snapshot and clones. The pool allocates physical and virtual storage space for these entities. The pool also determines a policy for automatic extension in case of space depletion. A computer system to which the InfiniBox is attached and accessible for data storage and I/O. A set of disk blocks presented to an operating environment as a range of consecutively numbered logical blocks with disk-like storage and I/O semantics. Logical Unit Number. An identifier of the volume. Supported Platforms See an up-to-date list on the INFINIDAT Support website. Installation prerequisites Disk space 2GB RAM - 512MB Download site for the installation package The Host PowerTools installation packages are available from the Repository site. Download instructions are avialable on screen: Go to: On the navigation tree, click on Host PowerTools Select your OS and follow the relevant installation instructions Copyright INFINIDAT LTD , Page 3

4 Note: AIX ODM is now available for download in a separate RPM package. Related documentation InfiniBox documentation is available on the Support site at as follows: InfiniBox and InfiniShell Release Notes and documentation Installing Host PowerTools Host PowerTools installation instructions About this task First-time setup Linux, Solaris Installation instructions Windows Installation instructions About this task INFINIDAT Host PowerTools is available for Linux, Windows, and other environments (See Supported Platforms). The Host PowerTools provide both Command Line Interface and GUI. This page provides instructions for installing Host PowerTools on the following platforms: Linux, Solaris Windows First-time setup Go to the download site: Select the relevant command according to the operating system. Linux, Solaris Installation instructions 2. Click Host PowerTools on the navigation tree of the download site. Select a platform and run the relevant command on your shell. For example: Copyright INFINIDAT LTD , Page 4

5 sudoapt-get install -y host-power-tools IMPORTANT! For Solaris 10 the CSWcurl package should be installed before the Host PowerTools installation. Windows Installation instructions Download the installation package and run it. A wizard opens on screen. Complete the wizard steps. Host PowerTools is installed and is available from the Start menu. Provisioning storage using Host PowerTools Administrative provisioning tasks Metadata sync From the command-line From the GUI Rescan Collecting logs Metadata sync This command synchronizes the host metadata as it is displayed on InfiniBox. From the command-line Run the following command: infinihost metadata sync The output is: Updated metadata in system 1032 for host id hostname = 'prod-linux1' system = 'Linux' platform = 'Linux el6.x86_64-x86_64-with-redhat-6.3-Santiago' powertools_version = '9.2.post1gfa83ee8' From the GUI Right-click the Actions menu and select Sync Metadata from the menu. Rescan This command searches for SCSI storage sub-systems and creates block devices for newly found sub-systems and deletes block devices for LUNs that are no longer accessible. This command does not have an output. Copyright INFINIDAT LTD , Page 5

6 As Linux does not process the capacity change unit attention, you need to unmap, rescan, map, and rescan again. Collecting logs This command creates an archived tar.gz file that includes information that is relevant for troubleshooting. Run the following command: infinihost logs collect The output is: Logs collected successfully to /tmp/infinihost-logs o5z0ah.tar.gz 2. Download the file and send it to INFINIDAT Support. Allocating storage resources to the host About this task Creating a capacity pool on InfiniBox Viewing the pool from the host About this task Allocating storage resources to the host is done by creating a capacity pool and provisioning a volume. You can either map an existing volume, or create a new volume. InfiniBox pools are virtual buckets for organizing storage workload. Every volume, snapshot, and clone resides in a pool. The storage administrator defines each pool s physical capacity (portion of system physical capacity available for writes by the pool) and virtual capacity (soft limit on total size of all volumes in the pool). The storage administrator can update a pool s physical and virtual capacity as well as move volumes between pools at any time. Pool membership is purely metadata and does not affect data placement. Creating a capacity pool on InfiniBox Make sure there is a capacity pool available for you. This section provides brief instructions for creating a pool. More detailed explanation can be found on other InfiniBox publications. For example: Creating a pool. Viewing the pool from the host Go back to the Host PowerTools shell and type: infinihost pool list A list of the InfiniBox pools is displayed on screen: Copyright INFINIDAT LTD , Page 6

7 (Ubuntu 14.04) ~ infinihost pool list :00 System Pool Physical Capacity (GB) Virtual Capacity (GB) Physical Free (GB) Virtual Free (GB) Volumes box-ci05 first box-ci22 pool Mounting the volume Creating a file system for the volume Mounting a volume Unmounting a volume Mapping a volume Unmapping a volume Speed testing the volume Instructions Creating a file system for the volume Select a volume that has no mappings: prod-linux1-vol dm Run: infinihost volume create-filesystem dm-5 The result is: Creating filesystem... OK Mounting a volume Set a mount point to a volume that has a file system. Run the command with the following arguments: Volume name Mount point infinihost volume mount dm-4 /mnt y The output is: Copyright INFINIDAT LTD , Page 7

8 Mounting filesystem... OK Unmounting a volume Disconnect the volume from the file system. Run the command with the following arguments: Volume name infinihost volume unmount dm-4 /mnt y The output is: Volume unmounted Mapping a volume Map a volume that was created on InfiniBox to the host, using Host PowerTools. Run the command with the following arguments: Volume name infinihost volume map vol-1 /mnt y The output is: Volume "vol-1" (id 82255) successfully mapped The volume is visible using infinihost volume list Unmapping a volume Unmap a volume to disconnect it from the host. The volume remains on InfiniBox and can be connected to the host, or to other hosts. This command accepts the device name or the mount point as an input (and does not accept the name of the volume as it is seen on InfiniBox). Run the command with the following arguments: Volume name infinihost volume unmap vol-1 y Copyright INFINIDAT LTD , Page 8

9 The output is: Volume "vol-1" (id 82255) successfully unmapped Speed testing the volume The output of the command specifies: Performance test results: Path # HCTL an identifier of the host, channel, target and LUN Initiator WWN Target WWN NodeID PortID Average throughput and average IOPS: Instructions Run: infinihost volume speedtest dm-4 --duration=20 The output is: Running performance test on /dev/mapper/mpathbm Device paths: Path # HCTL Initiator WWN Target WWN NodeID PortID Path #1 2:0:2: c9b b0f Path #2 2:0:3: c9b b0f Path #3 2:0:4: c9b b0f Path #4 2:0:5: c9b b0f Path #5 2:0:6: c9b b0f Path #6 2:0:7: c9b b0f Copyright INFINIDAT LTD , Page 9

10 Path #7 2:0:8: c9b b0f Path #8 2:0:9: c9b b0f Path #9 2:0:10: c9b b0f Path #10 2:0:11: c9b b0f Path #11 2:0:12: c9b b0f Path #12 2:0:13: c9b b0f Setting up... Running for 20 seconds Average Throughput Average IOPS (0.5*MiB) Total 1525*MB/s 2910 Path #1 137*MB/s 167 Path #2 137*MB/s 167 Path #3 139*MB/s 169 Path #4 139*MB/s 170 Path #5 139*MB/s 170 Path #6 138*MB/s 170 Path #7 140*MB/s 170 Path #8 138*MB/s 170 Path #9 137*MB/s 167 Path #10 137*MB/s 167 Copyright INFINIDAT LTD , Page 10

11 Path #11 137*MB/s 167 Path #12 137*MB/s 167 Copyright INFINIDAT LTD , Page 11

12 Average throughput is % of wire speed (8*Gib) Paths are balanced Provisioning volumes using Host PowerTools About this task Command syntax Previewing the command prior to execution Example Output Notes: Running the command with using the Yes flag Syntax Output No filesystem and no mount Syntax Output About this task Provisioning of storage space for a volume within a pool is done via determining the following attributes: Size the size of the volume. For example, 10TB, 10GB. The minimal size is 1GB. This attribute is mandatory. Name the name of the volume as will be seen on the InfiniBox GUI and InfiniShell. This attribute is optional. Flie system the file system that the volume will be mapped to. If this argument is not used, the file system name will be created by INFINIHOST. Mount - an existing directory on which to mount the file system. If this argument is not used, the mount point will be selected by InfiniHost. Thin the volume can be set to be thin provisioned. Pool the pool that the volume belongs to. System the InfiniBox system on which the volume is created. You don t have to specify this argument if the host is connected to a single system only. No file system use this argument to avoid creating a file system for this volume. No mount use this parameter to avoid mounting this parameter. Yes specifies whether to run the command without a preview. See below. Command syntax Copyright INFINIDAT LTD , Page 12

13 infinihost volume provision <size> [--yes] [--name=name] [--filesystem=fs] [--mount=path] [--thin=thin] [--pool=pool] [--system=system] [--no-filesystem] [--no-mount] Previewing the command prior to execution Example infinihost volume provision 10GB --pool=rest-pool Output This tool is going to: * Create a thin 10 GB volume "prod-linux1-vol " of on InfiniBox * Map this volume to this host on the next available LUN. * Create an ext3 filesystem on this volume. * Mount this volume to /mnt/prod-linux1-vol * Give this volume the label prod-linux1-vol-. If this is absolutely what you want, pass the --yes flag in the command-line. aborting. Notes: The InfiniBox that is mentioned on the output is the only InfiniBox that is connected to the host, hence it was not mentioned on the command. The filesystem and mount point were selected by InfiniHost. Running the command with using the Yes flag Syntax infinihost volume provision 10GB --pool=rest-pool y Copyright INFINIDAT LTD , Page 13

14 Output Creating the new 10 GB volume "prod-linux1-vol "... OK Waiting for volume discovery, this might take a while... OK Creating filesystem... OK Mounting filesystem... OK ==================================================================== All done. The volume prod-linux1-vol is represented by dm-2, and it is mounted to /mnt/prod-linux1-vol No filesystem and no mount Syntax infinihost volume provision 10GB --pool=rest-pool --no-filesystem --no-mount y Output Creating the new 10 GB volume "prod-linux1-vol "... OK Waiting for volume discovery, this might take a while... OK ==================================================================== All done. The volume prod-linux1-vol is represented by dm-4. Viewing the volumes About this task Viewing the volumes from Host PowerTools Example Output Viewing the volumes from InfiniBox InfiniBox GUI and CLI instructions About this task The volume list command displays the following volume attributes: Name the name of the volume as displayed on InfiniBox Device the name of the volume as displayed on InfiniHost Mount the file that is associated with the volume Size the size of the volume # Paths the number of paths that connect the InfiniHost to the volume on InfiniBox Copyright INFINIDAT LTD , Page 14

15 LUN the way InfiniHost identifies the volume Viewing the volumes from Host PowerTools Example infinihost volume list Output System (serial=1032, name=ibox032): Name Device Mount Size(GB) # Paths LUN (Controller) * 0 vol-1336 dm-2 /mnt/vol vol-1357 dm vol-1400 dm vol-1401 dm * Non-multipathed Viewing the volumes from InfiniBox The volumes that were provisioned by InfiniHost are also visible from the InfiniBox Management Console (both GUI and InfiniShell). InfiniBox Management Console displays information in addition to what is displayed on InfiniHost. For example: Thin indicates whether the volume is thin provisioned. The default is Yes. Write protect upon creation, the volume is write-enabled. However, it is possible to protect it from writing. This operation is available from the GUI and InfiniShell. SSD Cache indicates whether the volume uses SSD drives. This attribute is inherited from the pool and can be set per volume. InfiniBox GUI and CLI instructions Instructions for operating the InfiniBox GUI and CLI are available on the Support site. Operating Host PowerTools via the GUI Accessing the Host PowerTools GUI GUI availability Accessing the GUI Windows Linux GUI availability Host PowerTools GUI available for: Linux Windows VMware - see: Host PowerTools for VMware Copyright INFINIDAT LTD , Page 15

16 Accessing the GUI Windows Run the Host PowerTools from the Start menu. The Host PowerTools main screen opens. In this screenshot we see that the Host PowerTools is connected to an InfiniBox system. At the top of the screen there is a reminder for getting the host ready. Linux The GUI is web-based. Accessing the GUI is carried out from the command line. Run: infinihost-gui Copyright INFINIDAT LTD , Page 16

17 For example: In a computer that has a browser, The GUI opens. In a computer that does not have a browser the command returns a URL that can be copied to a computer that does have a browser. > infinihost-gui GUI page is available in the following URL: afed-be9f85b71918 Getting the Windows host ready Instructions Checking for host readiness whenever the host is connected to a new InfiniBox Instructions 2. Click the Prepare button. The Host Readiness screen opens. Click Start to run the readiness check and displays the outcome on screen. a. Click Check to close the screen without fixing the issues Copyright INFINIDAT LTD , Page 17

18 Note: b. Click Fix to allow Host PowerTools to automatically fix all of the issues You need to repeat this task whenever you connect the host to a new InfiniBox. See more details below. 3. For provisioning tasks, see: Accessing the Host PowerTools GUI. If other vendors multipath software is installed on the host, a warning message or a pop-up might appear during Host Readiness execution. Installation of new multipath configuration rules (claiming rules) on Windows platform can cause a short removal and re-adding devices path which does not impact or disrupt applications. Other vendor multipathing software might detect this short path removal and alert in the form of a warning message or a pop-up, these warning can safely be ignored. Checking for host readiness whenever the host is connected to a new InfiniBox In the following cases: Do this: Whenever you connect the host to a new InfiniBox system, you need to verify that the host is ready to work with it. Whenever you convert a host between FC and iscsi (or vice versa) Select Host readiness from the Setting menu at the top-right of the screen. Provisioning volumes from the Host PowerTools GUI Provisioning a volume Viewing the volumes Volume actions Running a performance test Mapping a volume Provisioning a volume Select a system and click the cog wheel. Click New. The Create Volume screen opens, displaying the system's volumes. Copyright INFINIDAT LTD , Page 18

19 The Volume Name is provided by the Host PowerTools. a. Set: i. The volume size. ii. The pool. iii. Note the capacity indicator. It displays the relevant information for every pool that is selected from the drop-down menu. iv. Check whether to create a file system. v. Select the file system type. vi. Check whether to mount the file system. vii. Select a mount path. b. Click Continue. An informative message that specifies the volume s details is displayed on screen. a. Click Start. The volume is created. Click Done. The volume is available on the Volumes screen. Viewing the volumes The InfiniHost web GUI displays the InfiniBox systems that the host is connected to. Click the cog wheel to see a list of volumes that are mapped to the host. Volume actions The available actions for each volume are listed under Actions at the right side of the Volumes table. A description of each of the actions is available on previous chapters of this guide: See Provisioning storage using Host PowerTools Copyright INFINIDAT LTD , Page 19

20 Running a performance test 2. Select Performance Test from the Actions menu of a volume. The Performance window opens. Click Start. The performance test takes place. 3. The test results are displayed on screen. Click Close. Mapping a volume Select a system and click the cog wheel. Click Map. Map Volume screen opens, displaying the system's volumes. Select a volume, using either of the following methods: Search Browse Select whether to include clones Click Done. The volume is mapped and is visible on the Volumes table. Setting up iscsi via the Host PowerTools GUI About this task Setting up an iscsi service on InfiniBox: Connecting to InfiniBox via iscsi About this task The hosts are connected to InfiniBox either via FC or iscsi. When they are connected via FC, Host PowerTools automatically identifies the connections. When the hosts are connected to InfiniBox using iscsi, the Host PowerTools needs to set up this connection type. Setting up an iscsi service on InfiniBox: See InfiniBox best practices for setting up services on the InfiniBox best practices page Copyright INFINIDAT LTD , Page 20

21 Connecting to InfiniBox via iscsi On Host PowerTools main screen, set the protocol type to iscsi on the slider at the top-right of the screen From the menu at the top-right of the screen, select Check Host Readiness. This may require a restart of the host. Once the system passes the host readiness successfully, open the same menu, select Connect to iscsi system. The Connect to iscsi system screen opens. 4. Type the name of the InfiniBox system. Click Continue. 5. On the Authentication Required screen, enter the InfiniBox user and password. Check whether to remember these credentials and whether to use the credentials for all connected InfiniBox systems. Click OK. You are returned to the Connect to iscsi system screen. 6. S elect an iscsi network space from the drop-down list. Select an authentication method. Host PowerTools negotiates the user and secret with InfiniBox. Click Continue. You are returned to the Host PowerTools main screen. 7. The InfiniBox system is visible on the screen. You can now start working with the InfiniBox system (provision, backup, restore, map, etc.). Operating Host PowerTools via the CLI Connecting Host PowerTools to an InfiniBox Copyright INFINIDAT LTD , Page 21

22 Settings check Registering a system (Zoning) Setting the credentials Viewing the credentials Setting the communication protocol Checking the settings Troubleshooting connectivity warnings Available infinihost settings check parameters CHAP settings Settings check Run:. Setting check auto-fix 2. Fix what needs to be fixed. At the end, the result should be: This host is ready to work with the InfiniBox Registering a system (Zoning) 2. Connect your server to an InfiniBox. Run the following command to register the InfiniBox: infinihost system register The command output specifies the details of the connectivity: Created host 'prod-linux1' Registered initiator ports [ c9b07494] in host 'prod-linux1' on system 1032 (ibox032) Updated metadata in system 1032 for host id hostname = 'prod-linux1' system = 'Linux' platform = 'Linux el6.x86_64-x86_64-with-redhat-6.3-Santiago' powertools_version = '9.2.post1gfa83ee8' 3. Verify that the InfiniBox is viewed by the host: infinihost system list The result is: Copyright INFINIDAT LTD , Page 22

23 The result is: Serial System Name Registered as Part of cluster System Version 1032 ibox032 Prod-Lab-Linux Setting the credentials Set the credentials that will be associated with Host PowerTools operations on InfiniBox. Run the command with the following arguments: System name User Password To set the credentials: Run the command: infinihost credentials set --system=ibox032 host-powertools <password> The result is: Credentials for user host-powertools were saved Viewing the credentials The credentials that you are using for connecting to InfiniBox are visible on the screen. Run the command: infinihost credentials get The result is: InfiniBox Serial Username 1032 host-powertools admin * infinidat admin Setting the communication protocol This command sets the host to connect to InfiniBox via either FC or iscsi. Connecting to InfiniBox using the iscsi protocol requires that the InfiniBox has an iscsi network space. Set the protocol: Copyright INFINIDAT LTD , Page 23

24 infinihost protocol set (iscsi fc) 2. For iscsi, run the following command: infinihost iscsi connect <management-ip> [--host-name=<host-name>] [--net-space=<net-space>] Host PowerTools looks for InfiniBox iscsi network spaces. If no iscsi network space exists, the command fails. Checking the settings Following the installation, and from time to time, you can check whether the Host PowerTools installation and InfiniBox connectivity are OK. This command returns warnings with links to INFINIDAT knowledge base articles that provide more details and measures to fix the issue. Run the command: infinihost settings check Troubleshooting connectivity warnings In case that there is an issue, the result is: Warning Connectivity: Checking that each InfiniBox is connected through more than one initiator REASON: WARNING: The host is connected to InfiniBox ibox032 (1032) through only one initiator: c9b07494 INFO: For more information, see ( (warnings=1) This host is ready to work with the InfiniBox The host is ready to work with InfiniBox. Nevertheless, to resolve the warning, you may want to click the link and view the knowledge base article. Available infinihost settings check parameters The infinihost settings check command accepts the following parameters: --fix this option fixes the reported issue, pending the user confirmation --auto-fix this options fixes the reported issue --with-qr-codes this option provides a QR code on screen. You can use your smartphone s QR reader (available for free) to open the knowledge base article. CHAP settings The host-side CHAP attributes are available via the iscsi.conf file that is available on: Copyright INFINIDAT LTD , Page 24

25 /etc/iscsi Invoking infinihost Displaying the InfiniHost available commands OS-specifics Filesystem support iscsi iscsi CHAP OpenStack Displaying the InfiniHost available commands To invoke on-line help on the available commands, type: infinihost The help is displayed on the screen. Each of the options is displayed further along this document. Copyright INFINIDAT LTD , Page 25

26 Usage: infinihost settings check [(--fix --auto-fix)] [--with-qr-codes] infinihost system list infinihost system register [(--fix --auto-fix)] [--hostname=hostname] [--system=system] infinihost connectivity list [--json] infinihost pool list [--units=units] [--rescan] [--system=system] infinihost volume list [(--summary --detailed --json)] [--units=units] [--rescan] infinihost volume provision <size> [--yes] [--name=name] [--filesystem=fs] [--mount=path] [--thin=thin] [--pool=pool] [--system=system] [--lun=lun] [--no-filesystem] [--no-mount] infinihost volume resize <device-or-mount> <size> [--expand-by] [--yes] infinihost volume create-filesystem <device> [--filesystem=fs] infinihost volume mount <device> [<mount-path>] [--allow-read-only] infinihost volume unmount <device-or-mount> [--yes] infinihost volume unmap <device-or-mount> [--yes] infinihost volume map <volume> [--system=system] [--yes] infinihost volume rename <device-or-mount> <name> infinihost volume speedtest <device-or-mount> [--duration=time] infinihost protocol set (iscsi fc) infinihost protocol get infinihost iscsi connect <management-ip> [--netspace=netspace] [--hostname=hostname] [--security=security] [(--fix --auto-fix)] infinihost iscsi disconnect --system=system infinihost metadata sync infinihost rescan infinihost logs collect [(--interactive --only-infinihost-logs)] [--file=file] [--timestamp=datetime] [--span=time] infinihost credentials set [--system=system] [<username> [<password>]] infinihost credentials get infinihost credentials delete OS-specifics Filesystem support The following commands are not available on Solaris (10 & 11), AIX, Veritas and OpenStack: infinihost volume create-filesystem infinihost volume mount infinihost volume unmount Also, infinihost volume provision doesn't support the flags: --filesystem, --no-filesystem, --mount, --no-mo unt iscsi The following commands are not available on Solaris 10, AIX and OpenStack: infinihost protocol set infinihost protocol get infinihost iscsi connect infinihost iscsi disconnect Copyright INFINIDAT LTD , Page 26

27 iscsi CHAP CHAP security is not available on Solaris 11: infinihost iscsi connect only supports --security=none OpenStack in addition to iscsi connections and filesystem supports, on OpenStack we disable most volume operations (provision, map, unmap, resize, rename, speedtest) and also " metadata sync" and " system register". The OpenStack Cinder service is responsible for these operations. Copyright INFINIDAT LTD , Page 27