NetApp plugin for Fuel Documentation

Transcription

1 NetApp plugin for Fuel Documentation Release Mirantis Inc. July 20, 2016

2 CONTENTS 1 NetApp plugin Features Requirements Prerequisites Release Notes Limitations Installing NetApp plugin 4 3 Configuring NetApp plugin 5 4 Utilization Usage Verification Troubleshooting Licenses 17 6 Appendix 18 i

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

4 CHAPTER ONE NETAPP PLUGIN The plugin provides support of Clustered Data ONTAP, Data ONTAP 7-Mode and E-series storage clusters to Cinder. The 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 Clustered Data ONTAP as a backend for Cinder with NFS or iscsi data-transfer protocols Data ONTAP 7-Mode as a backend for Cinder with NFS or iscsi data-transfer protocols E-Series or EF-Series as a backend for Cinder with iscsi data-transfer protocol Supports Cinder multibackend Supports all configuration options of NetApp Cinder driver for Mitaka 1.2 Requirements Requirement Version/Comment Fuel 9.0 NetApp Storage System Clustered ONTAP Data Data ONTAP 7-Mode E-Series or EF-Series 1.3 Prerequisites If you plan to use the plugin with Data ONTAP 7-Mode or Clustered ONTAP Data, 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 or EF-Series, please make sure that it is configured, up and running. For instructions, see the official NetApp E-Series documentation. 2

5 1.4 Release Notes Added MOS 9.0 support Removed code related to MOS backends Added MOS LCM support (Experimental) 1.5 Limitations 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 MOS LCM support is in experimental mode 1.4. Release Notes 3

6 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

7 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. Choose storage family and storage protocol. Several options are available. If you plan to use Clustered Data mode through NFS, click Clustered Data ONTAP radio button 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: Username Password NetApp Storage Hostname/IP 5

8 CDOT Data LIF IP address CDOT FlexVol volume junction path Storage Virtual Machine 6

9 7

10 If you plan to use Clustered Data mode through iscsi, click Clustered Data ONTAP 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: Username Password NetApp Storage Hostname/IP Storage Virtual Machine 8

11 If you plan to use 7-Mode through NFS, click Data ONTAP 7-Mode 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: Username Password 9

12 NetApp Storage Hostname/IP CDOT Data LIF IP address CDOT FlexVol volume junction path 10

13 If you plan to use 7-Mode through iscsi, click Data ONTAP 7-Mode radiobutton and select iscsi option in NetApp Storage Protocol. You should also choose NetApp transport type (http or https). Specify the 11

14 following parameters in the text fields: Username Password NetApp Storage Hostname/IP 12

15 If you plan to use E-Series or EF-Series, click E-Series/EF-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 parameters in the text fields: Username Password NetApp Storage Hostname/IP Controller IPs Storage Array Password 13

16 5. Using Nodes tab, add nodes and assign roles to them. 6. 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. 14

17 packages: &packages - "nfs-common - "open-iscsi" - "multipath-tools" 7. Press Deploy button once you are done with environment configuration. 8. When the deployment is done, you may perform functional testing. You can find instructions in NetApp Mirantis Unlocked Reference Architecture, paragraph 8.3. Note: Only if using Ceph. Do not be confused by error when removing Ceph OSD node. For details see Fuel bug. 15

18 CHAPTER FOUR UTILIZATION 4.1 Usage 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 16

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

20 CHAPTER SIX APPENDIX 1. Data ONTAP documentation 2. E-Series/EF-Series documentation 18