SSONCY_6.0.1 - Documentation Index

Table of Contents

• Welcome
• Overview
  • What's new?
  • Supported features
  • Limitations
  • Technology preview
• Planning
  • Considerations
  • Hardware requirements
  • Software requirements
  • Deployment considerations
  • GPU Direct Storage
  • Networking
    • Network and firewall requirements
    • Container Network Interface (CNI) configuration
    • NVIDIA Networking
      • NVIDIA Network Operator
      • RDMA over InfiniBand
      • RDMA over Converged Ethernet (RoCE)
      • Networking Scenarios and Examples
        • RoCE deployment with hostNetwork=false
  • IBM Storage Scale container native and SELinux
  • Roles and personas
  • Container images
  • Air-gapped installs
• Storage cluster
  • On-premise
  • Cloud
• Red Hat OpenShift Container Platform
  • Software requirements
  • Red Hat OpenShift configuration on-premise
    • Worker node configuration
    • Infrastructure node configuration
    • Master node configuration (compact cluster)
    • Install the Kernel Module Management Operator
  • Red Hat OpenShift service on AWS
    • Support matrix for IBM Storage Scale container native and ROSA
    • Red Hat OpenShift configuration on AWS
  • Validating Red Hat OpenShift configuration
• Kubernetes
  • Software requirements
  • Configuration
  • Migration from IBM Storage Scale CSI
• Google Kubernetes Engine (GKE)
  • Software requirements
  • Configuration
• Installing the IBM Storage Scale container native operator and cluster
  • Install
  • Container Images
  • Building the kernel portability layer
  • Kubernetes resources
    • Cluster
    • Callhome
    • RemoteCluster
      • Creating secrets for storage cluster GUI users
      • Configuring Certificate Authority (CA) certificates
    • File Systems
      • Remote file system
      • Local file system
    • Encryption
  • Enable GPU Direct Storage
• Validating installation
  • Verifying the IBM Storage Scale container native cluster
  • Status and events
• Using IBM Storage Scale GUI
  • GUI Access
  • GUI User Management
• Upgrading IBM Storage Scale container native
  • Supported upgrade paths
  • Upgrade considerations for CSI volumes
  • Single Namespace
  • Upgrade
  • Verification
  • Post upgrade tasks
  • Migration between MCO and KMM
• Upgrading Google Kubernetes Engine (GKE)
• Configuring IBM Storage Scale Container Storage Interface (CSI) driver
  • Configuring storage class to use CSI driver
  • Managed CSI fields
• Cache Volumes
  • Caching modes
  • Kubernetes resources
  • Storage class for cache volume
  • Creating cache volumes
  • Download and Eviction
  • Tuning cache configuration parameters
• Maintenance
  • Shutting down a cluster
  • IBM Storage Scale container native cluster and node maintenance
  • Nodes
    • Draining nodes
    • Adding new nodes to an existing cluster
    • Deleting nodes from a cluster
  • Starting the cluster after shutdown
  • IBM Storage Scale Storage cluster
    • Updating remote mount access key on IBM Storage Scale storage cluster
    • Updating authentication to the storage cluster
  • File systems
    • Local filesystems
      • Add disks
      • Delete disks
      • Maintenance mode
• Cleanup
  • Removing applications
  • Cleanup Kubernetes resources
    • Remote file systems
    • Remote clusters
    • Local file systems
    • Cluster
  • Cleanup Kernel Module Management (KMM) operator and secrets
  • Cleanup IBM Storage Scale CSI
  • Cleanup IBM Storage Scale container native
  • Cleanup nodes
    • Red Hat OpenShift
    • Kubernetes
  • Cleanup storage cluster
  • Cleanup on AWS ROSA
• Monitoring
  • System monitor and Kubernetes readiness probe
  • Viewing and analyzing the performance data with the IBM Storage Scale bridge for Grafana
• Support
  • Known issues
    • Pod Issues
      • A GUI pod is stuck in 3/4 running containers with multiple restarts
      • Error: daemon and kernel extension do not match
      • Error: could not insert module, required key not available
      • MountVolume.SetUp failed for volume "ssh-keys"
      • Unable to retrieve some image pull secrets
      • GUI or Grafana bridge pods fails to start, no data returned from pmcollector to front end applications
      • pmcollector pod is in pending state during OpenShift Container Platform upgrade or reboot
      • pmsensors that shows null after failure of pmcollector node
      • pmcollector pods are not in Running state
      • pid_limits set higher than podPidLimits, but not being honored
      • Upgrade failed due to PodsUnsafeToDelete: Unknown safety with reason
      • Core pods restart constantly because mount parameters have changed
    • Cluster Issues
      • NumaMemoryInterleave is not set to yes
    • Remote cluster Issues
      • RestError: failed to get storage cluster information. errmsg: 401 Unauthorized GET or PasswordsOutOfSync
      • Failed to establish remote cluster connection when cacert ConfigMap does not exist
      • Adding a Remote Cluster to an existing IBM Storage Scale container native cluster taking a long time to appear
    • File system issues
      • Remote file systems are defined but not mounted on all nodes
      • Remote file systems unable to mount successfully
    • Cache volume issues
      • Empty cache mode and health status in CacheVolume CR
    • Upgrade Issues
      • tls errors found in the operator log
    • Red Hat OpenShift Node issues
      • Adding a node fails - the node appears to already belong to a GPFS cluster
    • Red Hat OpenShift Service on AWS
      • Error: InvalidGroup.NotFound
      • Error: CSI pods in CrashLoopBackOff
  • Troubleshooting
    • Troubleshooting operator
    • Troubleshooting deployment
    • Troubleshooting custom resources
      • Remote Cluster
        • Failed to register remote storage cluster on local GUI REST-API
        • Failed login attempts timeout (403 error)
    • Troubleshooting IBM Storage Scale Container Storage Interface (CSI)
    • Troubleshooting PVCs
    • Troubleshooting Pods
    • Troubleshooting Red Hat OpenShift
      • Machine Config Operator (MCO) is blocked from completing
      • GUI mounts not getting refreshed
    • Troubleshooting blocked upgrades and blocked node drains
    • Troubleshooting building IBM Storage Scale kernel module management using KMM related issues
  • Gathering data about your cluster
    • Red Hat OpenShift Container Platform
      • must-gather
      • Kernel crash dumps
    • Kubernetes
      • must-gather
    • Generating GPFS trace reports
    • Generating GPFS kernel thread dumps
• References
  • IBM Storage Scale
  • Red Hat OpenShift or Kubernetes
• Notices
  • EU Data Act (Regulation 2023/2854)
• Product documentation in guide format