SSZL24_7.0.1 - Documentation Index

Table of Contents

• Welcome
• Summary of changes
• Quick Deployment and Upgrade Guide
• Software Deployment Guide
  • Deployment through the command-line interface
    • Planning and configuring network
      • Configuring multi-rail over TCP
      • Configure an IPv6 address on high-speed interfaces
      • Enabling RoCE
      • Configuring a switch VLAN
        • Changing the switch default password
        • Connecting the PC to the switch console port
        • Configuring the host PC
        • Modifying existing Cumulus switches
      • Configuring the MTM 5149-S54 switch
      • Configuring a dual 24-port (48 ports) MGMT switch
      • Configuring ConnectX-5, ConnectX-6, or ConnectX-7 adapter
      • Configuring Redfish service
    • Prerequisites
      • Power9 management server
      • IBM Storage Scale System Utility Node (MTM 5149-23E)
      • Bring-your-own management server
    • Preparing for the deployment and the upgrade
      • Preparing a Power9 management server
        • Adding IBM Storage Scale System Utility Node or IBM Storage Scale System 6000 to a Power9 management server
        • Cleaning up the network bridges from a Power9 management server node
        • Configuring dual management server
      • Preparing a Utility Node
        • Converting a Power9 management server environment into a Utility Node unified management server
      • Preparing bring-your-own management server
      • Configuring dual management server
    • Updating nodes
    • Creating network bonds
    • Creating a cluster
      • Adding nodes or building blocks
      • Adding AFM gateway nodes to a cluster by using the installation toolkit
      • Adding an AFM gateway node to clusters by using the essrun command
      • Configuring a mixed cluster and file system
      • Configuring IBM Storage Scale native REST API on IBM Storage Scale Systems cluster nodes
    • Setting up Cluster Export Services
      • Creating a CES VM by using the essrun command
      • Creating a shared root file system for CES
      • Adding and configuring protocols in an existing cluster by using the essrun command
      • Adding and configuring protocols in an exiting cluster by using IBM Storage Scale installation toolkit
      • Deploying a protocol virtual machine on IBM Storage Scale System 3500 I/O nodes
    • Verifying installed nodes and health
    • Configuring the GUI hardware monitoring
    • Setting a time zone
      • Setting up chronyd in non-IBM Storage Scale System nodes
    • Configuring call home
      • Disabling the Call Home auto expansion
      • Disk call home
      • Configuring proxy for call home
      • Call home logs and location
      • Overview of a problem report
        • Problem and IBM tickets details
        • Call home monitoring of Power management server and IBM Storage Scale System 5000 systems
        • Upload data
      • Call home pre-installation worksheets
  • Deployment from an x86 Utility Node by using the GUI
    • Setting up the IBM Storage Scale System API server container
    • Setting up the IBM Storage Scale System deployment GUI container
    • Using the deployment GUI
  • Software upgrade and firmware update
    • Upgrade workflow
    • Preparation and prerequisites
    • Setting up a container
    • Checking the system health by using the decoupled precheck tool
    • Upgrading GUI high availability nodes
    • Updating management servers
    • Updating the system firmware
    • Updating the I/O nodes
    • Upgrading the protocol nodes
    • Restarting nodes and services
    • Upgrading the Power9 firmware
      • Manually updating a boot drive for IBM Storage Scale System 5000
    • Upgrade flow in IBM Storage Scale System 5000
  • Upgrade from an x86 Utility Node by using the GUI
    • Perform the upgrade by using the GUI
  • Configuring remote code load
    • Setting up the IBM Storage Scale System RCL service container
    • Setting up the IBM Storage Scale System API server container
  • Troubleshooting
  • Enabling or disabling security settings
    • Firewall ports
    • Enabling or disabling the firewall
    • Enabling or disabling SELinux
    • Enabling or disabling sudo
    • Enabling or disabling FIPS
    • Security Technical Implementation Guide
      • Enabling STIG audit
    • Federal Information Processing mode
      • Enabling and managing FIPS mode on nodes
      • FIPS mode issues
• IBM Storage Scale System Problem Determination Guide
  • Best practices for troubleshooting
    • How to get started with troubleshooting
    • Back up your data
    • Resolve events in a timely manner
    • Keep your software up to date
    • Subscribe to the support notification
    • Know your IBM warranty and maintenance agreement details
    • Know how to report a problem
  • Collecting information about an issue
  • Servicing log tip
    • Re-creating NVRAM disks for IBM Storage Scale System 5000
    • Replacing the logtip backup solid state drive
  • IBM Storage Scale System deployment troubleshooting: Helpful podman, Ansible, and log information
    • Troubleshooting for Ansible issues
  • Debugging yum update issues from the container
  • GUI issues for IBM Storage Scale System
    • Issue with loading GUI
  • Recovery group issues
    • Recovery group issues for shared recovery groups in IBM Storage Scale System
    • Recovery group issues for paired recovery groups in IBM Storage Scale System
    • Manually starting GPFS disks in response to recovery group issues
  • Maintenance procedures
    • Updating the firmware for host adapters, enclosures, and drives
    • Enclosure firmware troubleshooting for IBM Storage Scale System 3000
    • Disk diagnosis
    • Background tasks
    • Server failover in IBM Storage Scale System
      • Server failover for shared recovery groups in ESS
      • Server failover for paired recovery groups in ESS
    • Data checksums
    • Disk replacement for IBM Storage Scale System
      • Commandless disk replacement
        • Replacing bad drives with new drives by using commandless disk replacement
      • Use cases for disk replacement
        • Replacing failed disks in an ESS recovery group: a sample scenario for ESS 3000
        • Replacing failed disks in an ESS recovery group: a sample scenario for ESS 5000
        • Using the mmvdisk command to fix issues caused by improper disk removal for ESS
        • Replacing failed ESS storage enclosure components: a sample scenario for ESS 5000
        • Replacing a failed ESS storage enclosure for ESS 5000
    • Unlock self-encrypted drives for IBM Storage Scale System
    • Other hardware services in IBM Storage Scale System
    • Directed maintenance procedures available in the GUI
      • Replace disks
      • Update enclosure firmware
      • Update drive firmware
      • Update host-adapter firmware
      • Start NSD
      • Start GPFS daemon
      • Increase fileset space
      • Synchronize node clocks
      • Start performance monitoring collector service
      • Start performance monitoring sensor service
      • Activate AFM performance monitoring sensors
      • Activate NFS performance monitoring sensors
      • Activate SMB performance monitoring sensors
      • Configure NFS sensors
      • Configure SMB sensors
      • Mount file system if it must be mounted
      • Start the GUI service on the remote nodes
    • Maintenance procedures for NVMe and PCIe issues for IBM Storage Scale System 3000
    • Linux native PCIe interrupt handler validation and enablement for IBM Storage Scale System 3000
    • PCIe-related data collection and debug for IBM Storage Scale System 3000
    • Detecting faulty DIMMs to solve canister boot issues for IBM Storage Scale System 3000
    • Automatic service ticket creation for RAS events
  • References
    • Events
      • Array events
      • Enclosure events
      • Virtualdisk events
      • Physicaldisk events
      • Recoverygroup events
      • Server events
      • Canister events
    • Messages
      • Message severity tags
      • IBM Storage Scale RAID messages
        • 6027-1850 [E]
        • 6027-1851 [A]
        • 6027-1852 [A]
        • 6027-1853 [E]
        • 6027-1854 [E]
        • 6027-1855 [E]
        • 6027-1856 [E]
        • 6027-1857 [E]
        • 6027-1858 [E]
        • 6027-1859 [E]
        • 6027-1860 [E]
        • 6027-1861 [W]
        • 6027-1862 [E]
        • 6027-1863 [E]
        • 6027-1864 [E]
        • 6027-1866 [E]
        • 6027-1867 [E]
        • 6027-1869 [E]
        • 6027-1870 [E]
        • 6027-1871 [E]
        • 6027-1872 [E]
        • 6027-1873 [E]
        • 6027-1874 [E]
        • 6027-1875 [E]
        • 6027-1876 [E]
        • 6027-1877 [E]
        • 6027-1878 [E]
        • 6027-1879 [E]
        • 6027-1880 [E]
        • 6027-1881 [E]
        • 6027-1882 [E]
        • 6027-1883 [E]
        • 6027-1884 [E]
        • 6027-1885 [E]
        • 6027-1886 [E]
        • 6027-1887 [E]
        • 6027-1888 [E]
        • 6027-1889 [E]
        • 6027-1890 [E]
        • 6027-1891 [E]
        • 6027-1892 [E]
        • 6027-1893 [E]
        • 6027-1894 [E]
        • 6027-1895 [E]
        • 6027-1896 [E]
        • 6027-1897 [E]
        • 6027-1898 [E]
        • 6027-1899 [E]
        • 6027-3000 [E]
        • 6027-3001 [E]
        • 6027-3002 [E]
        • 6027-3003 [E]
        • 6027-3004 [E]
        • 6027-3005 [W]
        • 6027-3006 [W]
        • 6027-3007 [E]
        • 6027-3008 [E]
        • 6027-3009 [E]
        • 6027-3010 [E]
        • 6027-3011 [W]
        • 6027-3012 [E]
        • 6027-3013 [W]
        • 6027-3014 [E]
        • 6027-3015 [E]
        • 6027-3016 [E]
        • 6027-3017 [E]
        • 6027-3018 [E]
        • 6027-3019 [E]
        • 6027-3020 [E]
        • 6027-3021 [E]
        • 6027-3022 [E]
        • 6027-3023 [E]
        • 6027-3024 [E]
        • 6027-3025 [E]
        • 6027-3026 [E]
        • 6027-3027 [E]
        • 6027-3028 [E]
        • 6027-3029 [E]
        • 6027-3030 [E]
        • 6027-3031 [E]
        • 6027-3032 [E]
        • 6027-3034 [E]
        • 6027-3035 [A]
        • 6027-3036 [E]
        • 6027-3037 [E]
        • 6027-3038 [E]
        • 6027-3039 [E]
        • 6027-3040 [E]
        • 6027-3041 [E]
        • 6027-3042 [E]
        • 6027-3043 [E]
        • 6027-3044 [E]
        • 6027-3045 [W]
        • 6027-3046 [E]
        • 6027-3047 [E]
        • 6027-3048 [E]
        • 6027-3049 [E]
        • 6027-3050 [E]
        • 6027-3051 [E]
        • 6027-3052 [E]
        • 6027-3053 [E]
        • 6027-3054 [W]
        • 6027-3055 [E]
        • 6027-3056 [E]
        • 6027-3057 [E]
        • 6027-3058 [A]
        • 6027-3059 [E]
        • 6027-3060 [E]
        • 6027-3061 [E]
        • 6027-3062 [E]
        • 6027-3063 [E]
        • 6027-3064 [I]
        • 6027-3065 [E]
        • 6027-3066 [E]
        • 6027-3067 [E]
        • 6027-3068 [E]
        • 6027-3069 [E]
        • 6027-3070 [E]
        • 6027-3071 [E]
        • 6027-3072 [E]
        • 6027-3073 [E]
        • 6027-3074 [E]
        • 6027-3075 [E]
        • 6027-3076 [E]
        • 6027-3077 [E]
        • 6027-3078 [E]
        • 6027-3079 [E]
        • 6027-3080 [E]
        • 6027-3084 [E]
        • 6027-3085 [E]
        • 6027-3086 [E]
        • 6027-3087 [E]
        • 6027-3088 [E]
        • 6027-3089 [E]
        • 6027-3090 [E]
        • 6027-3091 [W]
        • 6027-3092 [I]
        • 6027-3093 [E]
        • 6027-3094 [E]
        • 6027-3095 [E]
        • 6027-3096 [E]
        • 6027-3097 [E]
        • 6027-3098 [E]
        • 6027-3099 [E]
        • 6027-3800 [E]
        • 6027-3801 [E]
        • 6027-3802 [E]
        • 6027-3803 [E]
        • 6027-3804 [W]
        • 6027-3805 [E]
        • 6027-3806 [E]
        • 6027-3807 [E]
        • 6027-3808 [E]
        • 6027-3809 [I]
        • 6027-3810 [W]
        • 6027-3811 [E]
        • 6027-3812 [I]
        • 6027-3813 [A]
        • 6027-3814 [A]
        • 6027-3815 [E]
        • 6027-3816 [E]
        • 6027-3817 [E]
        • 6027-3818 [E]
        • 6027-3819 [I]
        • 6027-3820 [E]
        • 6027-3821 [E]
        • 6027-3822 [I]
        • 6027-3823 [E]
        • 6027-3824 [E]
        • 6027-3825 [E]
        • 6027-3826 [A]
        • 6027-3827 [A]
        • 6027-3828 [E]
        • 6027-3829 [E]
        • 6027-3830 [E]
        • 6027-3831 [E]
        • 6027-3832 [E]
        • 6027-3833 [E]
        • 6027-3836 [I]
        • 6027-3837 [E]
        • 6027-3838 [E]
        • 6027-3839 [E]
        • 6027-3840 [E]
        • 6027-3841 [E]
        • 6027-3843 [E]
        • 6027-3844 [E]
        • 6027-3845 [E]
        • 6027-3846 [E]
        • 6027-3847 [E]
        • 6027-3848 [E]
        • 6027-3849 [E]
        • 6027-3850 [E]
        • 6027-3851 [E]
        • 6027-3852 [A]
        • 6027-3853 [W]
        • 6027-3854 [E]
        • 6027-3855 [E]
        • 6027-3856 [E]
        • 6027-3857 [E]
        • 6027-3858 [E]
        • 6027-3859 [E]
        • 6027-3860 [E]
        • 6027-3861 [E]
        • 6027-3862 [E]
        • 6027-3863 [E]
        • 6027-3864 [E]
        • 6027-3865 [E]
        • 6027-3866 [E]
        • 6027-3867 [E]
        • 6027-3868 [E]
        • 6027-3869 [E]
        • 6027-3870 [E]
        • 6027-3871 [E]
        • 6027-3872 [E]
        • 6027-3873 [E]
        • 6027-3874 [E]
        • 6027-3875 [E]
        • 6027-3876 [E]
        • 6027-3877 [E]
        • 6027-3878 [E]
        • 6027-3879 [E]
        • 6027-3880 [E]
        • 6027-3881 [E]
        • 6027-3882 [E]
        • 6027-3883 [E]
  • Contacting IBM
    • Information to collect before contacting the IBM Support Center
    • How to contact the IBM Support Center
  • Cleaning up IBM Storage Scale System environments
• IBM Storage Scale System Command Reference
  • IBM Storage Scale System commands
    • essaddnode command
    • esscallhomeconf script
    • esscallhomeevent command
    • esscheckdisks command
    • esscrchxml command
    • essfindmissingdisks command
    • essgennetworks command
    • essinstallcheck command
    • essnettest command
    • essnodedetails command
    • essrun command
    • essruntask command
    • essstoragequickcheck command
    • essstress command
    • essmkyml command
    • essutils command
      • essutils main menu
      • essutils - SSR Tools menu
      • essutils - Validation and stress test menu
      • essutils - Storage subsystem details menu
      • essutils - Collect misc service data menu
    • esscmd command
    • essinventory command
  • IBM Storage Scale System scripts
    • esssnap script
• IBM Storage Scale RAID Administration Guide
  • Summary of changes
  • Introducing IBM Storage Scale RAID
    • Overview
    • IBM Storage Scale RAID features
      • RAID codes
      • End-to-end checksum
      • Declustered RAID
    • Disk configurations
      • Recovery groups
      • Declustered arrays
    • Virtual and physical disks
      • Virtual disks
      • Physical disks
      • Solid-state disks
    • IBM Storage Scale RAID with pdisk-group fault tolerance
      • Pdisk-group fault tolerance: an example
    • Disk hospital
      • Health metrics
      • Pdisk discovery
      • Disk replacement recording and reporting
    • IBM Storage Scale System fabric hospital
      • Installing and configuring the IBM Storage Scale System fabric hospital
        • Configuring performance monitoring tool sensors
        • Adding threshold rules
        • Identifying threshold events
      • Disabling the ESS fabric hospital
  • Administering IBM Storage Scale RAID
    • Requirements for administering IBM Storage Scale RAID
    • Common IBM Storage Scale RAID command principles
      • Specifying nodes as input to IBM Storage Scale RAID commands
      • Stanza files
  • Managing IBM Storage Scale RAID with the mmvdisk command
    • The mmvdisk administration methodology
    • Overview of the mmvdisk commands
    • Example of the mmvdisk command sequence
    • Node class management
    • Server management
    • Recovery group management
      • Declustered array naming
      • Declustered array capacity
      • Declustered array spares
      • Minimum declustered array requirements
      • Log groups
      • Recovery group server maintenance
    • Vdisk set management
      • Elements of a vdisk set definition
      • Vdisk set definition sizing and preview
    • File system management
    • Use cases for mmvdisk
      • A complete use case for mmvdisk
      • Use case for multiple identical building blocks
      • Reporting file system orphans with mmvdisk
      • Converting existing recovery groups to mmvdisk management
      • Replacing a pdisk using mmvdisk
      • IBM Storage Scale System 3200 MES upgrade
    • Limitations of mmvdisk
  • Managing IBM Storage Scale RAID
    • Recovery groups
      • Recovery group server parameters
      • Recovery group creation
      • Recovery group server failover
    • Pdisks
      • Pdisk paths
      • Pdisk stanza format
      • Pdisk states
    • Declustered arrays
      • Declustered array parameters
      • Declustered array size
      • Data spare space and VCD spares
      • Increasing VCD spares
      • Declustered array free space
      • Pdisk free space
    • Vdisks
      • RAID code
      • Block size
      • Vdisk size
      • Log vdisks
      • Creating vdisks and NSDs
      • Vdisk states
    • Determining pdisk-group fault-tolerance
  • Managing TRIM support for storage space reclamation
    • Best practices for TRIM configurations
    • Upgrading file system and recovery group from an earlier code level
    • Enabling TRIM support on a new recovery group and file system
    • Enable, disable, extend and view TRIM settings on an existing declustered array and file system
    • Reclaim space after enabling TRIM support
    • Automatic background TRIM
  • Managing the self-encrypting drives on IBM Elastic Storage Server
    • Changing a master encryption key for recovery group drives
  • Configuring components on the Elastic Storage Server
    • Adding components to the cluster’s configuration
    • Defining component locations
    • Synchronizing display IDs
    • Updating component attributes
  • Monitoring IBM Storage Scale RAID
    • System health monitoring
      • Monitoring events
        • Monitoring events through callhome
        • IBM Storage Scale RAID callbacks
        • IBM Storage Scale RAID events in syslog
      • Monitoring system health by using ESS GUI
        • Monitoring events by using GUI
        • Event notifications
          • Configuring email notifications
          • Configuring SNMP manager
    • Performance monitoring
      • Performance monitoring using ESS GUI
        • Configuring performance monitoring options in GUI
        • Configuring performance metrics and display options in the Statistics page of the GUI
        • Configuring the dashboard to view performance charts
        • Performance metrics available in the GUI
        • Querying performance data shown in the GUI through CLI
        • Monitoring performance of nodes
        • Monitoring performance of file systems
        • Monitoring performance of NSDs
      • Monitoring IBM Storage Scale RAID I/O performance
        • Displaying vdisk I/O statistics
          • Example of mmpmon vio_s request
        • Resetting vdisk I/O statistics
          • Example of mmpmon vio_s_reset request
    • Monitoring capacity through GUI
  • Checking the health of an ESS configuration: a sample scenario
  • Setting up IBM Storage Scale RAID on the Elastic Storage Server
    • Configuring IBM Storage Scale RAID recovery groups on the IBM Storage Scale System 3200: a sample scenario
      • Preparing IBM Storage Scale System 3200 recovery group servers
      • Creating recovery groups on the IBM Storage Scale System 3200
  • IBM Storage Scale RAID management API
    • Diskmgmt/vdiskset/server/list/{nodeClass}: GET
    • Encryption/clients: GET
    • Encryption/keys: GET
    • Encryption/servers: GET
    • Encryption/rkms: GET
    • Encryption/tenants: GET
    • Recoverygroups/declusteredArray: GET
    • Recoverygroups/{rgName}/{oldNode}/replace/{newNode}: PUT
    • Encryption/clients/deregister: PUT
    • Encryption/clients: PUT
    • Encryption/servers: PUT
    • Encryption/servers: POST
    • Encryption/tenants: POST
    • Encryption/keys: POST
    • Encryption/clients: POST
    • Encryption/clients/register: POST
    • Encryption/clients/{clientName}: DELETE
    • Encryption/tenants: DELETE
    • Encryption/servers/{serverName}: DELETE
    • Filesystems/{filesystemName}/file/{path}: GET
    • Filesystems/{filesystemName}/file/{path}/fileSize/{size}: POST
    • Filesystems/{filesystemName}/file/{path}: DELETE
    • Filesystems/{fileSystemName}/vdiskset/{vdiskset}: POST
    • Gnr/diskmgmt/vdiskset: GET
    • Gnr/recoverygroups: GET
    • Gnr/recoverygroups/{recoveryGroupName}: GET
    • Gnr/recoverygroups/{recoveryGroupName}/pdisks: GET
    • Gnr/recoverygroups/{recoveryGroupName}/pdisks/{pdiskName}: GET
    • Gnr/recoverygroups/pdisk/change : PUT
    • Gnr/recoverygroups/pdisk/replace : PUT
    • Gnr/recoverygroups/{recoveryGroupName}/vdisks: GET
    • Gnr/recoverygroups/{recoveryGroupName}/vdisks/{vdiskName}: GET
    • Gnr/clustermgmt/nodes/{names}/state: GET
    • Gnr/clustermgmt/server/configure: POST
    • Gnr/diskmgmt/vdiskset/define: POST
    • Gnr/recoverygroups/{recoveryGroupName}/node/{name}: POST
    • Gnr/diskmgmt/vdiskset/create/{vdiskSet}: POST
    • Gnr/diskmgmt/vdiskset/undefine/{vdiskSet}: DELETE
    • Gnr/diskmgmt/vdiskset/delete/{vdiskSet}: DELETE
    • Gnr/diskmgmt/vdiskset/{vdiskSet}/rename/{newVdiskSet}: POST
    • Gnr/clustermgmt/{newNodeName}/service/{serviceName}: POST
    • Gnr/recoverygroups/suspend/{recoveryGroupName}/{node}: PUT
    • Gnr/recoverygroups/resume/{recoveryGroupName}/{node}: PUT
  • Best-practice recommendations for IBM Storage Scale RAID
  • IBM Storage Scale RAID commands
    • mmaddcomp command
    • mmaddcompspec command
    • mmaddpdisk command
    • mmchcarrier command
    • mmchcomp command
    • mmchcomploc command
    • mmchenclosure command
    • mmchfirmware command
    • mmchpdisk command
    • mmchrecoverygroup command
    • mmcrrecoverygroup command
    • mmcrvdisk command
    • mmdelcomp command
    • mmdelcomploc command
    • mmdelcompspec command
    • mmdelpdisk command
    • mmdelrecoverygroup command
    • mmdelvdisk command
    • mmdiscovercomp command
    • mmgetpdisktopology command
    • mmimportnvmeof command
    • mmlscomp command
    • mmlscomploc command
    • mmlscompspec command
    • mmlsenclosure command
    • mmlsfirmware command
    • mmlsnvmestatus
    • mmlspdisk command
    • mmlsrecoverygroup command
    • mmlsrecoverygroupevents command
    • mmlsvdisk command
    • mmsyncdisplayid command
    • mmvdisk command
      • mmvdisk nodeclass command
      • mmvdisk server command
      • mmvdisk recoverygroup command
      • mmvdisk filesystem command
      • mmvdisk vdiskset command
      • mmvdisk vdisk command
      • mmvdisk pdisk command
      • mmvdisk sed command
      • mmvdisk tpm command
      • mmvdisk nvmeof command
      • mmvdisk nsd command
  • IBM Storage Scale RAID scripts
    • chdrawer script
    • gnrhealthcheck script
    • mkrginput script
    • topselect script
    • topsummary script
  • Setting up GNR on the Power 775 Disk Enclosure
    • Disk replacement recording and reporting
    • Configuring GNR recovery groups: a sample scenario
      • Preparing recovery group servers
      • Creating recovery groups on a Power 775 Disk Enclosure
    • Replacing failed disks in a Power 775 Disk Enclosure recovery group: a sample scenario
  • Accessibility features for IBM Storage Scale RAID
    • Accessibility features
    • Keyboard navigation
    • IBM and accessibility
  • Notices
    • Trademarks
    • Terms and conditions for product documentation
  • Glossary
• IBM Storage Scale System Software Guides PDFs
• Notices
  • EU Data Act (Regulation 2023/2854)