NetApp plugin for Fuel Documentation

Transcription

1 NetApp plugin for Fuel Documentation Release Mirantis Inc. May 17, 2016

2

3 CONTENTS 1 NetApp plugin Features Requirements Prerequisites Release Nodes Limitations Installing NetApp plugin 5 3 Configuring NetApp plugin 7 4 Utilization Using Verification Troubleshooting Licenses 21 6 Appendix 23 i

4 ii

5 This document will guide you through the steps to install, configure and use Cinder NetApp plugin for Fuel. Contents: CONTENTS 1

6 2 CONTENTS

7 CHAPTER ONE NETAPP PLUGIN NetApp plugin provides support of ONTAP and E-series storage clusters to Cinder. NetApp plugin uses NetApp unified driver; the latter is a block storage driver that supports multiple storage families and protocols. A storage family corresponds to storage systems built on different NetApp technologies such as clustered Data ONTAP, Data ONTAP operating in 7-Mode, and E-Series. The storage protocol refers to the protocol used to initiate data storage and access operations on those storage systems like iscsi and NFS. The NetApp unified driver can be configured to provision and manage OpenStack volumes on the given storage family using the specified storage protocol. The OpenStack volumes can then be used for accessing and storing data with the storage protocol on the storage family system. The NetApp unified driver is an extensible interface that can support new storage families and protocols. 1.1 Features ONTAP Clustered Mode as a backend for Cinder with NFS or iscsi data-transfer protocols ONTAP 7 Mode as a backend for Cinder with NFS or iscsi data-transfer protocols E-Series as a backend for Cinder with iscsi data-transfer protocol Multibackend: A supported NetApp storage with any default Cinder backend, either LVM over iscsi or Ceph Supports all NetApp driver options to be configured 1.2 Requirements Requirement Version/Comment Fuel 8.0 ONTAP or E-Series All storage family is supported. 1.3 Prerequisites If you plan to use the plugin with ONTAP, please make sure that it is configured, up and running. For instructions, see the official NetApp ONTAP documentation. If you plan to use the plugin with E-Series, please make sure that it is configured, up and running. For instructions, see the official NetApp E-Series documentation. 3

8 1.4 Release Nodes The plugin has been totally refactored to accordance with changes in OpenStack Liberty and MOS 8.0 All documented features of NetApp Cinder Driver are configurable Plugin can change Cinder settings after deployment with wrong parameters. It requires manual actions 1.5 Limitations Deployment fails if cinder role is not assigned to controller nodes Only one NetApp backend can be configured to work with Cinder Before creating Ubuntu repository s mirrors in Fuel, you have to manually add to /usr/share/fuelmirror/ubuntu.yaml following packages: * nfs-common * open-iscsi * multipath-tools 4 Chapter 1. NetApp plugin

9 CHAPTER TWO INSTALLING NETAPP PLUGIN To install the Cinder Netapp plugin, follow these steps: 1. Download it from the Fuel Plugins Catalog. 2. Copy the plugin s RPM to the Fuel Master node (if you don t have the Fuel Master node, please see the official Mirantis OpenStack documentation): [root@home ~]# scp cinder_netapp noarch.rpm root@fuel-master:/tmp 3. Log into Fuel Master node and install the plugin using the Fuel CLI: [root@fuel-master ~]# fuel plugins --install cinder_netapp noarch.rpm 4. Verify that the plugin is installed correctly: [root@fuel-master ~]# fuel plugins id name version package_version cinder_netapp

10 6 Chapter 2. Installing NetApp plugin

11 CHAPTER THREE CONFIGURING NETAPP PLUGIN Once the Fuel Cinder NetApp plugin has been installed, you can create OpenStack environments that use NetApp storage as a Cinder backend. 1. Create an OpenStack environment using the Fuel UI wizard: 2. Finish environment creation following the instructions. 3. Once the environment is created, open the Settings tab of the Fuel Web UI and then Storage. Scroll down the page. Select the Cinder and NetApp integration checkbox: 4. Configure the plugin.select Multibackend enabled checkbox if you would like NetApp driver to be used as the Cinder Multibackend feature: 5. Choose storage family and storage protocol. Several options are available. If you plan to use ONTAP cluster mode through NFS, click Ontap Cluster radio button and select nfs option in Netapp storage protocol. You should also choose NetApp transport type (http or https). Specify 7

12 the following parameters in the text fields: Netapp username Netapp password Netapp server hostname NFS server NFS share(s) Netapp Vserver 8 Chapter 3. Configuring NetApp plugin

13 9

14 If you plan to use ONTAP cluster mode through iscsi, click Ontap Cluster radiobutton and select iscsi option in Netapp storage protocol. You should also choose NetApp transport type (http or https). Specify the following parameters in the text fields: Netapp username Netapp password Netapp server hostname Netapp Vserver 10 Chapter 3. Configuring NetApp plugin

15 If you plan to use ONTAP 7 mode through NFS, click Ontap 7mode radiobutton and select nfs option in Netapp storage protocol. You should also choose NetApp transport type (http or https). Specify the following parameters in the text fields: Netapp username Netapp password 11

16 Netapp server hostname NFS server NFS share(s) 12 Chapter 3. Configuring NetApp plugin

17 If you plan to use ONTAP 7 mode through iscsi, click Ontap 7mode radiobutton and select iscsi option in Netapp storage protocol. You should also choose NetApp transport type (http or https). Specify the 13

18 following parameters in the text fields: Netapp username Netapp password Netapp server hostname If you plan to use E-series, click E-Series radiobutton and select the only available iscsi option in Netapp storage protocol. You should also choose NetApp transport type (http or https). Specify the following 14 Chapter 3. Configuring NetApp plugin

19 parameters in the text fields: please specify the following parameters: Netapp username Netapp password Netapp server hostname Netapp controller IPs Netapp SA password 15

20 6. Using Nodes tab, add nodes and assign roles to them. Please, note that all controller nodes MUST be configured with Cinder role as well. 7. This step is needed only when local fuel mirrors are used Following packages nfs-common, open-iscsi, multipath-tools aren t included by default when local mirror is created. To have these packages available during deploy you have to add them into /usr/share/fuel-mirror/ubuntu.yaml file in packages: &packages section. 16 Chapter 3. Configuring NetApp plugin

21 packages: &packages - "nfs-common - "open-iscsi" - "multipath-tools" 8. Press Deploy button once you are done with environment configuration. 9. When the deployment is done, you may perform functional testing. You can find instructions in NetApp Mirantis Unlocked Reference Architecture, paragraph

22 18 Chapter 3. Configuring NetApp plugin

23 CHAPTER FOUR UTILIZATION 4.1 Using Since the plugin set up Cinder backend, to operate with plugin functionality you should use Cinder and set type netapp for volumes. 4.2 Verification To perform functional testing you should: Create a volume via Cinder and set type as netapp Attach the volume to any available instance Create a snapshot of this volume Create a volume using the snapshot 4.3 Troubleshooting If anything is not working, first check cinder-volume.log file on Cinder node. It provides most information you need for troubleshooting Enable debug for Cinder when information in log files is not enough When NFS is used, check that nfs shares are mounted and cinder user has ability to write into When iscsi is used, check network connectivity between iscsi ports on NetApp and CinderCompute nodes 19

24 20 Chapter 4. Utilization

25 CHAPTER FIVE LICENSES The plugin does not include any third-party components and is published under Apache 2.0 license. 21

26 22 Chapter 5. Licenses

27 CHAPTER SIX APPENDIX 1. ONTAP documentation 2. E-Series documentation 23