Release notes
Links to the Release Notes
Links to the Release Notes
Getting started
Grid primer
About StorageGRID
Hybrid clouds with StorageGRID
StorageGRID architecture and network topology
Deployment topologies
System architecture
Grid nodes and services
Network topologies
Network topology examples
Grid Network topology
Admin Network topology
Client Network topology
Topology for all three networks
How StorageGRID manages data
What an object is
How object data is protected
The life of an object
Ingest data flow
Copy management
Content protection: replication
Content protection: erasure coding
Content protection: Cloud Storage Pool
Content protection: archive
Retrieve data flow
Delete data flow
Exploring the Grid Manager
Web browser requirements
Grid Manager Dashboard
Alerts menu
Nodes page
Tenants page
Configuration menu
ILM menu
Maintenance menu
Support menu
Help menu
Exploring the Tenant Manager
Tenant Manager Dashboard
S3 menu
Access Control menu
Using StorageGRID
Controlling user access
Managing tenants and client connections
Managing objects with information lifecycle management
Monitoring StorageGRID operations
Viewing the Nodes page
Tabs for the Nodes page
Prometheus metrics
StorageGRID attributes
Monitoring and managing alerts
Monitoring alarms (legacy system)
Using SNMP monitoring
Reviewing audit messages
Setting configuration options
Performing maintenance procedures
Downloading the Recovery Package
Using StorageGRID support options
Configuring AutoSupport
Collecting StorageGRID logs
Using metrics and running diagnostics
StorageGRID Glossary
Account Service Forwarder
active-backup network bond mode
ADC service (Administrative Domain Controller)
ADE (Asynchronous Distributed Environment)
Admin Network
Admin Node
AMS service (Audit Management System)
ARC service (Archive)
Archive Node
audit message
bundle
Cassandra
Cassandra Reaper service
CBID (Content Block Identifier)
Chunk service
CLB service (Connection Load Balancer)
Client Network
CloudMirror replication service
Cloud Storage Pool
CMN service (Configuration Management Node)
container
CSTR
DDS service (Distributed Data Store)
DMV service (Data Mover)
dual commit
Dynamic IP service
erasure coding
erasure coding scheme
Gateway Node
Grid Manager
Grafana service
Grid Network
grid node
grid task
High Availability service
Identity (idnt) service
ILM (Information Lifecycle Management)
ingest
LACP (Link Aggregation Control Protocol)
Load Balancer service
LDR service (Local Distribution Router)
metadata
metadata store
MISCd Information Service Control Daemon service
nginx service
nginx-gw service
NMS service (Network Management System)
node ID
notifications service
object
object segmentation
object storage
object store
Persistence service
platform services
primary Admin Node
Prometheus service
provisioning
Recovery Package
replication
RSM service (Replicated State Machine Service)
search integration service
segment container
service
site
SSM service (Server Status Monitor)
Storage Node
storage pool
synchronous placement
tenant account
Tenant Manager
Trace collector service
Untrusted Client Network
URI (universal resource identifier)
URN (universal resource name)
UUID (universally unique identifier)
VLAN (virtual local area network)
Grid primer
About StorageGRID
Hybrid clouds with StorageGRID
StorageGRID architecture and network topology
Deployment topologies
System architecture
Grid nodes and services
Network topologies
Network topology examples
Grid Network topology
Admin Network topology
Client Network topology
Topology for all three networks
How StorageGRID manages data
What an object is
How object data is protected
The life of an object
Ingest data flow
Copy management
Content protection: replication
Content protection: erasure coding
Content protection: Cloud Storage Pool
Content protection: archive
Retrieve data flow
Delete data flow
Exploring the Grid Manager
Web browser requirements
Grid Manager Dashboard
Alerts menu
Nodes page
Tenants page
Configuration menu
ILM menu
Maintenance menu
Support menu
Help menu
Exploring the Tenant Manager
Tenant Manager Dashboard
S3 menu
Access Control menu
Using StorageGRID
Controlling user access
Managing tenants and client connections
Managing objects with information lifecycle management
Monitoring StorageGRID operations
Viewing the Nodes page
Tabs for the Nodes page
Prometheus metrics
StorageGRID attributes
Monitoring and managing alerts
Monitoring alarms (legacy system)
Using SNMP monitoring
Reviewing audit messages
Setting configuration options
Performing maintenance procedures
Downloading the Recovery Package
Using StorageGRID support options
Configuring AutoSupport
Collecting StorageGRID logs
Using metrics and running diagnostics
StorageGRID Glossary
Account Service Forwarder
active-backup network bond mode
ADC service (Administrative Domain Controller)
ADE (Asynchronous Distributed Environment)
Admin Network
Admin Node
AMS service (Audit Management System)
ARC service (Archive)
Archive Node
audit message
bundle
Cassandra
Cassandra Reaper service
CBID (Content Block Identifier)
Chunk service
CLB service (Connection Load Balancer)
Client Network
CloudMirror replication service
Cloud Storage Pool
CMN service (Configuration Management Node)
container
CSTR
DDS service (Distributed Data Store)
DMV service (Data Mover)
dual commit
Dynamic IP service
erasure coding
erasure coding scheme
Gateway Node
Grid Manager
Grafana service
Grid Network
grid node
grid task
High Availability service
Identity (idnt) service
ILM (Information Lifecycle Management)
ingest
LACP (Link Aggregation Control Protocol)
Load Balancer service
LDR service (Local Distribution Router)
metadata
metadata store
MISCd Information Service Control Daemon service
nginx service
nginx-gw service
NMS service (Network Management System)
node ID
notifications service
object
object segmentation
object storage
object store
Persistence service
platform services
primary Admin Node
Prometheus service
provisioning
Recovery Package
replication
RSM service (Replicated State Machine Service)
search integration service
segment container
service
site
SSM service (Server Status Monitor)
Storage Node
storage pool
synchronous placement
tenant account
Tenant Manager
Trace collector service
Untrusted Client Network
URI (universal resource identifier)
URN (universal resource name)
UUID (universally unique identifier)
VLAN (virtual local area network)
Installing and maintaining appliance hardware
SG100 and SG1000 appliance installation and maintenance
SG100 and SG1000 appliances overview
SG100 and SG1000 applications
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Web browser requirements
Preparing networks
Reviewing appliance network connections
Port bond modes for the SG100 and SG1000 appliances
Network bond modes
Network bond modes for the management ports
Networking guidelines
Network installation and provisioning
Gathering installation information
Installing the hardware
Registering the hardware
Installing the appliance into a cabinet or rack
Cabling the appliance
Connecting power cords and applying power
Viewing status indicators on the appliance
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Configuring StorageGRID IP addresses
Verifying network connections
Verifying port-level network connections
Configuring the BMC interface
Changing the root password for the BMC interface
Setting the IP address for the BMC management port
Accessing the BMC interface
Configuring SNMP settings for the services appliance
Setting up email notifications for alerts
Deploying a services appliance node
Deploying a services appliance as a primary Admin Node
Deploying a services appliance as a Gateway or non-primary Admin Node
Monitoring the services appliance installation
Troubleshooting the hardware installation
Viewing boot-up codes for the appliance
Viewing error codes for the appliance
Hardware setup appears to hang
Troubleshooting connection issues
Unable to connect to the appliance
Rebooting the services appliance while the StorageGRID Appliance Installer is running
Maintaining the appliance
Replacing the services appliance
Replacing a power supply in the services appliance
Replacing a fan in the services appliance
Replacing a drive in the services appliance
Changing the link configuration of the SG1000
Changing the MTU setting
SG6000 appliance installation and maintenance
SG6000 appliances overview
SG6060 overview
SGF6024 overview
Controllers in the SG6000 appliances
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Web browser requirements
Reviewing appliance network connections
Port bond modes for the SG6000-CN controller
Network bond modes for the 10/25-GbE ports
Network bond modes for the 1-GbE management ports
Gathering installation information
Installing the hardware
Registering the hardware
SG6060: Installing 60-drive shelves into a cabinet or rack
SG6060: Installing the drives
SGF6024: Installing 24-drive shelves into a cabinet or rack
SG6000-CN: Installing into a cabinet or rack
Cabling the appliance
SG6060: Cabling the optional expansion shelves
Connecting power cords and applying power
Viewing status indicators and buttons on the SG6000-CN controller
Viewing boot-up status codes for the storage controllers
Configuring the hardware
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Configuring StorageGRID IP addresses
Verifying network connections
Verifying port-level network connections
Configuring SANtricity System Manager
Setting the IP addresses for the storage controllers
Accessing SANtricity System Manager
Setting up SANtricity System Manager
Reviewing the hardware status in SANtricity System Manager
Configuring the BMC interface
Changing the root password for the BMC interface
Setting the IP address for the BMC management port
Accessing the BMC interface
Configuring SNMP settings for the SG6000-CN controller
Setting up email notifications for alerts
Optional: Changing the RAID mode
Optional: Remapping network ports for the appliance
Deploying an appliance Storage Node
Monitoring StorageGRID appliance installation
Troubleshooting the hardware installation
Viewing boot-up codes for the SG6000-CN controller
Viewing error codes for the SG6000-CN controller
Hardware setup appears to hang
Troubleshooting connection issues
Unable to connect to the appliance
Expansion shelves do not appear in Appliance Installer
Rebooting the SG6000-CN controller while the StorageGRID Appliance Installer is running
Maintaining the SG6000 appliance
Upgrading SANtricity OS on the storage controller
Upgrading SANtricity OS Software on the storage controllers using the Grid Manager
Upgrading SANtricity OS Software on the storage controllers using maintenance mode
Adding an expansion shelf to a deployed SG6060
Replacing a storage controller
Replacing hardware components in the storage controller shelf
Replacing hardware components in the optional 60-drive expansion shelf
Replacing the SG6000-CN controller
Replacing a power supply in the SG6000-CN controller
Changing the link configuration of the SG6000-CN controller
Changing the MTU setting
SG5700 appliance installation and maintenance
StorageGRID appliance overview
Controllers in the StorageGRID appliance
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Web browser requirements
Reviewing appliance network connections
Port bond modes for E5700SG controller ports
Network bond modes for the 10/25-GbE ports
Network bond modes for the 1-GbE management ports
Gathering installation information
Installing the hardware
Registering the hardware
Installing the appliance in a cabinet or rack
Cabling the appliance
Connecting power cords and applying power
Viewing boot-up status codes
Status indicators on the E5700SG controller
Configuring the hardware
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Setting the IP configuration
Verifying network connections
Verifying port-level network connections
Accessing and configuring SANtricity System Manager
Setting the IP address for the E2800 management port
Accessing SANtricity System Manager
Setting up SANtricity System Manager
Reviewing the hardware status in SANtricity System Manager
Optional: Changing the RAID mode (SG5760 only)
Optional: Remapping network ports for the appliance
Deploying an appliance Storage Node
Troubleshooting the hardware installation
Hardware setup appears to hang
HE error: Error synchronizing with SANtricity OS Software
Troubleshooting connection issues
Unable to connect to the appliance
Rebooting the controller while the StorageGRID Appliance Installer is running
Maintaining the SG5700 appliance
Upgrading SANtricity OS on the storage controller
Upgrading SANtricity OS Software on the storage controllers using the Grid Manager
Upgrading SANtricity OS Software on the E2800 controller using maintenance mode
Replacing the E2800 controller
Replacing the E5700SG controller
Replacing other hardware components
Changing the link configuration of the E5700SG controller
Changing the MTU setting
SG5600 appliance installation and maintenance
StorageGRID appliance overview
StorageGRID appliance features
Hardware diagrams
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Service laptop requirements
Web browser requirements
Reviewing appliance network connections
Port bond modes for the E5600SG controller ports
Network bond modes for the 10-GbE ports
Network bond modes for the 1-GbE management ports
Gathering installation information
Installing the hardware
Registering the hardware
Installing the appliance in a cabinet or rack
Cabling the appliance
Connecting the AC power cords
Turning power on
Viewing boot-up status and reviewing error codes on the controllers
E5600SG controller seven-segment display codes
Configuring the hardware
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Setting the IP configuration
Verifying network connections
Verifying port-level network connections
Configuring SANtricity Storage Manager
Setting the IP address for the E2700 controller
Adding the appliance to SANtricity Storage Manager
Setting up SANtricity Storage Manager
Configuring AutoSupport
Verifying receipt of AutoSupport
Configuring email and SNMP trap alert notifications
Setting passwords for SANtricity Storage Manager
Optional: Changing to RAID6 mode (SG5660 only)
Optional: Remapping network ports for the appliance
Deploying an appliance Storage Node
Troubleshooting the hardware installation
Hardware setup appears to hang
HE error: Error synchronizing with SANtricity OS Software
Troubleshooting connection issues
Unable to connect to StorageGRID appliance over the network
Rebooting the controller while the StorageGRID Appliance Installer is running
Maintaining the SG5600 appliance
Upgrading SANtricity OS Software on the storage controllers using the Grid Manager
Upgrading SANtricity OS Software on the E2700 controller using maintenance mode
Replacing the E2700 controller
Replacing the E5600SG controller
Replacing other hardware components
Changing the link configuration of the E5600SG controller
Changing the MTU setting
SG100 and SG1000 appliance installation and maintenance
SG100 and SG1000 appliances overview
SG100 and SG1000 applications
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Web browser requirements
Preparing networks
Reviewing appliance network connections
Port bond modes for the SG100 and SG1000 appliances
Network bond modes
Network bond modes for the management ports
Networking guidelines
Network installation and provisioning
Gathering installation information
Installing the hardware
Registering the hardware
Installing the appliance into a cabinet or rack
Cabling the appliance
Connecting power cords and applying power
Viewing status indicators on the appliance
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Configuring StorageGRID IP addresses
Verifying network connections
Verifying port-level network connections
Configuring the BMC interface
Changing the root password for the BMC interface
Setting the IP address for the BMC management port
Accessing the BMC interface
Configuring SNMP settings for the services appliance
Setting up email notifications for alerts
Deploying a services appliance node
Deploying a services appliance as a primary Admin Node
Deploying a services appliance as a Gateway or non-primary Admin Node
Monitoring the services appliance installation
Troubleshooting the hardware installation
Viewing boot-up codes for the appliance
Viewing error codes for the appliance
Hardware setup appears to hang
Troubleshooting connection issues
Unable to connect to the appliance
Rebooting the services appliance while the StorageGRID Appliance Installer is running
Maintaining the appliance
Replacing the services appliance
Replacing a power supply in the services appliance
Replacing a fan in the services appliance
Replacing a drive in the services appliance
Changing the link configuration of the SG1000
Changing the MTU setting
SG6000 appliance installation and maintenance
SG6000 appliances overview
SG6060 overview
SGF6024 overview
Controllers in the SG6000 appliances
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Web browser requirements
Reviewing appliance network connections
Port bond modes for the SG6000-CN controller
Network bond modes for the 10/25-GbE ports
Network bond modes for the 1-GbE management ports
Gathering installation information
Installing the hardware
Registering the hardware
SG6060: Installing 60-drive shelves into a cabinet or rack
SG6060: Installing the drives
SGF6024: Installing 24-drive shelves into a cabinet or rack
SG6000-CN: Installing into a cabinet or rack
Cabling the appliance
SG6060: Cabling the optional expansion shelves
Connecting power cords and applying power
Viewing status indicators and buttons on the SG6000-CN controller
Viewing boot-up status codes for the storage controllers
Configuring the hardware
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Configuring StorageGRID IP addresses
Verifying network connections
Verifying port-level network connections
Configuring SANtricity System Manager
Setting the IP addresses for the storage controllers
Accessing SANtricity System Manager
Setting up SANtricity System Manager
Reviewing the hardware status in SANtricity System Manager
Configuring the BMC interface
Changing the root password for the BMC interface
Setting the IP address for the BMC management port
Accessing the BMC interface
Configuring SNMP settings for the SG6000-CN controller
Setting up email notifications for alerts
Optional: Changing the RAID mode
Optional: Remapping network ports for the appliance
Deploying an appliance Storage Node
Monitoring StorageGRID appliance installation
Troubleshooting the hardware installation
Viewing boot-up codes for the SG6000-CN controller
Viewing error codes for the SG6000-CN controller
Hardware setup appears to hang
Troubleshooting connection issues
Unable to connect to the appliance
Expansion shelves do not appear in Appliance Installer
Rebooting the SG6000-CN controller while the StorageGRID Appliance Installer is running
Maintaining the SG6000 appliance
Upgrading SANtricity OS on the storage controller
Upgrading SANtricity OS Software on the storage controllers using the Grid Manager
Upgrading SANtricity OS Software on the storage controllers using maintenance mode
Adding an expansion shelf to a deployed SG6060
Replacing a storage controller
Replacing hardware components in the storage controller shelf
Replacing hardware components in the optional 60-drive expansion shelf
Replacing the SG6000-CN controller
Replacing a power supply in the SG6000-CN controller
Changing the link configuration of the SG6000-CN controller
Changing the MTU setting
SG5700 appliance installation and maintenance
StorageGRID appliance overview
Controllers in the StorageGRID appliance
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Web browser requirements
Reviewing appliance network connections
Port bond modes for E5700SG controller ports
Network bond modes for the 10/25-GbE ports
Network bond modes for the 1-GbE management ports
Gathering installation information
Installing the hardware
Registering the hardware
Installing the appliance in a cabinet or rack
Cabling the appliance
Connecting power cords and applying power
Viewing boot-up status codes
Status indicators on the E5700SG controller
Configuring the hardware
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Setting the IP configuration
Verifying network connections
Verifying port-level network connections
Accessing and configuring SANtricity System Manager
Setting the IP address for the E2800 management port
Accessing SANtricity System Manager
Setting up SANtricity System Manager
Reviewing the hardware status in SANtricity System Manager
Optional: Changing the RAID mode (SG5760 only)
Optional: Remapping network ports for the appliance
Deploying an appliance Storage Node
Troubleshooting the hardware installation
Hardware setup appears to hang
HE error: Error synchronizing with SANtricity OS Software
Troubleshooting connection issues
Unable to connect to the appliance
Rebooting the controller while the StorageGRID Appliance Installer is running
Maintaining the SG5700 appliance
Upgrading SANtricity OS on the storage controller
Upgrading SANtricity OS Software on the storage controllers using the Grid Manager
Upgrading SANtricity OS Software on the E2800 controller using maintenance mode
Replacing the E2800 controller
Replacing the E5700SG controller
Replacing other hardware components
Changing the link configuration of the E5700SG controller
Changing the MTU setting
SG5600 appliance installation and maintenance
StorageGRID appliance overview
StorageGRID appliance features
Hardware diagrams
Installation and deployment overview
Preparing for installation
Preparing the site
Unpacking the boxes
Obtaining additional equipment and tools
Service laptop requirements
Web browser requirements
Reviewing appliance network connections
Port bond modes for the E5600SG controller ports
Network bond modes for the 10-GbE ports
Network bond modes for the 1-GbE management ports
Gathering installation information
Installing the hardware
Registering the hardware
Installing the appliance in a cabinet or rack
Cabling the appliance
Connecting the AC power cords
Turning power on
Viewing boot-up status and reviewing error codes on the controllers
E5600SG controller seven-segment display codes
Configuring the hardware
Configuring StorageGRID connections
Accessing the StorageGRID Appliance Installer
Configuring network links
Setting the IP configuration
Verifying network connections
Verifying port-level network connections
Configuring SANtricity Storage Manager
Setting the IP address for the E2700 controller
Adding the appliance to SANtricity Storage Manager
Setting up SANtricity Storage Manager
Configuring AutoSupport
Verifying receipt of AutoSupport
Configuring email and SNMP trap alert notifications
Setting passwords for SANtricity Storage Manager
Optional: Changing to RAID6 mode (SG5660 only)
Optional: Remapping network ports for the appliance
Deploying an appliance Storage Node
Troubleshooting the hardware installation
Hardware setup appears to hang
HE error: Error synchronizing with SANtricity OS Software
Troubleshooting connection issues
Unable to connect to StorageGRID appliance over the network
Rebooting the controller while the StorageGRID Appliance Installer is running
Maintaining the SG5600 appliance
Upgrading SANtricity OS Software on the storage controllers using the Grid Manager
Upgrading SANtricity OS Software on the E2700 controller using maintenance mode
Replacing the E2700 controller
Replacing the E5600SG controller
Replacing other hardware components
Changing the link configuration of the E5600SG controller
Changing the MTU setting
Installing and upgrading software
Upgrading StorageGRID
About StorageGRID 11.4
What's new in StorageGRID 11.4
Removed or deprecated features
Changes to the Grid Management API
Changes to the Tenant Management API
Upgrade planning and preparation
Estimating the time to complete an upgrade
How your system is affected during the upgrade
Impact of an upgrade on groups and user accounts
Verifying the installed version of StorageGRID
Obtaining the required materials for a software upgrade
Web browser requirements
Downloading the StorageGRID upgrade file
Downloading the Recovery Package
Checking the system's condition before upgrading software
Performing the upgrade
Linux: Installing the RPM or DEB package on all hosts
Starting the upgrade
Upgrading grid nodes and completing the upgrade
Modifying your configuration after the upgrade
Troubleshooting upgrade issues
Troubleshooting user interface issues
"Docker image availability check" error messages
VMware installation
Installation overview
Planning and preparation
Required materials
Downloading and extracting the StorageGRID installation files
Hardware requirements
Software requirements
Virtual machine requirements
Networking requirements
Network model
Networking guidelines
Network installation and provisioning
Internal grid node communications
External communications
Networking and ports for platform services and Cloud Storage Pools
Storage and performance requirements
Web browser requirements
Deploying virtual machine grid nodes in VMware vSphere Web Client
Collecting information about your deployment environment
How grid nodes discover the primary Admin Node
Deploying the primary Admin Node virtual machine
Deploying additional grid node virtual machines
Configuring the grid and completing installation
Navigating to the Grid Manager
Specifying the StorageGRID license information
Adding sites
Specifying Grid Network subnets
Approving pending grid nodes
Specifying Network Time Protocol server information
Specifying Domain Name System server information
Specifying the StorageGRID system passwords
Reviewing your configuration and completing installation
Automating the installation
Automating grid node deployment in VMware vSphere
Defining the configuration file for your deployment
Configuration file settings
Running the Bash script
Automating the configuration of StorageGRID
Automating the configuration and installation of appliance Storage Nodes
Overview of installation REST APIs
Where to go next
Troubleshooting installation issues
Virtual machine resource reservation requires adjustment
Red Hat Enterprise Linux or CentOS installation
Installation overview
Planning and preparation
Required materials
Downloading and extracting the StorageGRID installation files
Hardware requirements
Networking requirements
Network model
Networking guidelines
Network installation and provisioning
Host network configuration
Deployment tools
Internal grid node communications
External communications
Networking and ports for platform services and Cloud Storage Pools
Storage requirements
Node container migration requirements
Web browser requirements
Preparing the hosts
Installing Linux
Configuring the host network
Example 1: 1-to-1 mapping to physical or virtual NICs
Example 2: LACP bond carrying VLANs
Configuring host storage
Configuring the Docker storage volume
Installing Docker
Installing StorageGRID host services
Deploying virtual grid nodes
Creating node configuration files
How grid nodes discover the primary Admin Node
Example node configuration files
Validating the StorageGRID configuration
Starting the StorageGRID host service
Configuring the grid and completing installation
Navigating to the Grid Manager
Specifying the StorageGRID license information
Adding sites
Specifying Grid Network subnets
Approving pending grid nodes
Specifying Network Time Protocol server information
Specifying Domain Name System server information
Specifying the StorageGRID system passwords
Reviewing your configuration and completing installation
Automating the installation
Automating the installation and configuration of the StorageGRID host service
Automating the configuration and installation of appliance Storage Nodes
Automating the configuration of StorageGRID
Overview of installation REST APIs
Where to go next
Troubleshooting installation issues
Sample /etc/sysconfig/network-scripts
Ubuntu or Debian installation
Installation overview
Planning and preparation
Required materials
Downloading and extracting the StorageGRID installation files
Hardware requirements
Networking requirements
Network model
Networking guidelines
Network installation and provisioning
Host network configuration
Deployment tools
Internal grid node communications
External communications
Networking and ports for platform services and Cloud Storage Pools
Storage requirements
Node container migration requirements
Web browser requirements
Preparing the hosts
Installing Linux
Understanding AppArmor profile installation
Configuring the host network
Example 1: 1-to-1 mapping to physical or virtual NICs
Example 2: LACP bond carrying VLANs
Configuring host storage
Configuring the Docker storage volume
Installing Docker
Installing StorageGRID host services
Deploying virtual grid nodes
Creating node configuration files
How grid nodes discover the primary Admin Node
Example node configuration files
Validating the StorageGRID configuration
Starting the StorageGRID host service
Configuring the grid and completing installation
Navigating to the Grid Manager
Specifying the StorageGRID license information
Adding sites
Specifying Grid Network subnets
Approving pending grid nodes
Specifying Network Time Protocol server information
Specifying Domain Name System server information
Specifying the StorageGRID system passwords
Reviewing your configuration and completing installation
Automating the installation
Automating the installation and configuration of the StorageGRID host service
Automating the configuration and installation of appliance Storage Nodes
Automating the configuration of StorageGRID
Overview of installation REST APIs
Where to go next
Troubleshooting installation issues
Sample /etc/network/interfaces
Upgrading StorageGRID
About StorageGRID 11.4
What's new in StorageGRID 11.4
Removed or deprecated features
Changes to the Grid Management API
Changes to the Tenant Management API
Upgrade planning and preparation
Estimating the time to complete an upgrade
How your system is affected during the upgrade
Impact of an upgrade on groups and user accounts
Verifying the installed version of StorageGRID
Obtaining the required materials for a software upgrade
Web browser requirements
Downloading the StorageGRID upgrade file
Downloading the Recovery Package
Checking the system's condition before upgrading software
Performing the upgrade
Linux: Installing the RPM or DEB package on all hosts
Starting the upgrade
Upgrading grid nodes and completing the upgrade
Modifying your configuration after the upgrade
Troubleshooting upgrade issues
Troubleshooting user interface issues
"Docker image availability check" error messages
VMware installation
Installation overview
Planning and preparation
Required materials
Downloading and extracting the StorageGRID installation files
Hardware requirements
Software requirements
Virtual machine requirements
Networking requirements
Network model
Networking guidelines
Network installation and provisioning
Internal grid node communications
External communications
Networking and ports for platform services and Cloud Storage Pools
Storage and performance requirements
Web browser requirements
Deploying virtual machine grid nodes in VMware vSphere Web Client
Collecting information about your deployment environment
How grid nodes discover the primary Admin Node
Deploying the primary Admin Node virtual machine
Deploying additional grid node virtual machines
Configuring the grid and completing installation
Navigating to the Grid Manager
Specifying the StorageGRID license information
Adding sites
Specifying Grid Network subnets
Approving pending grid nodes
Specifying Network Time Protocol server information
Specifying Domain Name System server information
Specifying the StorageGRID system passwords
Reviewing your configuration and completing installation
Automating the installation
Automating grid node deployment in VMware vSphere
Defining the configuration file for your deployment
Configuration file settings
Running the Bash script
Automating the configuration of StorageGRID
Automating the configuration and installation of appliance Storage Nodes
Overview of installation REST APIs
Where to go next
Troubleshooting installation issues
Virtual machine resource reservation requires adjustment
Red Hat Enterprise Linux or CentOS installation
Installation overview
Planning and preparation
Required materials
Downloading and extracting the StorageGRID installation files
Hardware requirements
Networking requirements
Network model
Networking guidelines
Network installation and provisioning
Host network configuration
Deployment tools
Internal grid node communications
External communications
Networking and ports for platform services and Cloud Storage Pools
Storage requirements
Node container migration requirements
Web browser requirements
Preparing the hosts
Installing Linux
Configuring the host network
Example 1: 1-to-1 mapping to physical or virtual NICs
Example 2: LACP bond carrying VLANs
Configuring host storage
Configuring the Docker storage volume
Installing Docker
Installing StorageGRID host services
Deploying virtual grid nodes
Creating node configuration files
How grid nodes discover the primary Admin Node
Example node configuration files
Validating the StorageGRID configuration
Starting the StorageGRID host service
Configuring the grid and completing installation
Navigating to the Grid Manager
Specifying the StorageGRID license information
Adding sites
Specifying Grid Network subnets
Approving pending grid nodes
Specifying Network Time Protocol server information
Specifying Domain Name System server information
Specifying the StorageGRID system passwords
Reviewing your configuration and completing installation
Automating the installation
Automating the installation and configuration of the StorageGRID host service
Automating the configuration and installation of appliance Storage Nodes
Automating the configuration of StorageGRID
Overview of installation REST APIs
Where to go next
Troubleshooting installation issues
Sample /etc/sysconfig/network-scripts
Ubuntu or Debian installation
Installation overview
Planning and preparation
Required materials
Downloading and extracting the StorageGRID installation files
Hardware requirements
Networking requirements
Network model
Networking guidelines
Network installation and provisioning
Host network configuration
Deployment tools
Internal grid node communications
External communications
Networking and ports for platform services and Cloud Storage Pools
Storage requirements
Node container migration requirements
Web browser requirements
Preparing the hosts
Installing Linux
Understanding AppArmor profile installation
Configuring the host network
Example 1: 1-to-1 mapping to physical or virtual NICs
Example 2: LACP bond carrying VLANs
Configuring host storage
Configuring the Docker storage volume
Installing Docker
Installing StorageGRID host services
Deploying virtual grid nodes
Creating node configuration files
How grid nodes discover the primary Admin Node
Example node configuration files
Validating the StorageGRID configuration
Starting the StorageGRID host service
Configuring the grid and completing installation
Navigating to the Grid Manager
Specifying the StorageGRID license information
Adding sites
Specifying Grid Network subnets
Approving pending grid nodes
Specifying Network Time Protocol server information
Specifying Domain Name System server information
Specifying the StorageGRID system passwords
Reviewing your configuration and completing installation
Automating the installation
Automating the installation and configuration of the StorageGRID host service
Automating the configuration and installation of appliance Storage Nodes
Automating the configuration of StorageGRID
Overview of installation REST APIs
Where to go next
Troubleshooting installation issues
Sample /etc/network/interfaces
Performing system administration
Administering StorageGRID
Administering a StorageGRID system
Web browser requirements
Signing in to the Grid Manager
Signing out of the Grid Manager
Changing your password
Changing the browser session timeout
Viewing StorageGRID license information
Updating StorageGRID license information
Using the Grid Management API
Grid Management API operations
Issuing API requests
Grid Management API versioning
Protecting against Cross-Site Request Forgery (CSRF)
Using the API if single sign-on is enabled
Signing in to the API if single sign-on is enabled
Signing out of the API if single sign-on is enabled
Controlling who can administer StorageGRID
Controlling access through firewalls
Using identity federation
Configuring identity federation
Guidelines for configuring an OpenLDAP server
Forcing synchronization with the identity source
Disabling identity federation
Managing admin groups
Creating admin groups
Admin group permissions
Deactivating features from the Grid Management API
Modifying an admin group
Deleting an admin group
Managing local users
Creating a local user
Modifying a local user's account
Deleting a local user's account
Changing a local user's password
Using single sign-on (SSO) for StorageGRID
How single sign-on works
Signing in when SSO is enabled
Signing out when SSO is enabled
Requirements for using single sign-on
Configuring single sign-on
Confirming federated users can sign in
Using sandbox mode
Creating relying party trusts in AD FS
Creating a relying party trust using Windows PowerShell
Creating a relying party trust by importing federation metadata
Creating a relying party trust manually
Testing relying party trusts
Enabling single sign-on
Disabling single sign-on
Temporarily disabling and reenabling single sign-on for one Admin Node
Managing tenants
Creating a tenant account
Creating a tenant account if StorageGRID is not using SSO
Creating a tenant account if SSO is enabled
Changing the password for a tenant's local root user
Editing a tenant account
Deleting a tenant account
Managing platform services for S3 tenant accounts
What platform services are
Networking and ports for platform services
Per-site delivery of platform services messages
Troubleshooting platform services
Monitoring a tenant account's storage usage
Controlling which client operations are permitted
Configuring client connections
Summary: IP addresses and ports for client connections
Managing load balancing
How load balancing works - Load Balancer service
Configuring load balancer endpoints
Creating load balancer endpoints
Editing load balancer endpoints
Removing load balancer endpoints
How load balancing works - CLB service
Managing untrusted Client Networks
Specifying a node's Client Network is untrusted
Managing high availability groups
What an HA group is
How HA groups are used
Configuration options for HA groups
Creating a high availability group
Editing a high availability group
Removing a high availability group
Configuring S3 API endpoint domain names
Enabling HTTP for client communications
Managing StorageGRID networks and connections
Guidelines for StorageGRID networks
Viewing IP addresses
Supported ciphers for outgoing TLS connections
Changing network transfer encryption
Configuring server certificates
Configuring a custom server certificate for the Grid Manager and the Tenant Manager
Restoring the default server certificates for the Grid Manager and the Tenant Manager
Configuring a custom server certificate for connections to the Storage Node or the CLB service
Restoring the default server certificates for the S3 and Swift REST API endpoints
Copying the StorageGRID system's CA certificate
Configuring StorageGRID certificates for ONTAP clients using FabricPool
Configuring Storage proxy settings
Configuring Admin proxy settings
Managing traffic classification policies
Creating traffic classification policies
Editing a traffic classification policy
Deleting a traffic classification policy
Viewing network traffic metrics
What link costs are
Updating link costs
Managing objects through information lifecycle management
How ILM operates throughout an object's life
How objects are ingested
What the data-protection options for ingest are
Advantages, disadvantages, and limitations of the data-protection options
How objects are stored (replication or erasure coding)
What replication is
Why you should not use single-copy replication
What erasure coding is
What erasure coding schemes are
Advantages, disadvantages, and requirements for erasure coding
How object retention is determined
How objects are deleted
How S3 versioned objects are deleted
What an ILM policy is
What an ILM rule is
What ILM rule filtering is
What ILM rule placement instructions are
Preparing to create ILM rules
Creating and assigning storage grades
Configuring storage pools
What a storage pool is
Guidelines for creating storage pools
Using multiple storage pools for cross-site replication
Using a storage pool as a temporary location (deprecated)
Creating a storage pool
Editing a storage pool
Removing a storage pool
Using Cloud Storage Pools
What a Cloud Storage Pool is
Lifecycle of a Cloud Storage Pool object
S3: Lifecycle of a Cloud Storage Pool object
Azure: Lifecycle of a Cloud Storage Pool object
When to use Cloud Storage Pools
Considerations for Cloud Storage Pools
Comparing Cloud Storage Pools and CloudMirror replication
Creating a Cloud Storage Pool
S3: Specifying authentication details for a Cloud Storage Pool
C2S S3: Specifying authentication details for a Cloud Storage Pool
Azure: Specifying authentication details for a Cloud Storage Pool
Editing a Cloud Storage Pool
Removing a Cloud Storage Pool
Troubleshooting Cloud Storage Pools
Configuring Erasure Coding profiles
Creating an Erasure Coding profile
Renaming an Erasure Coding profile
Deactivating an Erasure Coding profile
Configuring regions (optional and S3 only)
Creating an ILM rule
Step 1 of 3: Define basics
Using advanced filters in ILM rules
Step 2 of 3: Define placements
Using Last Access Time in ILM rules
Step 3 of 3: Define ingest behavior
Creating, simulating, and activating an ILM policy
Creating a proposed ILM policy
Simulating an ILM policy
Examples for simulating ILM policies
Example 1: Verifying rules when simulating a proposed ILM policy
Example 2: Reordering rules when simulating a proposed ILM policy
Example 3: Correcting a rule when simulating a proposed ILM policy
Activating the ILM policy
Verifying an ILM policy with object metadata lookup
Working with ILM rules and ILM policies
Deleting an ILM rule
Editing an ILM rule
Cloning an ILM rule
Viewing the ILM policy activity queue
Example ILM rules and policies
Example 1: ILM rules and policy for object storage
ILM rule 1 for example 1: Copy object data to two data centers
ILM rule 2 for example 1: Erasure Coding profile with bucket matching
ILM policy for example 1
Example 2: ILM rules and policy for EC object size filtering
ILM rule 1 for example 2: Use EC for all objects larger than 200 KB
ILM rule 2 for example 2: Make 2 copies
ILM policy for example 2: Use EC for objects larger than 200 KB
Example 3: ILM rules and policy for better protection for image files
ILM rule 1 for example 3: Use EC for image files larger than 200 KB
ILM rule 2 for example 3: Replicate 3 copies for all remaining image files
ILM policy for example 3: Better protection for image files
Example 4: ILM rules and policy for S3 versioned objects
ILM rule 1 for example 4: Save three copies for 10 years
ILM rule 2 for example 4: Save two copies of noncurrent versions for 2 years
ILM policy for example 4: S3 versioned objects
Example 5: ILM rules and policy for Strict ingest behavior
ILM rule 1 for example 5: Strict ingest to guarantee Paris data center
ILM rule 2 for example 5: Balanced ingest for other objects
ILM policy for example 5: Combining ingest behaviors
Example 6: Changing an ILM policy
Active ILM policy for example 6: Data protection at two sites
Proposed ILM policy for example 6: Data protection at three sites
Activating the proposed ILM policy for example 6
Managing S3 buckets and objects for compliance
How StorageGRID protects compliant data
Compliance workflow
Considerations for compliance
Enabling compliance
Example: Using compliant ILM rules in an ILM policy
S3 bucket for compliance example: bank-records
ILM rule 1 for compliance example: Erasure Coding profile with bucket matching
ILM rule 2 for compliance example: Non-compliant rule
ILM rule 3 for compliance example: Default rule
ILM policy for compliance example
Resolving consistency errors when updating a bucket's compliance configuration
Configuring AutoSupport
Specifying the protocol for AutoSupport messages
Configuring email server settings for AutoSupport
Triggering an AutoSupport message
Enabling AutoSupport on Demand
Disabling weekly AutoSupport messages
Disabling event-triggered AutoSupport messages
Troubleshooting AutoSupport messages
Managing Storage Nodes
What a Storage Node is
What the ADC service is
What the DDS service is
Object counts
Queries
Metadata protection
What the LDR service is
Object stores
Managing Storage Options
What object segmentation is
What Storage Volume watermarks are
What Metadata Reserved Space is
Configuring global settings for stored objects
Configuring stored object compression
Configuring stored object encryption
Configuring stored object hashing
Storage Node configuration settings
Managing full Storage Nodes
Managing Admin Nodes
What an Admin Node is
Using multiple Admin Nodes
Identifying the primary Admin Node
Selecting a preferred sender
Viewing notification status and queues
How Admin Nodes show acknowledged alarms (legacy system)
Configuring audit client access
Configuring audit clients for CIFS
Configuring audit clients for Workgroup
Configuring audit clients for Active Directory
Adding a user or group to a CIFS audit share
Removing a user or group from a CIFS audit share
Changing a CIFS audit share user or group name
Verifying CIFS audit integration
Configuring the audit client for NFS
Adding an NFS audit client to an audit share
Verifying NFS audit integration
Removing an NFS audit client from the audit share
Changing the IP address of an NFS audit client
Managing Archive Nodes
What an Archive Node is
What the ARC service is
Configuring Archive Node connections to archival storage
Archiving to the cloud through the S3 API
Configuring connection settings for the S3 API
Modifying connection settings for S3 API
Modifying the Cloud Tiering Service state
Resetting the Store Failure Count for S3 API connection
Migrating objects from Cloud Tiering - S3 to a Cloud Storage Pool
Archiving to tape through TSM middleware
Configuring connections to TSM middleware
Optimizing an Archive Node for TSM middleware sessions
Configuring the archive state and counters for TSM
Managing an Archive Node when TSM server reaches capacity
Setting Archive Node to read-only if TSM middleware reaches capacity
Configuring Archive Node retrieve settings
Configuring Archive Node replication
Setting Custom alarms for the Archive Node
Integrating Tivoli Storage Manager
Archive Node configuration and operation
Configuration best practices
Completing the Archive Node setup
Installing a new TSM server
Configuring the TSM server
Defining TSM tape and disk storage pools
Defining a domain policy and registering a node
Creating and activating the domain policy
Migrating data into StorageGRID
Confirming capacity of the StorageGRID system
Determining the ILM policy for migrated data
Impact of migration on operations
Scheduling data migration
Monitoring data migration
Creating custom notifications for migration alarms
StorageGRID system hardening
Hardening a StorageGRID system
System hardening guidelines
Hardening guidelines for software upgrades
Hardening guidelines for StorageGRID networks
Hardening guidelines for StorageGRID nodes
Hardening guidelines for server certificates
Other hardening guidelines
Administering StorageGRID
Administering a StorageGRID system
Web browser requirements
Signing in to the Grid Manager
Signing out of the Grid Manager
Changing your password
Changing the browser session timeout
Viewing StorageGRID license information
Updating StorageGRID license information
Using the Grid Management API
Grid Management API operations
Issuing API requests
Grid Management API versioning
Protecting against Cross-Site Request Forgery (CSRF)
Using the API if single sign-on is enabled
Signing in to the API if single sign-on is enabled
Signing out of the API if single sign-on is enabled
Controlling who can administer StorageGRID
Controlling access through firewalls
Using identity federation
Configuring identity federation
Guidelines for configuring an OpenLDAP server
Forcing synchronization with the identity source
Disabling identity federation
Managing admin groups
Creating admin groups
Admin group permissions
Deactivating features from the Grid Management API
Modifying an admin group
Deleting an admin group
Managing local users
Creating a local user
Modifying a local user's account
Deleting a local user's account
Changing a local user's password
Using single sign-on (SSO) for StorageGRID
How single sign-on works
Signing in when SSO is enabled
Signing out when SSO is enabled
Requirements for using single sign-on
Configuring single sign-on
Confirming federated users can sign in
Using sandbox mode
Creating relying party trusts in AD FS
Creating a relying party trust using Windows PowerShell
Creating a relying party trust by importing federation metadata
Creating a relying party trust manually
Testing relying party trusts
Enabling single sign-on
Disabling single sign-on
Temporarily disabling and reenabling single sign-on for one Admin Node
Managing tenants
Creating a tenant account
Creating a tenant account if StorageGRID is not using SSO
Creating a tenant account if SSO is enabled
Changing the password for a tenant's local root user
Editing a tenant account
Deleting a tenant account
Managing platform services for S3 tenant accounts
What platform services are
Networking and ports for platform services
Per-site delivery of platform services messages
Troubleshooting platform services
Monitoring a tenant account's storage usage
Controlling which client operations are permitted
Configuring client connections
Summary: IP addresses and ports for client connections
Managing load balancing
How load balancing works - Load Balancer service
Configuring load balancer endpoints
Creating load balancer endpoints
Editing load balancer endpoints
Removing load balancer endpoints
How load balancing works - CLB service
Managing untrusted Client Networks
Specifying a node's Client Network is untrusted
Managing high availability groups
What an HA group is
How HA groups are used
Configuration options for HA groups
Creating a high availability group
Editing a high availability group
Removing a high availability group
Configuring S3 API endpoint domain names
Enabling HTTP for client communications
Managing StorageGRID networks and connections
Guidelines for StorageGRID networks
Viewing IP addresses
Supported ciphers for outgoing TLS connections
Changing network transfer encryption
Configuring server certificates
Configuring a custom server certificate for the Grid Manager and the Tenant Manager
Restoring the default server certificates for the Grid Manager and the Tenant Manager
Configuring a custom server certificate for connections to the Storage Node or the CLB service
Restoring the default server certificates for the S3 and Swift REST API endpoints
Copying the StorageGRID system's CA certificate
Configuring StorageGRID certificates for ONTAP clients using FabricPool
Configuring Storage proxy settings
Configuring Admin proxy settings
Managing traffic classification policies
Creating traffic classification policies
Editing a traffic classification policy
Deleting a traffic classification policy
Viewing network traffic metrics
What link costs are
Updating link costs
Managing objects through information lifecycle management
How ILM operates throughout an object's life
How objects are ingested
What the data-protection options for ingest are
Advantages, disadvantages, and limitations of the data-protection options
How objects are stored (replication or erasure coding)
What replication is
Why you should not use single-copy replication
What erasure coding is
What erasure coding schemes are
Advantages, disadvantages, and requirements for erasure coding
How object retention is determined
How objects are deleted
How S3 versioned objects are deleted
What an ILM policy is
What an ILM rule is
What ILM rule filtering is
What ILM rule placement instructions are
Preparing to create ILM rules
Creating and assigning storage grades
Configuring storage pools
What a storage pool is
Guidelines for creating storage pools
Using multiple storage pools for cross-site replication
Using a storage pool as a temporary location (deprecated)
Creating a storage pool
Editing a storage pool
Removing a storage pool
Using Cloud Storage Pools
What a Cloud Storage Pool is
Lifecycle of a Cloud Storage Pool object
S3: Lifecycle of a Cloud Storage Pool object
Azure: Lifecycle of a Cloud Storage Pool object
When to use Cloud Storage Pools
Considerations for Cloud Storage Pools
Comparing Cloud Storage Pools and CloudMirror replication
Creating a Cloud Storage Pool
S3: Specifying authentication details for a Cloud Storage Pool
C2S S3: Specifying authentication details for a Cloud Storage Pool
Azure: Specifying authentication details for a Cloud Storage Pool
Editing a Cloud Storage Pool
Removing a Cloud Storage Pool
Troubleshooting Cloud Storage Pools
Configuring Erasure Coding profiles
Creating an Erasure Coding profile
Renaming an Erasure Coding profile
Deactivating an Erasure Coding profile
Configuring regions (optional and S3 only)
Creating an ILM rule
Step 1 of 3: Define basics
Using advanced filters in ILM rules
Step 2 of 3: Define placements
Using Last Access Time in ILM rules
Step 3 of 3: Define ingest behavior
Creating, simulating, and activating an ILM policy
Creating a proposed ILM policy
Simulating an ILM policy
Examples for simulating ILM policies
Example 1: Verifying rules when simulating a proposed ILM policy
Example 2: Reordering rules when simulating a proposed ILM policy
Example 3: Correcting a rule when simulating a proposed ILM policy
Activating the ILM policy
Verifying an ILM policy with object metadata lookup
Working with ILM rules and ILM policies
Deleting an ILM rule
Editing an ILM rule
Cloning an ILM rule
Viewing the ILM policy activity queue
Example ILM rules and policies
Example 1: ILM rules and policy for object storage
ILM rule 1 for example 1: Copy object data to two data centers
ILM rule 2 for example 1: Erasure Coding profile with bucket matching
ILM policy for example 1
Example 2: ILM rules and policy for EC object size filtering
ILM rule 1 for example 2: Use EC for all objects larger than 200 KB
ILM rule 2 for example 2: Make 2 copies
ILM policy for example 2: Use EC for objects larger than 200 KB
Example 3: ILM rules and policy for better protection for image files
ILM rule 1 for example 3: Use EC for image files larger than 200 KB
ILM rule 2 for example 3: Replicate 3 copies for all remaining image files
ILM policy for example 3: Better protection for image files
Example 4: ILM rules and policy for S3 versioned objects
ILM rule 1 for example 4: Save three copies for 10 years
ILM rule 2 for example 4: Save two copies of noncurrent versions for 2 years
ILM policy for example 4: S3 versioned objects
Example 5: ILM rules and policy for Strict ingest behavior
ILM rule 1 for example 5: Strict ingest to guarantee Paris data center
ILM rule 2 for example 5: Balanced ingest for other objects
ILM policy for example 5: Combining ingest behaviors
Example 6: Changing an ILM policy
Active ILM policy for example 6: Data protection at two sites
Proposed ILM policy for example 6: Data protection at three sites
Activating the proposed ILM policy for example 6
Managing S3 buckets and objects for compliance
How StorageGRID protects compliant data
Compliance workflow
Considerations for compliance
Enabling compliance
Example: Using compliant ILM rules in an ILM policy
S3 bucket for compliance example: bank-records
ILM rule 1 for compliance example: Erasure Coding profile with bucket matching
ILM rule 2 for compliance example: Non-compliant rule
ILM rule 3 for compliance example: Default rule
ILM policy for compliance example
Resolving consistency errors when updating a bucket's compliance configuration
Configuring AutoSupport
Specifying the protocol for AutoSupport messages
Configuring email server settings for AutoSupport
Triggering an AutoSupport message
Enabling AutoSupport on Demand
Disabling weekly AutoSupport messages
Disabling event-triggered AutoSupport messages
Troubleshooting AutoSupport messages
Managing Storage Nodes
What a Storage Node is
What the ADC service is
What the DDS service is
Object counts
Queries
Metadata protection
What the LDR service is
Object stores
Managing Storage Options
What object segmentation is
What Storage Volume watermarks are
What Metadata Reserved Space is
Configuring global settings for stored objects
Configuring stored object compression
Configuring stored object encryption
Configuring stored object hashing
Storage Node configuration settings
Managing full Storage Nodes
Managing Admin Nodes
What an Admin Node is
Using multiple Admin Nodes
Identifying the primary Admin Node
Selecting a preferred sender
Viewing notification status and queues
How Admin Nodes show acknowledged alarms (legacy system)
Configuring audit client access
Configuring audit clients for CIFS
Configuring audit clients for Workgroup
Configuring audit clients for Active Directory
Adding a user or group to a CIFS audit share
Removing a user or group from a CIFS audit share
Changing a CIFS audit share user or group name
Verifying CIFS audit integration
Configuring the audit client for NFS
Adding an NFS audit client to an audit share
Verifying NFS audit integration
Removing an NFS audit client from the audit share
Changing the IP address of an NFS audit client
Managing Archive Nodes
What an Archive Node is
What the ARC service is
Configuring Archive Node connections to archival storage
Archiving to the cloud through the S3 API
Configuring connection settings for the S3 API
Modifying connection settings for S3 API
Modifying the Cloud Tiering Service state
Resetting the Store Failure Count for S3 API connection
Migrating objects from Cloud Tiering - S3 to a Cloud Storage Pool
Archiving to tape through TSM middleware
Configuring connections to TSM middleware
Optimizing an Archive Node for TSM middleware sessions
Configuring the archive state and counters for TSM
Managing an Archive Node when TSM server reaches capacity
Setting Archive Node to read-only if TSM middleware reaches capacity
Configuring Archive Node retrieve settings
Configuring Archive Node replication
Setting Custom alarms for the Archive Node
Integrating Tivoli Storage Manager
Archive Node configuration and operation
Configuration best practices
Completing the Archive Node setup
Installing a new TSM server
Configuring the TSM server
Defining TSM tape and disk storage pools
Defining a domain policy and registering a node
Creating and activating the domain policy
Migrating data into StorageGRID
Confirming capacity of the StorageGRID system
Determining the ILM policy for migrated data
Impact of migration on operations
Scheduling data migration
Monitoring data migration
Creating custom notifications for migration alarms
StorageGRID system hardening
Hardening a StorageGRID system
System hardening guidelines
Hardening guidelines for software upgrades
Hardening guidelines for StorageGRID networks
Hardening guidelines for StorageGRID nodes
Hardening guidelines for server certificates
Other hardening guidelines
Using StorageGRID
Using tenant accounts
Using the Tenant Manager
Using a StorageGRID tenant account
Web browser requirements
Signing in to the Tenant Manager
Signing out of the Tenant Manager
Understanding the Tenant Manager Dashboard
Understanding the Tenant Management API
Tenant Management API versioning
Protecting against Cross-Site Request Forgery (CSRF)
Managing system access for tenant users
Using identity federation
Configuring a federated identity source
Guidelines for configuring an OpenLDAP server
Forcing synchronization with the identity source
Disabling identity federation
Managing groups
Creating groups for an S3 tenant
Creating groups for a Swift tenant
Tenant management permissions
Cloning a group
Editing a group
Removing a group
Managing local users
Creating local users
Cloning local users
Editing local users
Changing a local user's password
Removing local users
Managing S3 tenant accounts
Managing S3 access keys
Creating your own S3 access keys
Removing your own S3 access keys
Creating another user's S3 access keys
Removing another user's S3 access keys
Managing S3 buckets
Managing compliant buckets and objects
How StorageGRID protects compliant data
Compliance workflow
Considerations for compliant buckets and objects
Creating an S3 bucket
Configuring compliance settings
Changing the consistency level
Configuring Cross-Origin Resource Sharing (CORS)
Enabling or disabling last access time updates
Deleting an S3 bucket
Managing S3 platform services
What platform services are
Understanding the CloudMirror replication service
Understanding notifications for buckets
Understanding the search integration service
Considerations for using platform services
Configuring platform services endpoints
What a platform services endpoint is
Specifying the URN for a platform services endpoint
Creating a platform services endpoint
Editing or removing a platform services endpoint
Troubleshooting platform services endpoint errors
Configuring CloudMirror replication
Configuring event notifications
Configuring the search integration service
Configuration XML for search integration
Configuring the search integration service
JSON generated by the search integration service
Object metadata included in metadata notifications
Implementing S3 client applications
Support for the S3 REST API
Changes to S3 REST API support
Supported versions
Support for StorageGRID platform services
Configuring tenant accounts and connections
Creating and configuring S3 tenant accounts
How client connections can be configured
Summary: IP addresses and ports for client connections
Deciding to use HTTPS or HTTP connections
Endpoint domain names for S3 requests
Testing your S3 REST API configuration
How StorageGRID implements the S3 REST API
Conflicting client requests
Consistency controls
How StorageGRID ILM rules manage objects
Object versioning
Recommendations for implementing the S3 REST API
S3 REST API supported operations and limitations
Date handling
Common request headers
Common response headers
Authenticating requests
Operations on the service
Operations on buckets
Creating an S3 lifecycle configuration
Custom operations on buckets
Operations on objects
Using server-side encryption
GET Object
HEAD Object
POST Object restore
PUT Object
PUT Object - Copy
Operations for multipart uploads
List Multipart Uploads
Initiate Multipart Upload
Upload Part
Upload Part - Copy
Complete Multipart Upload
Error responses
StorageGRID S3 REST API operations
PUT Bucket request modifications for compliance
GET Bucket compliance request
PUT Bucket compliance request
GET Bucket consistency request
PUT Bucket consistency request
GET Bucket last access time request
PUT Bucket last access time request
DELETE Bucket metadata notification configuration request
GET Bucket metadata notification configuration request
PUT Bucket metadata notification configuration request
JSON generated by the search integration service
Object metadata included in metadata notifications
GET Storage Usage request
Bucket and group access policies
Access policy overview
Consistency control settings for policies
Using the ARN in policy statements
Specifying resources in a policy
Specifying principals in a policy
Specifying permissions in a policy
Using the PutOverwriteObject permission
Specifying conditions in a policy
Specifying variables in a policy
Creating policies requiring special handling
Write-once-read-many (WORM) protection
S3 policy examples
S3 bucket policy examples
S3 group policy examples
Configuring security for the REST API
How StorageGRID provides security for the REST API
Supported hashing and encryption algorithms for TLS libraries
Monitoring and auditing operations
Monitoring object ingest and retrieval rates
Accessing and reviewing audit logs
S3 operations tracked in the audit logs
Benefits of active, idle, and concurrent HTTP connections
Benefits of keeping idle HTTP connections open
Benefits of active HTTP connections
Benefits of concurrent HTTP connections
Separation of HTTP connection pools for read and write operations
Implementing Swift client applications
OpenStack Swift API support in StorageGRID
History of Swift API support in StorageGRID
How StorageGRID implements the Swift REST API
Recommendations for implementing the Swift REST API
Configuring tenant accounts and connections
Creating and configuring Swift tenant accounts
How client connections can be configured
Summary: IP addresses and ports for client connections
Deciding to use HTTPS or HTTP connections
Testing your connection in the Swift API configuration
Swift REST API supported operations
Supported Swift API endpoints
Account operations
Container operations
Object operations
OPTIONS request
Error responses to Swift API operations
StorageGRID Swift REST API operations
GET container consistency request
PUT container consistency request
Configuring security for the REST API
How StorageGRID provides security for the REST API
Supported hashing and encryption algorithms for TLS libraries
Monitoring and auditing operations
Monitoring object ingest and retrieval rates
Accessing and reviewing audit logs
Swift operations tracked in the audit logs
Using tenant accounts
Using the Tenant Manager
Using a StorageGRID tenant account
Web browser requirements
Signing in to the Tenant Manager
Signing out of the Tenant Manager
Understanding the Tenant Manager Dashboard
Understanding the Tenant Management API
Tenant Management API versioning
Protecting against Cross-Site Request Forgery (CSRF)
Managing system access for tenant users
Using identity federation
Configuring a federated identity source
Guidelines for configuring an OpenLDAP server
Forcing synchronization with the identity source
Disabling identity federation
Managing groups
Creating groups for an S3 tenant
Creating groups for a Swift tenant
Tenant management permissions
Cloning a group
Editing a group
Removing a group
Managing local users
Creating local users
Cloning local users
Editing local users
Changing a local user's password
Removing local users
Managing S3 tenant accounts
Managing S3 access keys
Creating your own S3 access keys
Removing your own S3 access keys
Creating another user's S3 access keys
Removing another user's S3 access keys
Managing S3 buckets
Managing compliant buckets and objects
How StorageGRID protects compliant data
Compliance workflow
Considerations for compliant buckets and objects
Creating an S3 bucket
Configuring compliance settings
Changing the consistency level
Configuring Cross-Origin Resource Sharing (CORS)
Enabling or disabling last access time updates
Deleting an S3 bucket
Managing S3 platform services
What platform services are
Understanding the CloudMirror replication service
Understanding notifications for buckets
Understanding the search integration service
Considerations for using platform services
Configuring platform services endpoints
What a platform services endpoint is
Specifying the URN for a platform services endpoint
Creating a platform services endpoint
Editing or removing a platform services endpoint
Troubleshooting platform services endpoint errors
Configuring CloudMirror replication
Configuring event notifications
Configuring the search integration service
Configuration XML for search integration
Configuring the search integration service
JSON generated by the search integration service
Object metadata included in metadata notifications
Implementing S3 client applications
Support for the S3 REST API
Changes to S3 REST API support
Supported versions
Support for StorageGRID platform services
Configuring tenant accounts and connections
Creating and configuring S3 tenant accounts
How client connections can be configured
Summary: IP addresses and ports for client connections
Deciding to use HTTPS or HTTP connections
Endpoint domain names for S3 requests
Testing your S3 REST API configuration
How StorageGRID implements the S3 REST API
Conflicting client requests
Consistency controls
How StorageGRID ILM rules manage objects
Object versioning
Recommendations for implementing the S3 REST API
S3 REST API supported operations and limitations
Date handling
Common request headers
Common response headers
Authenticating requests
Operations on the service
Operations on buckets
Creating an S3 lifecycle configuration
Custom operations on buckets
Operations on objects
Using server-side encryption
GET Object
HEAD Object
POST Object restore
PUT Object
PUT Object - Copy
Operations for multipart uploads
List Multipart Uploads
Initiate Multipart Upload
Upload Part
Upload Part - Copy
Complete Multipart Upload
Error responses
StorageGRID S3 REST API operations
PUT Bucket request modifications for compliance
GET Bucket compliance request
PUT Bucket compliance request
GET Bucket consistency request
PUT Bucket consistency request
GET Bucket last access time request
PUT Bucket last access time request
DELETE Bucket metadata notification configuration request
GET Bucket metadata notification configuration request
PUT Bucket metadata notification configuration request
JSON generated by the search integration service
Object metadata included in metadata notifications
GET Storage Usage request
Bucket and group access policies
Access policy overview
Consistency control settings for policies
Using the ARN in policy statements
Specifying resources in a policy
Specifying principals in a policy
Specifying permissions in a policy
Using the PutOverwriteObject permission
Specifying conditions in a policy
Specifying variables in a policy
Creating policies requiring special handling
Write-once-read-many (WORM) protection
S3 policy examples
S3 bucket policy examples
S3 group policy examples
Configuring security for the REST API
How StorageGRID provides security for the REST API
Supported hashing and encryption algorithms for TLS libraries
Monitoring and auditing operations
Monitoring object ingest and retrieval rates
Accessing and reviewing audit logs
S3 operations tracked in the audit logs
Benefits of active, idle, and concurrent HTTP connections
Benefits of keeping idle HTTP connections open
Benefits of active HTTP connections
Benefits of concurrent HTTP connections
Separation of HTTP connection pools for read and write operations
Implementing Swift client applications
OpenStack Swift API support in StorageGRID
History of Swift API support in StorageGRID
How StorageGRID implements the Swift REST API
Recommendations for implementing the Swift REST API
Configuring tenant accounts and connections
Creating and configuring Swift tenant accounts
How client connections can be configured
Summary: IP addresses and ports for client connections
Deciding to use HTTPS or HTTP connections
Testing your connection in the Swift API configuration
Swift REST API supported operations
Supported Swift API endpoints
Account operations
Container operations
Object operations
OPTIONS request
Error responses to Swift API operations
StorageGRID Swift REST API operations
GET container consistency request
PUT container consistency request
Configuring security for the REST API
How StorageGRID provides security for the REST API
Supported hashing and encryption algorithms for TLS libraries
Monitoring and auditing operations
Monitoring object ingest and retrieval rates
Accessing and reviewing audit logs
Swift operations tracked in the audit logs
Monitoring and maintaining StorageGRID
Monitoring and troubleshooting StorageGRID
Using the Grid Manager for monitoring
Web browser requirements
Viewing the Dashboard
Viewing the Nodes page
Viewing the Overview tab
Viewing the Hardware tab
Viewing the Network tab
Viewing the Storage tab
Viewing the Events tab
Using the Task tab to reboot a grid node
Viewing the Objects tab
Viewing the ILM tab
Viewing the Load Balancer tab
Viewing the Platform Services tab
Viewing information about appliance Storage Nodes
Viewing information about appliance Admin Nodes and Gateway Nodes
Information you should monitor regularly
Monitoring system health
Monitoring node connection states
Viewing current alerts
Viewing resolved alerts
Viewing a specific alert
Viewing legacy alarms
Monitoring storage capacity
Monitoring storage capacity for the entire grid
Monitoring storage capacity for each Storage Node
Monitoring object metadata capacity for each Storage Node
Monitoring information lifecycle management
Monitoring performance, networking, and system resources
Monitoring query latency
Monitoring network connections and performance
Monitoring node-level resources
Monitoring tenant activity
Monitoring archival capacity
Monitoring load balancing operations
Applying hotfixes or upgrading software if necessary
Managing alerts and alarms
Comparing alerts and alarms
Getting started with the alert system
Managing alerts
What alerts are
Managing alert rules
Viewing alert rules
Creating custom alert rules
Editing an alert rule
Disabling an alert rule
Removing a custom alert rule
Managing alert notifications
Setting up SNMP notifications for alerts
Setting up email notifications for alerts
Information included in alert email notifications
How StorageGRID groups alerts in email notifications
Troubleshooting alert email notifications
Silencing alert notifications
Managing alarms (legacy system)
Alarm classes (legacy system)
Alarm triggering logic (legacy system)
Alarm triggering example
Alarms of same severity
Notifications
New services
Alarms and tables
Acknowledging current alarms (legacy system)
Viewing Default alarms (legacy system)
Reviewing historical alarms and alarm frequency (legacy system)
Creating Global Custom alarms (legacy system)
Disabling alarms (legacy system)
Disabling a Default alarm (legacy system)
Disabling Global Custom alarms (legacy system)
Clearing triggered alarms (legacy system)
Configuring notifications for alarms (legacy system)
Types of alarm notifications (legacy system)
Configuring email server settings for alarms (legacy system)
Creating alarm email templates (legacy system)
Creating mailing lists for alarm notifications (legacy system)
Configuring email notifications for alarms (legacy system)
Suppressing alarm notifications for a mailing list (legacy system)
Suppressing email notifications system wide
Using SNMP monitoring
Configuring the SNMP agent
Updating the SNMP agent
Collecting additional StorageGRID data
Using charts and reports
Types of charts and graphs
Chart legend
Displaying charts and graphs
Generating charts
Types of text reports
Generating text reports
Exporting text reports
Monitoring PUT and GET performance
Monitoring object verification operations
Monitoring events
Reviewing previous events
Resetting event counts
Creating custom syslog events
Resetting the count of custom events to zero
Reviewing audit messages
Collecting log files and system data
Triggering an AutoSupport message
Viewing the Grid Topology tree
Reviewing support metrics
Running diagnostics
Creating custom monitoring applications
Troubleshooting a StorageGRID system
Overview of problem determination
Defining the problem
Assessing the risk and impact on the system
Collecting data
Creating a timeline of recent changes
Establishing baselines
Analyzing data
Escalation information checklist
Troubleshooting object and storage issues
Confirming object data locations
Object store (storage volume) failures
Verifying object integrity
What background verification is
Configuring the background verification rate
What foreground verification is
Running foreground verification
Troubleshooting lost and missing object data
Investigating lost objects
Searching for and restoring potentially lost objects
Resetting lost and missing object counts
Troubleshooting the Low object data storage alert
Troubleshooting the Total Usable Space (Percent) (SAVP) alarm
Troubleshooting the Storage Status (SSTS) alarm
Troubleshooting delivery of platform services messages (SMTT alarm)
Troubleshooting the S3 multipart part too small alert
Troubleshooting metadata issues
Troubleshooting the Low metadata storage alert
Troubleshooting the Services: Status - Cassandra (SVST) alarm
Troubleshooting Cassandra Out of Memory errors (SMTT alarm)
Troubleshooting certificate errors
Troubleshooting Admin Node and user interface issues
Troubleshooting sign-on errors
Troubleshooting user interface issues
Checking the status of an unavailable Admin Node
Troubleshooting network, hardware, and platform issues
Troubleshooting "422: Unprocessable Entity" errors
Troubleshooting the Grid Network MTU mismatch alert
Troubleshooting the Network Receive Error (NRER) alarm
Troubleshooting time synchronization errors
Linux: Network connectivity issues
Linux: Node status is "orphaned"
Linux: Troubleshooting IPv6 support
Alerts reference
Commonly used Prometheus metrics
Alarms reference (legacy system)
Alarms that generate SNMP notifications (legacy system)
Log files reference
StorageGRID software logs
Deployment and maintenance logs
Logs for third-party software
About the bycast.log
File rotation for bycast.log
Messages in bycast.log
Message severities in bycast.log
Error codes in bycast.log
Expanding a StorageGRID system
Planning a StorageGRID expansion
Adding storage capacity
Guidelines for adding object capacity
Adding storage capacity for replicated objects
Adding storage capacity for erasure-coded objects
Adding metadata capacity
Adding grid nodes to add capabilities to your system
Adding a new site
Preparing for an expansion
Gathering required materials
Web browser requirements
Downloading and extracting the StorageGRID installation files
Verifying hardware and networking
Overview of expansion procedure
Adding storage volumes to Storage Nodes
VMware: Adding storage volumes to a Storage Node
Linux: Adding direct-attached or SAN volumes to a Storage Node
Adding grid nodes to an existing site or adding a new site
Updating subnets for the Grid Network
Deploying new grid nodes
VMware: Deploying grid nodes
Linux: Deploying grid nodes
Appliances: Deploying Storage, Gateway, or non-primary Admin Nodes
Performing the expansion
Configuring your expanded StorageGRID system
Verifying that the Storage Node is active
Copying the Admin Node database
Copying Prometheus metrics
Copying audit logs
Contacting technical support
Recovery and maintenance
Introduction to StorageGRID recovery and maintenance
Web browser requirements
Downloading the Recovery Package
StorageGRID hotfix procedure
What happens when you apply a hotfix
Hotfix planning and preparation
How your system is affected when you apply a hotfix
Obtaining the required materials for a hotfix
Downloading the hotfix file
Checking the system's condition before applying a hotfix
Applying the hotfix
Grid node recovery procedures
Warnings and considerations for grid node recovery
Gathering required materials for grid node recovery
Downloading and extracting the StorageGRID installation files
Selecting a node recovery procedure
Recovering from Storage Node failures
Recovering a Storage Node that has been down more than 15 days
Recovering a StorageGRID appliance Storage Node
Preparing an appliance Storage Node for reinstallation
Starting StorageGRID appliance installation
Monitoring StorageGRID appliance installation
Selecting Start Recovery to configure the appliance Storage Node
Remounting and reformatting appliance storage volumes ("Manual Steps")
Restoring object data to a storage volume for an appliance
Checking the storage state after recovering an appliance Storage Node
Recovering from storage volume failure where the system drive is intact
Reviewing warnings about storage volume recovery
Identifying and unmounting failed storage volumes
Recovering failed storage volumes and rebuilding the Cassandra database
Restoring object data to a storage volume where the system drive is intact
Checking the storage state after recovering storage volumes
Recovering from system drive failure
Reviewing warnings for Storage Node system drive recovery
Replacing the Storage Node
Selecting Start Recovery to configure the Storage Node
Remounting and reformatting storage volumes ("Manual Steps")
Restoring object data to a storage volume, if required
Checking the storage state after recovering a Storage Node system drive
Recovering from Admin Node failures
Recovering from primary Admin Node failures
Copying audit logs from the failed primary Admin Node
Replacing the primary Admin Node
Configuring the replacement primary Admin Node
Restoring the audit log on the recovered primary Admin Node
Resetting the preferred sender on the recovered primary Admin Node
Restoring the Admin Node database when recovering a primary Admin Node
Restoring Prometheus metrics when recovering a primary Admin Node
Recovering from non-primary Admin Node failures
Copying audit logs from the failed non-primary Admin Node
Replacing a non-primary Admin Node
Selecting Start Recovery to configure a non-primary Admin Node
Restoring the audit log on the recovered non-primary Admin Node
Resetting the preferred sender on the recovered non-primary Admin Node
Restoring the Admin Node database when recovering a non-primary Admin Node
Restoring Prometheus metrics when recovering a non-primary Admin Node
Recovering from Gateway Node failures
Replacing the Gateway Node
Selecting Start Recovery to configure the Gateway Node
Recovering from Archive Node failures
Replacing the Archive Node
Selecting Start Recovery to configure the Archive Node
Resetting Archive Node connection to the cloud
All grid node types: Replacing a VMware node
Removing the failed grid node in VMware vSphere
Deploying the recovery grid node in VMware vSphere
All grid node types: Replacing a Linux node
Deploying new Linux hosts
Restoring grid nodes to the host
Restoring and validating grid nodes
Fixing missing network interface errors
Fixing missing block device errors
Starting the StorageGRID host service
Recovering nodes that fail to start normally
What's next: Performing additional recovery steps, if required
Replacing a failed node with a services appliance
Installing a services appliance (platform change only)
Preparing an appliance for reinstallation (platform replacement only)
Starting software installation on a services appliance
Monitoring services appliance installation
How site recovery is performed by technical support
Decommission procedure
Grid node decommissioning
Preparing to decommission grid nodes
Considerations for removing grid nodes
Considerations for decommissioning Admin Nodes or a Gateway Nodes
Considerations for decommissioning Storage Nodes
Understanding the ADC quorum
Reviewing the ILM policy and storage configuration
Decommissioning disconnected Storage Nodes
Consolidating Storage Nodes
Decommissioning multiple Storage Nodes
Checking data repair jobs
Gathering required materials
Accessing the Decommission Nodes page
Decommissioning disconnected grid nodes
Decommissioning connected grid nodes
Pausing and resuming the decommission process for Storage Nodes
Troubleshooting node decommissioning
Site decommissioning (disconnected sites only)
Considerations for removing a disconnected site
Gathering required materials
Step 1: Select the site
Step 2: Review the site
Step 3: Perform the decommission
Network maintenance procedures
Updating subnets for the Grid Network
Configuring IP addresses
Modifying a node's network configuration
Adding to or changing subnet lists on the Admin Network
Adding to or changing subnet lists on the Grid Network
Linux: Adding interfaces to an existing node
Changing IP addresses for all nodes on the Grid Network
Configuring DNS servers
Modifying the DNS configuration for a single grid node
Configuring NTP servers
Restoring network connectivity for isolated nodes
Host-level and middleware procedures
Linux: Migrating a grid node to a new host
Linux: Exporting the node from the source host
Linux: Importing the node on the target host
Linux: Starting the migrated node
Archive Node maintenance for TSM middleware
Fault with archival storage devices
Taking the Target component offline
Tivoli Storage Manager administrative tools
Object permanently unavailable
Determining if objects are permanently unavailable
VMware: Configuring a virtual machine for automatic restart
Grid node procedures
Viewing Server Manager status and version
Viewing current status of all services
Starting Server Manager and all services
Restarting Server Manager and all services
Stopping Server Manager and all services
Viewing current status of a service
Stopping a service
Forcing a service to terminate
Starting or restarting a service
Removing port remaps
Removing port remaps on bare metal hosts
Rebooting a grid node
Rebooting a grid node from the Grid Manager
Rebooting a grid node from the command shell
Shutting down a grid node
Powering down a host
Powering off and on all nodes in the grid
Stopping services and shutting down grid nodes
Starting up the grid nodes
Using a DoNotStart file
Adding a DoNotStart file for a service
Removing a DoNotStart file for a service
Troubleshooting Server Manager
Accessing the Server Manager log file
Service with an error state
Understanding audit messages
Audit message overview
Audit message flow and retention
Changing audit message levels
Accessing the audit log file
Audit log file rotation
Audit log file and message formats
Audit log file format
Using the audit-explain tool
Using the audit-sum tool
Audit message format
Data types
Event-specific data
Common elements in audit messages
Audit message examples
Audit messages and the object lifecycle
Object ingest transactions
Example: S3 object ingest
Object delete transactions
Example: S3 object deletion
Object retrieve transactions
Example: S3 object retrieval
Metadata update messages
Example: S3 metadata update
Audit messages
Audit message categories
System audit messages
Object storage audit messages
Client read audit messages
Client write audit messages
Management audit message
Audit messages
APCT: Archive Purge from Cloud-Tier
ARCB: Archive Object Retrieve Begin
ARCE: Archive Object Retrieve End
ARCT: Archive Retrieve from Cloud-Tier
AREM: Archive Object Remove
ASCE: Archive Object Store End
ASCT: Archive Store Cloud-Tier
ATCE: Archive Object Store Begin
AVCC: Archive Validate Cloud-Tier Configuration
CBRB: Object Receive Begin
CBRE: Object Receive End
CBSB: Object Send Begin
CBSE: Object Send End
ECOC: Corrupt Erasure Coded Data Fragment
ETAF: Security Authentication Failed
GNRG: GNDS Registration
GNUR: GNDS Unregistration
GTED: Grid Task Ended
GTST: Grid Task Started
GTSU: Grid Task Submitted
IDEL: ILM Initiated Delete
LLST: Location Lost
MGAU: Management audit message
OLST: System Detected Lost Object
ORLM: Object Rules Met
OVWR: Object Overwrite
SADD: Security Audit Disable
SADE: Security Audit Enable
SCMT: Object Store Commit
SDEL: S3 DELETE
SGET: S3 GET
SHEA: S3 HEAD
SPOS: S3 POST
SPUT: S3 PUT
SREM: Object Store Remove
SUPD: S3 Metadata Updated
SVRF: Object Store Verify Fail
SVRU: Object Store Verify Unknown
SYSD: Node Stop
SYST: Node Stopping
SYSU: Node Start
VLST: User Initiated Volume Lost
WDEL: Swift DELETE
WGET: Swift GET
WHEA: Swift HEAD
WPUT: Swift PUT
Monitoring and troubleshooting StorageGRID
Using the Grid Manager for monitoring
Web browser requirements
Viewing the Dashboard
Viewing the Nodes page
Viewing the Overview tab
Viewing the Hardware tab
Viewing the Network tab
Viewing the Storage tab
Viewing the Events tab
Using the Task tab to reboot a grid node
Viewing the Objects tab
Viewing the ILM tab
Viewing the Load Balancer tab
Viewing the Platform Services tab
Viewing information about appliance Storage Nodes
Viewing information about appliance Admin Nodes and Gateway Nodes
Information you should monitor regularly
Monitoring system health
Monitoring node connection states
Viewing current alerts
Viewing resolved alerts
Viewing a specific alert
Viewing legacy alarms
Monitoring storage capacity
Monitoring storage capacity for the entire grid
Monitoring storage capacity for each Storage Node
Monitoring object metadata capacity for each Storage Node
Monitoring information lifecycle management
Monitoring performance, networking, and system resources
Monitoring query latency
Monitoring network connections and performance
Monitoring node-level resources
Monitoring tenant activity
Monitoring archival capacity
Monitoring load balancing operations
Applying hotfixes or upgrading software if necessary
Managing alerts and alarms
Comparing alerts and alarms
Getting started with the alert system
Managing alerts
What alerts are
Managing alert rules
Viewing alert rules
Creating custom alert rules
Editing an alert rule
Disabling an alert rule
Removing a custom alert rule
Managing alert notifications
Setting up SNMP notifications for alerts
Setting up email notifications for alerts
Information included in alert email notifications
How StorageGRID groups alerts in email notifications
Troubleshooting alert email notifications
Silencing alert notifications
Managing alarms (legacy system)
Alarm classes (legacy system)
Alarm triggering logic (legacy system)
Alarm triggering example
Alarms of same severity
Notifications
New services
Alarms and tables
Acknowledging current alarms (legacy system)
Viewing Default alarms (legacy system)
Reviewing historical alarms and alarm frequency (legacy system)
Creating Global Custom alarms (legacy system)
Disabling alarms (legacy system)
Disabling a Default alarm (legacy system)
Disabling Global Custom alarms (legacy system)
Clearing triggered alarms (legacy system)
Configuring notifications for alarms (legacy system)
Types of alarm notifications (legacy system)
Configuring email server settings for alarms (legacy system)
Creating alarm email templates (legacy system)
Creating mailing lists for alarm notifications (legacy system)
Configuring email notifications for alarms (legacy system)
Suppressing alarm notifications for a mailing list (legacy system)
Suppressing email notifications system wide
Using SNMP monitoring
Configuring the SNMP agent
Updating the SNMP agent
Collecting additional StorageGRID data
Using charts and reports
Types of charts and graphs
Chart legend
Displaying charts and graphs
Generating charts
Types of text reports
Generating text reports
Exporting text reports
Monitoring PUT and GET performance
Monitoring object verification operations
Monitoring events
Reviewing previous events
Resetting event counts
Creating custom syslog events
Resetting the count of custom events to zero
Reviewing audit messages
Collecting log files and system data
Triggering an AutoSupport message
Viewing the Grid Topology tree
Reviewing support metrics
Running diagnostics
Creating custom monitoring applications
Troubleshooting a StorageGRID system
Overview of problem determination
Defining the problem
Assessing the risk and impact on the system
Collecting data
Creating a timeline of recent changes
Establishing baselines
Analyzing data
Escalation information checklist
Troubleshooting object and storage issues
Confirming object data locations
Object store (storage volume) failures
Verifying object integrity
What background verification is
Configuring the background verification rate
What foreground verification is
Running foreground verification
Troubleshooting lost and missing object data
Investigating lost objects
Searching for and restoring potentially lost objects
Resetting lost and missing object counts
Troubleshooting the Low object data storage alert
Troubleshooting the Total Usable Space (Percent) (SAVP) alarm
Troubleshooting the Storage Status (SSTS) alarm
Troubleshooting delivery of platform services messages (SMTT alarm)
Troubleshooting the S3 multipart part too small alert
Troubleshooting metadata issues
Troubleshooting the Low metadata storage alert
Troubleshooting the Services: Status - Cassandra (SVST) alarm
Troubleshooting Cassandra Out of Memory errors (SMTT alarm)
Troubleshooting certificate errors
Troubleshooting Admin Node and user interface issues
Troubleshooting sign-on errors
Troubleshooting user interface issues
Checking the status of an unavailable Admin Node
Troubleshooting network, hardware, and platform issues
Troubleshooting "422: Unprocessable Entity" errors
Troubleshooting the Grid Network MTU mismatch alert
Troubleshooting the Network Receive Error (NRER) alarm
Troubleshooting time synchronization errors
Linux: Network connectivity issues
Linux: Node status is "orphaned"
Linux: Troubleshooting IPv6 support
Alerts reference
Commonly used Prometheus metrics
Alarms reference (legacy system)
Alarms that generate SNMP notifications (legacy system)
Log files reference
StorageGRID software logs
Deployment and maintenance logs
Logs for third-party software
About the bycast.log
File rotation for bycast.log
Messages in bycast.log
Message severities in bycast.log
Error codes in bycast.log
Expanding a StorageGRID system
Planning a StorageGRID expansion
Adding storage capacity
Guidelines for adding object capacity
Adding storage capacity for replicated objects
Adding storage capacity for erasure-coded objects
Adding metadata capacity
Adding grid nodes to add capabilities to your system
Adding a new site
Preparing for an expansion
Gathering required materials
Web browser requirements
Downloading and extracting the StorageGRID installation files
Verifying hardware and networking
Overview of expansion procedure
Adding storage volumes to Storage Nodes
VMware: Adding storage volumes to a Storage Node
Linux: Adding direct-attached or SAN volumes to a Storage Node
Adding grid nodes to an existing site or adding a new site
Updating subnets for the Grid Network
Deploying new grid nodes
VMware: Deploying grid nodes
Linux: Deploying grid nodes
Appliances: Deploying Storage, Gateway, or non-primary Admin Nodes
Performing the expansion
Configuring your expanded StorageGRID system
Verifying that the Storage Node is active
Copying the Admin Node database
Copying Prometheus metrics
Copying audit logs
Contacting technical support
Recovery and maintenance
Introduction to StorageGRID recovery and maintenance
Web browser requirements
Downloading the Recovery Package
StorageGRID hotfix procedure
What happens when you apply a hotfix
Hotfix planning and preparation
How your system is affected when you apply a hotfix
Obtaining the required materials for a hotfix
Downloading the hotfix file
Checking the system's condition before applying a hotfix
Applying the hotfix
Grid node recovery procedures
Warnings and considerations for grid node recovery
Gathering required materials for grid node recovery
Downloading and extracting the StorageGRID installation files
Selecting a node recovery procedure
Recovering from Storage Node failures
Recovering a Storage Node that has been down more than 15 days
Recovering a StorageGRID appliance Storage Node
Preparing an appliance Storage Node for reinstallation
Starting StorageGRID appliance installation
Monitoring StorageGRID appliance installation
Selecting Start Recovery to configure the appliance Storage Node
Remounting and reformatting appliance storage volumes ("Manual Steps")
Restoring object data to a storage volume for an appliance
Checking the storage state after recovering an appliance Storage Node
Recovering from storage volume failure where the system drive is intact
Reviewing warnings about storage volume recovery
Identifying and unmounting failed storage volumes
Recovering failed storage volumes and rebuilding the Cassandra database
Restoring object data to a storage volume where the system drive is intact
Checking the storage state after recovering storage volumes
Recovering from system drive failure
Reviewing warnings for Storage Node system drive recovery
Replacing the Storage Node
Selecting Start Recovery to configure the Storage Node
Remounting and reformatting storage volumes ("Manual Steps")
Restoring object data to a storage volume, if required
Checking the storage state after recovering a Storage Node system drive
Recovering from Admin Node failures
Recovering from primary Admin Node failures
Copying audit logs from the failed primary Admin Node
Replacing the primary Admin Node
Configuring the replacement primary Admin Node
Restoring the audit log on the recovered primary Admin Node
Resetting the preferred sender on the recovered primary Admin Node
Restoring the Admin Node database when recovering a primary Admin Node
Restoring Prometheus metrics when recovering a primary Admin Node
Recovering from non-primary Admin Node failures
Copying audit logs from the failed non-primary Admin Node
Replacing a non-primary Admin Node
Selecting Start Recovery to configure a non-primary Admin Node
Restoring the audit log on the recovered non-primary Admin Node
Resetting the preferred sender on the recovered non-primary Admin Node
Restoring the Admin Node database when recovering a non-primary Admin Node
Restoring Prometheus metrics when recovering a non-primary Admin Node
Recovering from Gateway Node failures
Replacing the Gateway Node
Selecting Start Recovery to configure the Gateway Node
Recovering from Archive Node failures
Replacing the Archive Node
Selecting Start Recovery to configure the Archive Node
Resetting Archive Node connection to the cloud
All grid node types: Replacing a VMware node
Removing the failed grid node in VMware vSphere
Deploying the recovery grid node in VMware vSphere
All grid node types: Replacing a Linux node
Deploying new Linux hosts
Restoring grid nodes to the host
Restoring and validating grid nodes
Fixing missing network interface errors
Fixing missing block device errors
Starting the StorageGRID host service
Recovering nodes that fail to start normally
What's next: Performing additional recovery steps, if required
Replacing a failed node with a services appliance
Installing a services appliance (platform change only)
Preparing an appliance for reinstallation (platform replacement only)
Starting software installation on a services appliance
Monitoring services appliance installation
How site recovery is performed by technical support
Decommission procedure
Grid node decommissioning
Preparing to decommission grid nodes
Considerations for removing grid nodes
Considerations for decommissioning Admin Nodes or a Gateway Nodes
Considerations for decommissioning Storage Nodes
Understanding the ADC quorum
Reviewing the ILM policy and storage configuration
Decommissioning disconnected Storage Nodes
Consolidating Storage Nodes
Decommissioning multiple Storage Nodes
Checking data repair jobs
Gathering required materials
Accessing the Decommission Nodes page
Decommissioning disconnected grid nodes
Decommissioning connected grid nodes
Pausing and resuming the decommission process for Storage Nodes
Troubleshooting node decommissioning
Site decommissioning (disconnected sites only)
Considerations for removing a disconnected site
Gathering required materials
Step 1: Select the site
Step 2: Review the site
Step 3: Perform the decommission
Network maintenance procedures
Updating subnets for the Grid Network
Configuring IP addresses
Modifying a node's network configuration
Adding to or changing subnet lists on the Admin Network
Adding to or changing subnet lists on the Grid Network
Linux: Adding interfaces to an existing node
Changing IP addresses for all nodes on the Grid Network
Configuring DNS servers
Modifying the DNS configuration for a single grid node
Configuring NTP servers
Restoring network connectivity for isolated nodes
Host-level and middleware procedures
Linux: Migrating a grid node to a new host
Linux: Exporting the node from the source host
Linux: Importing the node on the target host
Linux: Starting the migrated node
Archive Node maintenance for TSM middleware
Fault with archival storage devices
Taking the Target component offline
Tivoli Storage Manager administrative tools
Object permanently unavailable
Determining if objects are permanently unavailable
VMware: Configuring a virtual machine for automatic restart
Grid node procedures
Viewing Server Manager status and version
Viewing current status of all services
Starting Server Manager and all services
Restarting Server Manager and all services
Stopping Server Manager and all services
Viewing current status of a service
Stopping a service
Forcing a service to terminate
Starting or restarting a service
Removing port remaps
Removing port remaps on bare metal hosts
Rebooting a grid node
Rebooting a grid node from the Grid Manager
Rebooting a grid node from the command shell
Shutting down a grid node
Powering down a host
Powering off and on all nodes in the grid
Stopping services and shutting down grid nodes
Starting up the grid nodes
Using a DoNotStart file
Adding a DoNotStart file for a service
Removing a DoNotStart file for a service
Troubleshooting Server Manager
Accessing the Server Manager log file
Service with an error state
Understanding audit messages
Audit message overview
Audit message flow and retention
Changing audit message levels
Accessing the audit log file
Audit log file rotation
Audit log file and message formats
Audit log file format
Using the audit-explain tool
Using the audit-sum tool
Audit message format
Data types
Event-specific data
Common elements in audit messages
Audit message examples
Audit messages and the object lifecycle
Object ingest transactions
Example: S3 object ingest
Object delete transactions
Example: S3 object deletion
Object retrieve transactions
Example: S3 object retrieval
Metadata update messages
Example: S3 metadata update
Audit messages
Audit message categories
System audit messages
Object storage audit messages
Client read audit messages
Client write audit messages
Management audit message
Audit messages
APCT: Archive Purge from Cloud-Tier
ARCB: Archive Object Retrieve Begin
ARCE: Archive Object Retrieve End
ARCT: Archive Retrieve from Cloud-Tier
AREM: Archive Object Remove
ASCE: Archive Object Store End
ASCT: Archive Store Cloud-Tier
ATCE: Archive Object Store Begin
AVCC: Archive Validate Cloud-Tier Configuration
CBRB: Object Receive Begin
CBRE: Object Receive End
CBSB: Object Send Begin
CBSE: Object Send End
ECOC: Corrupt Erasure Coded Data Fragment
ETAF: Security Authentication Failed
GNRG: GNDS Registration
GNUR: GNDS Unregistration
GTED: Grid Task Ended
GTST: Grid Task Started
GTSU: Grid Task Submitted
IDEL: ILM Initiated Delete
LLST: Location Lost
MGAU: Management audit message
OLST: System Detected Lost Object
ORLM: Object Rules Met
OVWR: Object Overwrite
SADD: Security Audit Disable
SADE: Security Audit Enable
SCMT: Object Store Commit
SDEL: S3 DELETE
SGET: S3 GET
SHEA: S3 HEAD
SPOS: S3 POST
SPUT: S3 PUT
SREM: Object Store Remove
SUPD: S3 Metadata Updated
SVRF: Object Store Verify Fail
SVRU: Object Store Verify Unknown
SYSD: Node Stop
SYST: Node Stopping
SYSU: Node Start
VLST: User Initiated Volume Lost
WDEL: Swift DELETE
WGET: Swift GET
WHEA: Swift HEAD
WPUT: Swift PUT
Using this Documentation Center
Tour
Help
Searching for content
Applying a filter
Printing content
Saving and sharing links
Providing feedback
Downloading PDFs or EPUBs for offline use
Tips
Better search results
Mobile devices
Mixed-language environment
Tour
Help
Searching for content
Applying a filter
Printing content
Saving and sharing links
Providing feedback
Downloading PDFs or EPUBs for offline use
Tips
Better search results
Mobile devices
Mixed-language environment
Legal notices
Copyright, trademark, patent, privacy, and machine translation
Copyright
Trademark
Patent
Privacy
Machine translation
Open source
StorageGRID
Copyright, trademark, patent, privacy, and machine translation
Copyright
Trademark
Patent
Privacy
Machine translation
Open source
StorageGRID