Red Hat CloudForms 3.2 NetApp Storage Integration Guide Technology preview feature that enables you to collect NetApp Storage data using CloudForms Management Engine Red Hat CloudForms Documentation Team
Red Hat CloudForms 3.2 NetApp Storage Integration Guide Technology preview feature that enables you to collect NetApp Storage data using CloudForms Management Engine Red Hat CloudForms Documentation Team Red Hat Custo mer Co ntent Services do cs@redhat.co m
Legal Notice Copyright 2015 Red Hat. This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n- ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be remo ved. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other co untries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark o f Oracle and/o r its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/o r o ther co untries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and o ther co untries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack Wo rd Mark and OpenStack Lo go are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity. All o ther trademarks are the pro perty o f their respective o wners. Abstract This guide provides a technology preview of storage and NetApp integration with CloudForms Management Engine. Information and procedures in this book are relevant to CloudForms Management Engine administrato rs.
1
Net App St orage Int egrat ion G uide 1. Int roduct ion 1.1. T echnology Preview Technology preview features provide early access to upcoming product innovations, enabling you to test functionality and provide feedback during the development process. However, these features are not fully supported under Subscription Level Agreements, may not be functionally complete, and are not intended for production use. As Red Hat considers making future iterations of technology preview features generally available, we will attempt to resolve any issues that customers experience when using these features. D uring the development of a technology preview feature, additional components may become available to the public for testing. Because technology preview features are still under development, Red Hat cannot guarantee the stability of such features. As a result, if you are using technology preview features, you may not be able to seamlessly upgrade to subsequent releases of that feature. While Red Hat intends to fully support technology preview features in future releases, we may discover that a feature does not meet the standards for enterprise viability. If this happens, we cannot guarantee that technology preview features will be released in a supported manner. Some technology preview features may only be available for specific hardware architectures. 1.2. T erminology The following terms are used throughout this document. Filer LUN A Filer is a set of hardware, software, and disks specifically designed to provide fast and reliable storage. The Filer page shows all of the systems detected by the connected storage managers. Click on a Filer from the list to see a summary view of its properties, relationships, and tags. A storage volume is a set of disks connected to a storage system. The LUNs page shows all of the volumes detected by the connected SMI-S agents. Click on a storage volume in the list view to see a summary view of its properties, relationships, and tags. File Share A File Share is an accessible directory location on a disk. The File Share page shows all of the volumes detected by the connected SMI-S agents. Click on a File Share in the list view to see a summary view of its properties, relationships, and tags. Volume A Volume is an area of usable storage capacity on one or more physical disks. The Volumes page shows all of the Volumes detected by the connected Storage Manager. Click on a Volume in the list view to see a summary view of its properties, relationships, and tags. Click on the above items in the list view to see a summary view of the properties, relationships and tags. P ro perti es includes the vendor details, operational status, and health status as reported by the agent. Possible operational statuses are Starting, Stopping, Stopped, In Service, No Contact, and OK. Health status describes the health of the storage system itself, but not necessarily that of the components of the system. 2
2. Inst allat ion R el ati o nshi ps shows the Filers, LUNs, File Shares, Local File Systems, and Volumes associated with the storage system. You can click on the items to directly view each of these relationships. Infrastructure R el ati o nshi ps contains clickable links to the parts of your virtual infrastructure associated with the storage system. Smart Manag ement shows the tags that have been assigned using the CloudForms Management Engine Server. 1.3. Requirement s To connect a CFME server to the inventory storage manager, you need to: Install the NetApp SDK Enable Storage features and the Storage Inventory Server Role Connect the Server to the Storage Manager To connect the server to the Storage Manager, you need the host name, IP address, port, and credentials for the agent. You must have an account role with the proper access to modify server roles. In addition, since this is a technology preview feature it is not automatically viewable in the CloudForms Management Engine Console. To see it, edit the main configuration file. 2. Inst allat ion 2.1. Inst alling t he Net App SDK The procedure describes the steps to install the NetApp SD K. Procedure 1. To Install the NetApp SDK 1. From the NetApp site, download the SD K to /var/www/miq/vmdb/lib. The file name is in the format netapp-manag eabi l i ty-sd k-abc. 0 P xyz. zi p. You need to be a NetApp customer to obtain this file. 2. Unzip the file by logging into an SSH session on the appliance, and type: unzip -d /var/www/miq/vmdb/lib/netapp-manageability-sdk-4.0p1.zip 3. Enter: echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/var/www/miq/vmdb/lib/netappmanageability-sdk-4.0P1/lib/linux-64" /etc/default/evm 4. Restart the CFME service by entering the command: service evmserverd restart 2.2. Enabling St orage Feat ures in CFME 3
Net App St orage Int egrat ion G uide The procedure describes the steps to enable storage features in the CloudForms Management Engine (CFME). Procedure 2. To Enable Storage Features in the CFME 1. Log in to the dashboard. 2. Navigate to Configure Configuration. 3. Click on the Setti ng s accordion, then click Zo nes. 4. Click the Zo ne where the CloudForms Management Engine server is located. 5. In the Servers area, click on the CloudForms Management Engine server. 6. Click Ad vanced tab. 7. From Fi l e, select EVM Server Mai n C o nfi g urati o n. 8. In the EVM Server Mai n C o nfi g urati o n editor, make the following changes while maintaining the exact spacing. product: maindb: ExtManagementSystem storage: true 9. Click Save. 10. Refresh the browser screen to see a label for storage. 2.3. Enabling t he St orage Invent ory Server Roles The procedure describes the steps to enable storage inventory server roles. Procedure 3. To Enable the Storage Inventory Server Roles 1. Log in to the dashboard. 2. Navigate to Configure Configuration. 3. Click on the Setti ng s accordion, then click Zo nes. 4. Click the zone where the CloudForms Management Engine server is located. 5. From the Server page, go to Server C o ntro l. 6. From the list of Server R o l es, select Storage Inventory. To collect Capacity and Utilization data, select the appropriate Storage Capacity and Utiliz ation Roles as well. See Settings and Operations Guide for more information. 7. Click Save. 2.4. Adding a St orage Manager The procedure describes the steps to add a storage manager. Procedure 4. To Add a Storage Manager 4
3. Working wit h St orage 1. Navigate to Storage Storage Manager. Click C o nfi g urati o n. 2. Click Ad d a New Sto rag e Manag er. 3. Type in a descriptive name for the Sto rag e Manag er. 4. Type in the Ho st Name, IP Ad d ress, and P o rt of the agent. Select the Type. If using more than one zone, select which zone you want this agent assigned. 5. Type in a User ID and P asswo rd for the agent. 6. Click Val i d ate to confirm that the user and password connects. 7. Click Save. 3. Working wit h St orage 3.1. Assigning T ags t o St orage It ems Use tags to describe your storage items based on your enterprise needs. For example, you can categorize by geographic location or function. Create the required user and company tags under C o nfi g urati o n, and specify them under each resource. See CloudForms Management Engine Settings and Operations Guide for more information. Procedure 5. To Assign Tags to Storage Items 1. From Sto rag e, navigate to the page of items, such as Fi l e Shares that you want to tag. 2. Check the specific instances of the type of item you want to tag. 3. Click (P o l i cy), and then (Ed i t T ag s). 4. Select a customer tag from the first dropdown, and then a value for the tag. 5. Select more tags or click Save to save your changes. 3.2. Viewing Ut ilizat ion Dat a As soon as you connect to a storage agent, the server collects data on the utilization of Filers, LUNs, and Volumes. You can view this data directly from the console from the appropriate storage page. Procedure 6. To View Utiliz ation Data 1. From Sto rag e, click the Fi l ers, LUNs, or Vo l umes page. 2. Click the item that you want to view the data for. 3. Click Mo ni to ri ng, and then Uti l i zati o n on the task bar. 3.3. St orage Dat a Collect ed Statistic Description Volum es Base Extent s Read (KBps) Kilobytes read per second (Throughput) LUNs 5
Net App St orage Int egrat ion G uide Statistic Description Volum es Written (KBps) Kilobytes written per second (Throughput) Transferred (KBps) Read (IOPS) Read Hit (IOPS) Write (IOPS) Write Hit (IOPS) Total (IOPS) Total amount of data transferred in kilobytes percentage of read requests satisfied by cache (Throughput) Total number of Read I/Os per second (Throughput) Total number of Read I/Os per second satisfied by Cache (Cache) Total number of Write I/Os per second (Throughput) Total number of Write I/Os per second satisfied by Cache (Cache) Total of Read I/Os and Write I/Os per second (Throughput) Average Read Size Average size of read requests in kilobytes Average Write Size Average size of write requests in kilobytes Read % Write % Hit % Utilization % Response Time (Seconds) Queue Depth Service Time (Seconds) Wait Time (Seconds) Percentage of time that the selected storage device is busy servicing read requests Percentage of time that the selected storage device is busy servicing write requests Percentage of read requests satisfied by cache Percentage of time that the storage device was processing requests Time in seconds that it takes to service a request (D uration) Average depth of queue over the time interval (D uration) Refers to the amount of time required to service I/O requests (D uration) In seconds, the time a storage device is either idle or blocked by an event (D uration) Base Extent s LUNs 6
A. Revision Hist ory A. Revision Hist ory Revision 1.0-1 Wed 25 Feb 2015 Red Hat CloudForms Docs Team Initial creation for Red Hat CloudForms 3.2. 7