Deployment Guide Deployment Guide SUSE Enterprise Storage 6 by Tomáš Bažant, Alexandra Settle, Liam Proven, and Sven Seeberg
Total Page:16
File Type:pdf, Size:1020Kb
SUSE Enterprise Storage 6 Deployment Guide Deployment Guide SUSE Enterprise Storage 6 by Tomáš Bažant, Alexandra Settle, Liam Proven, and Sven Seeberg Publication Date: 07/04/2021 SUSE LLC 1800 South Novell Place Provo, UT 84606 USA https://documentation.suse.com Copyright © 2021 SUSE LLC Copyright © 2016, RedHat, Inc, and contributors. The text of and illustrations in this document are licensed under a Creative Commons Attribution- Share Alike 4.0 International ("CC-BY-SA"). An explanation of CC-BY-SA is available at http:// creativecommons.org/licenses/by-sa/4.0/legalcode . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Innity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux® is the registered trademark of Linus Torvalds in the United States and other countries. Java® is a registered trademark of Oracle and/or its aliates. XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. All other trademarks are the property of their respective owners. For SUSE trademarks, see http://www.suse.com/company/legal/ . All other third-party trademarks are the property of their respective owners. Trademark symbols (®, ™ etc.) denote trademarks of SUSE and its aliates. Asterisks (*) denote third-party trademarks. All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither SUSE LLC, its aliates, the authors nor the translators shall be held liable for possible errors or the consequences thereof. Contents About This Guide x 1 Available Documentation x 2 Feedback xi 3 Documentation Conventions xi 4 About the Making of This Manual xii 5 Ceph Contributors xii I SUSE ENTERPRISE STORAGE 1 1 SUSE Enterprise Storage 6 and Ceph 2 1.1 Ceph Features 2 1.2 Core Components 3 RADOS 3 • CRUSH 4 • Ceph Nodes and Daemons 5 1.3 Storage Structure 6 Pool 6 • Placement Group 7 • Example 7 1.4 BlueStore 8 1.5 Additional Information 10 2 Hardware Requirements and Recommendations 11 2.1 Network Overview 11 Network Recommendations 12 2.2 Multiple Architecture Configurations 14 2.3 Hardware Configuration 15 Minimum Cluster Configuration 15 • Recommended Production Cluster Configuration 17 iv Deployment Guide 2.4 Object Storage Nodes 18 Minimum Requirements 18 • Minimum Disk Size 19 • Recommended Size for the BlueStore's WAL and DB Device 19 • Using SSD for OSD Journals 19 • Maximum Recommended Number of Disks 20 2.5 Monitor Nodes 20 2.6 Object Gateway Nodes 21 2.7 Metadata Server Nodes 21 2.8 Admin Node 21 2.9 iSCSI Nodes 22 2.10 SUSE Enterprise Storage 6 and Other SUSE Products 22 SUSE Manager 22 2.11 Naming Limitations 22 2.12 OSD and Monitor Sharing One Server 22 3 Admin Node HA Setup 24 3.1 Outline of the HA Cluster for Admin Node 24 3.2 Building a HA Cluster with Admin Node 25 4 User Privileges and Command Prompts 27 4.1 Salt/DeepSea Related Commands 27 4.2 Ceph Related Commands 27 4.3 General Linux Commands 28 4.4 Additional Information 28 II CLUSTER DEPLOYMENT AND UPGRADE 29 5 Deploying with DeepSea/Salt 30 5.1 Read the Release Notes 30 v Deployment Guide 5.2 Introduction to DeepSea 31 Organization and Important Locations 32 • Targeting the Minions 33 5.3 Cluster Deployment 35 5.4 DeepSea CLI 45 DeepSea CLI: Monitor Mode 46 • DeepSea CLI: Stand-alone Mode 46 5.5 Configuration and Customization 48 The policy.cfg File 48 • DriveGroups 53 • Adjusting ceph.conf with Custom Settings 63 6 Upgrading from Previous Releases 64 6.1 General Considerations 64 6.2 Steps to Take before Upgrading the First Node 65 Read the Release Notes 65 • Verify Your Password 65 • Verify the Previous Upgrade 65 • Upgrade Old RBD Kernel Clients 67 • Adjust AppArmor 67 • Verify MDS Names 67 • Consolidate Scrub-related Configuration 68 • Back Up Cluster Data 69 • Migrate from ntpd to chronyd 69 • Patch Cluster Prior to Upgrade 71 • Verify the Current Environment 73 • Check the Cluster's State 74 • Migrate OSDs to BlueStore 75 6.3 Order in Which Nodes Must Be Upgraded 77 6.4 Oine Upgrade of CTDB Clusters 77 6.5 Per-Node Upgrade Instructions 78 Manual Node Upgrade Using the Installer DVD 79 • Node Upgrade Using the SUSE Distribution Migration System 81 6.6 Upgrade the Admin Node 83 6.7 Upgrade Ceph Monitor/Ceph Manager Nodes 84 6.8 Upgrade Metadata Servers 84 6.9 Upgrade Ceph OSDs 86 6.10 Upgrade Gateway Nodes 89 vi Deployment Guide 6.11 Steps to Take after the Last Node Has Been Upgraded 91 Update Ceph Monitor Setting 91 • Disable Insecure Clients 92 • Enable the Telemetry Module 92 6.12 Update policy.cfg and Deploy Ceph Dashboard Using DeepSea 93 6.13 Migration from Profile-based Deployments to DriveGroups 95 Analyze the Current Layout 95 • Create DriveGroups Matching the Current Layout 96 • OSD Deployment 97 • More Complex Setups 97 7 Customizing the Default Configuration 98 7.1 Using Customized Configuration Files 98 Disabling a Deployment Step 98 • Replacing a Deployment Step 99 • Modifying a Deployment Step 100 • Modifying a Deployment Stage 101 • Updates and Reboots during Stage 0 103 7.2 Modifying Discovered Configuration 104 Enabling IPv6 for Ceph Cluster Deployment 106 III INSTALLATION OF ADDITIONAL SERVICES 108 8 Installation of Services to Access your Data 109 9 Ceph Object Gateway 110 9.1 Object Gateway Manual Installation 110 Object Gateway Configuration 111 10 Installation of iSCSI Gateway 117 10.1 iSCSI Block Storage 117 The Linux Kernel iSCSI Target 118 • iSCSI Initiators 118 10.2 General Information about ceph-iscsi 119 10.3 Deployment Considerations 120 vii Deployment Guide 10.4 Installation and Configuration 121 Deploy the iSCSI Gateway to a Ceph Cluster 121 • Create RBD Images 121 • Export RBD Images via iSCSI 122 • Authentication and Access Control 123 • Advanced Settings 125 10.5 Exporting RADOS Block Device Images Using tcmu-runner 128 11 Installation of CephFS 130 11.1 Supported CephFS Scenarios and Guidance 130 11.2 Ceph Metadata Server 131 Adding and Removing a Metadata Server 131 • Configuring a Metadata Server 131 11.3 CephFS 137 Creating CephFS 137 • MDS Cluster Size 138 • MDS Cluster and Updates 139 • File Layouts 140 12 Installation of NFS Ganesha 145 12.1 Preparation 145 General Information 145 • Summary of Requirements 146 12.2 Example Installation 146 12.3 Active-Active Configuration 147 Prerequisites 147 • Configure NFS Ganesha 148 • Populate the Cluster Grace Database 149 • Restart NFS Ganesha Services 150 • Conclusion 150 12.4 More Information 150 IV CLUSTER DEPLOYMENT ON TOP OF SUSE CAAS PLATFORM 4 (TECHNOLOGY PREVIEW) 151 13 SUSE Enterprise Storage 6 on Top of SUSE CaaS Platform 4 Kubernetes Cluster 152 13.1 Considerations 152 13.2 Prerequisites 152 viii Deployment Guide 13.3 Get Rook Manifests 153 13.4 Installation 153 Configuration 153 • Create the Rook Operator 155 • Create the Ceph Cluster 155 13.5 Using Rook as Storage for Kubernetes Workload 156 13.6 Uninstalling Rook 157 A Ceph Maintenance Updates Based on Upstream 'Nautilus' Point Releases 158 Glossary 170 B Documentation Updates 173 B.1 Maintenance update of SUSE Enterprise Storage 6 documentation 173 B.2 June 2019 (Release of SUSE Enterprise Storage 6) 174 ix Deployment Guide About This Guide SUSE Enterprise Storage 6 is an extension to SUSE Linux Enterprise Server 15 SP1. It combines the capabilities of the Ceph (http://ceph.com/ ) storage project with the enterprise engineering and support of SUSE. SUSE Enterprise Storage 6 provides IT organizations with the ability to deploy a distributed storage architecture that can support a number of use cases using commodity hardware platforms. This guide helps you understand the concept of the SUSE Enterprise Storage 6 with the main focus on managing and administrating the Ceph infrastructure. It also demonstrates how to use Ceph with other related solutions, such as OpenStack or KVM. Many chapters in this manual contain links to additional documentation resources. These include additional documentation that is available on the system as well as documentation available on the Internet. For an overview of the documentation available for your product and the latest documentation updates, refer to https://documentation.suse.com . 1 Available Documentation The following manuals are available for this product: Book “Administration Guide” The guide describes various administration tasks that are typically performed after the installation. The guide also introduces steps to integrate Ceph with virtualization solutions such as libvirt , Xen, or KVM, and ways to access objects stored in the cluster via iSCSI and RADOS gateways. Deployment Guide Guides you through the installation steps of the Ceph cluster and all services related to Ceph. The guide also illustrates a basic Ceph cluster structure and provides you with related terminology. HTML versions of the product manuals can be found in the installed system under /usr/share/ doc/manual . Find the latest documentation updates at https://documentation.suse.com where you can download the manuals for your product in multiple formats. x Available Documentation SES 6 2 Feedback Several feedback channels are available: Bugs and Enhancement Requests For services and support options available for your product, refer to http://www.suse.com/ support/ . To report bugs for a product component, log in to the Novell Customer Center from http:// www.suse.com/support/ and select My Support Service Request. User Comments We want to hear your comments and suggestions for this manual and the other documentation included with this product.