IBM Storage Enabler for Containers Version 2.1.0 User Guide IBM SC27-9294-04 Note Before using this document and the product it supports, read the information in “Notices” on page 53. Edition notice Publication number: SC27-9294-04. This publication applies to version 2.1.0 of IBM Storage Enabler for Containers and to all subsequent releases and modifications until otherwise indicated in a newer publication. © Copyright International Business Machines Corporation 2018, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures.................................................................................................................. v Tables................................................................................................................. vii About this guide................................................................................................... ix Who should use this guide.......................................................................................................................... ix Conventions used in this guide................................................................................................................... ix Related information and publications.........................................................................................................ix Getting information, help, and service.........................................................................................................x IBM Publications Center.............................................................................................................................. x Sending or posting your comments............................................................................................................. x Chapter 1. Introduction......................................................................................... 1 IBM block storage........................................................................................................................................ 2 IBM Spectrum Scale.................................................................................................................................... 3 Chapter 2. IBM block storage deployment.............................................................. 5 Installation................................................................................................................................................... 5 Compatibility and requirements............................................................................................................ 5 Managing SSL certificates.................................................................................................................... 10 Performing installation.........................................................................................................................11 Upgrading existing installation.............................................................................................................14 Rolling back to a previous revision...................................................................................................... 16 Uninstalling the software package.......................................................................................................16 Managing integration with IBM Spectrum Connect.................................................................................. 17 Delegating storage services to the IBM Storage Enabler for Containers interface............................ 18 Canceling service delegation to IBM Storage Enabler for Containers ............................................... 19 Using IBM Storage Enabler for Containers with IBM block storage.........................................................20 Sample configuration for running a stateful container........................................................................20 Recovering a crashed Kubernetes node.............................................................................................. 23 Troubleshooting......................................................................................................................................... 24 Chapter 3. IBM Spectrum Scale deployment.........................................................29 Installation.................................................................................................................................................29 Performing pre-installation tasks........................................................................................................ 29 Managing SSL certificates.................................................................................................................... 34 Performing installation.........................................................................................................................36 Performing installation for a remote IBM Spectrum Scale cluster mount......................................... 40 Managing IBM Spectrum Scale when used with IBM Storage Enabler for Containers............................42 Starting IBM Spectrum Scale in a system........................................................................................... 42 Manually mounting IBM Spectrum Scale ............................................................................................42 Unmounting IBM Spectrum Scale........................................................................................................42 Shutting down IBM Spectrum Scale in a system.................................................................................43 IBM Spectrum Scale monitoring considerations.................................................................................43 Using IBM Storage Enabler for Containers with IBM Spectrum Scale..................................................... 43 Usage restrictions.................................................................................................................................43 Configuring storage classes, PVCs and pods.......................................................................................44 Updating the configuration files...........................................................................................................48 Using an existing fileset for volume creation.......................................................................................48 iii Changing the IBM Spectrum Scale RESTful credentials..................................................................... 49 Troubleshooting......................................................................................................................................... 49 Resolving the Terminating state of pods.........................................................................................50 Resolving the mounting, unmounting or remounting issues in IBM Spectrum Scale file systems....50 Resolving the failure to create ClusterRoleBinding for ubiquity-k8s-provisioner..............................51 Notices................................................................................................................53 Trademarks................................................................................................................................................ 54 iv Figures 1. Integration of IBM block storage systems and IBM Spectrum Scale in Kubernetes environment.............1 2. Create Namespace dialog box...................................................................................................................... 9 3. Create Secret dialog box............................................................................................................................... 9 4. Add New Enabler for Containers Interface dialog box...............................................................................17 5. IBM Storage Enabler for Containers interface on the Interfaces pane..................................................... 18 6. Enabler for Containers interface with a delegated service........................................................................ 19 7. Create Namespace dialog box.................................................................................................................... 32 8. Create Secret dialog box............................................................................................................................. 34 9. Sample configuration supported by IBM Storage Enabler for Containers.................................................41 v vi Tables 1. Configuration parameters in values.yaml .................................................................................................. 12 2. Troubleshooting for IBM Storage Enabler for Containers ......................................................................... 26 3. Configuration parameters in values.yaml file............................................................................................. 36 4. Configuration parameters in storage-class-template.yml for IBM Spectrum Scale................................. 45 5. Configuration parameters in pvc-template.yml for IBM Spectrum Scale..................................................46 6. Configuration parameters in pod-template.yml for IBM Spectrum Scale................................................. 48 7. Configuration parameters in ubiquity-configmap.....................................................................................