Administration and Deployment Guide

  Administration and Deployment Guide
    SUSE Enterprise Storage
      About SUSE Enterprise Storage
        Introduction
        Additional Information
      System Requirements
        Minimal Recommendations per Storage Node
        Minimal Recommendations per Monitor Node
        Minimal Recommendations for RADOS Gateway Nodes
        Minimal Recommendations for iSCSI Nodes
        Naming Limitations
    Cluster Deployment and Upgrade
      Introduction
      Deploying with DeepSea and Salt
        Introduction to DeepSea
        Deploying with DeepSea and Salt
        Configuration and Customization
      Deploying with ceph-deploy
        Ceph Layout
        Network Recommendations
        Preparing Each Ceph Node
        Cleaning Previous Ceph Environment
        Running ceph-deploy
      Deploying with Crowbar
        Installing and Setting Up the Crowbar Admin Server
        Deploying the Ceph Nodes
      Upgrading from Previous Releases
        General Upgrade Procedure
        Upgrade from SUSE Enterprise Storage 2.1 to 4
        Upgrade from SUSE Enterprise Storage 3 to 4
    Operating a Cluster
      Introduction
      Operating Ceph Services
        Starting, Stopping, and Restarting Services using Targets
        Starting, Stopping, and Restarting Individual Services
        Identifying Individual Services
        Service Status
      Determining Cluster State
        Checking Cluster Health
        Watching a Cluster
        Checking a Cluster’s Usage Stats
        Checking a Cluster’s Status
        Checking OSD Status
        Checking Monitor Status
        Checking Placement Group States
        Using the Admin Socket
      Authentication with cephx
        Authentication Architecture
        Key Management
      Stored Data Management
        Devices
        Buckets
        Rule Sets
        CRUSH Map Manipulation
        Mixed SSDs and HDDs on the Same Node
      Managing Storage Pools
        Operating Pools
      Snapshots
        RBD Snapshots
        Pool Snapshots
      Erasure Coded Pools
        Creating a Sample Erasure Coded Pool
        Erasure Code Profiles
        Erasure Coded Pool And Cache Tiering
      Cache Tiering
        Tiered Storage Terminology
        Points to Consider
        When to Use Cache Tiering
        Cache Modes
        Setting Up an Example Tiered Storage
    Accessing Cluster Data
      Ceph RADOS Gateway
        Managing RADOS Gateway with ceph-deploy
        Managing RADOS Gateway Manually
        Operating the RADOS Gateway Service
        Managing RADOS Gateway Access
        Multi-site Object Storage Gateways
      Ceph iSCSI Gateway
        iSCSI Block Storage
        General Information about lrdb
        Deployment Considerations
        Installation and Configuration
        Connecting to lrbd-managed Targets
        Conclusion
      Clustered File System
        Ceph Metadata Server
        CephFS
        Managing Failover
      NFS-Ganesha: Export Ceph Data via NFS
        Installation
        Configuration
        Starting NFS-Ganesha Related Services
        Verifying the Exported NFS Share
        Mounting the Exported NFS Share
    Managing Cluster with GUI Tools
      openATTIC
        Installing openATTIC
        openATTIC Web User Interface
        Dashboard
        Ceph Related Tasks
      Calamari
        Installing Calamari with ceph-deploy
        Installing Calamari Using Crowbar
    Integration with Virtualization Tools
      Using libvirt with Ceph
        Configuring Ceph
        Preparing the VM Manager
        Creating a VM
        Configuring the VM
        Summary
      Ceph as a Back-end for QEMU KVM Instance
        Installation
        Usage
        Creating Images with QEMU
        Resizing Images with QEMU
        Retrieving Image Info with QEMU
        Running QEMU with RBD
        Enabling Discard/TRIM
        QEMU Cache Options
    Best Practices
      Introduction
        Reporting Software Problems
      Hardware Recommendations
        Can I Reduce Data Replication
        Can I Reduce Redundancy Similar to RAID 6 Arrays?
        What is the Minimum Disk Size for an OSD node?
        How Much RAM Do I Need in a Storage Server?
        OSD and Monitor Sharing One Server
        How Many Disks Can I Have in a Server
        How Many OSDs Can Share a Single SSD Journal
      Cluster Administration
        Using ceph-deploy on an Already Setup Server
        Adding OSDs with ceph-disk
        Adding OSDs with ceph-deploy
        Adding and Removing Monitors
        Usage of ceph-deploy rgw
        RADOS Gateway Client Usage
        Automated Installation via Salt
        Restarting Ceph services using DeepSea
        Node Management
      Monitoring
        Usage Graphs on Calamari
        Checking for Full OSDs
        Checking if OSD Daemons are Running on a Node
        Checking if Monitor Daemons are Running on a Node
        What Happens When a Disk Fails?
        What Happens When a Journal Disk Fails?
      Disk Management
        Adding Disks
        Deleting disks
        How to Use Existing Partitions for OSDs Including OSD Journals
      Recovery
        'Too Many PGs per OSD' Status Message
        Calamari Has a Stale Cluster
        'nn pg stuck inactive' Status Message
        OSD Weight is 0
        OSD is Down
        Fixing Clock Skew Warnings
      Accountancy
        Adding S3 Users
        Removing S3 Users
        User Quota Management
        Adding Swift Users
        Removing Swift Users
        Changing S3 and Swift User Access and Secret Keys
      Tune-ups
        How Does the Number of Placement Groups Affect the Cluster Performance?
        Can I Use SSDs and Hard Disks on the Same Cluster?
        What are the Trade-offs of Using a Journal on SSD?
      Integration
        Storing KVM Disks in Ceph Cluster
        Storing libvirt Disks in Ceph Cluster
        Storing Xen Disks in Ceph Cluster
        Mounting and Unmounting an RBD Image
      Cluster Maintenance and Troubleshooting
        Creating and Deleting Pools from Calamari
        Managing Keyring Files
        Creating Client Keys
        Revoking Client Keys
        Checking for Unbalanced Data Writing
        Time Synchronization of Nodes
        Upgrading Software
        Increasing the Number of Placement Groups
        Adding a Pool
        Deleting a Pool
        Troubleshooting
      Performance Diagnosis
        Finding Slow OSDs
        Is My Network Causing Issues?
      Server Maintenance
        Adding a Server to a Cluster
        Removing a Server from a Cluster
        Increasing File Descriptors
      Networking
        Setting NTP to a Ceph Cluster
        Firewall Settings for Ceph
        Adding a Private Network to a Running Cluster
    Glossary
      General
      Ceph Specific Terms
    Example Procedure of Manual Ceph Installation
    Documentation Updates
      February, 2017 (Release of SUSE Enterprise Storage 4 Maintenance Update 1)
      December, 2016 (Release of SUSE Enterprise Storage 4)
      June, 2016 (Release of SUSE Enterprise Storage 3)
      January, 2016 (Release of SUSE Enterprise Storage 2.1)
      October, 2015 (Release of SUSE Enterprise Storage 2)
    Legal