StorageGRID 11.6 Docs
Release notes
Get started
Grid primer
Overview
Hybrid clouds with StorageGRID
Architecture and network topology
Object management
How StorageGRID manages data
Object lifecycle
The life of an object
Ingest data flow
Copy management
Retrieve data flow
Delete data flow
How to use StorageGRID
Explore Grid Manager
Explore Tenant Manager
Control StorageGRID access
Manage tenants and client connections
Configure network settings
Configure security settings
Configure system settings
Use information lifecycle management
Monitor operations
View Nodes page
Monitor and manage alerts
Use SNMP monitoring
Review audit messages
Perform maintenance
Download Recovery Package
Use support options
Networking guidelines
Overview
StorageGRID network types
Network topology examples
Grid Network topology
Admin Network topology
Client Network topology
Topology for all three networks
Networking requirements
Network-specific requirements
Deployment-specific networking considerations
Linux deployments
Networking and ports for platform services and Cloud Storage Pools
Appliance nodes
Network installation and provisioning
Post-installation guidelines
Network port reference
Internal grid node communications
External communications
Install and maintain appliance hardware
SG100 and SG1000 services appliances
Overview
SG100 and SG1000 applications
Installation and deployment overview
Prepare for installation (SG100 and SG1000)
Prepare site (SG100 and SG1000)
Unpack boxes (SG100 and SG1000)
Obtain additional equipment and tools (SG100 and SG1000)
Review appliance network connections (SG100 and SG1000)
Port bond modes for SG100 and SG1000 appliances
Network bond modes
Network bond modes for management ports
Gather installation information (SG100 and SG1000)
Install hardware (SG100 and SG1000)
Register hardware
Install appliance into cabinet or rack (SG100 and SG1000)
Cable appliance (SG100 and SG1000)
Connect power cords and apply power (SG100 and SG1000)
View status indicators on SG100 and SG1000 appliances
Configure StorageGRID connections (SG100 and SG1000)
Access StorageGRID Appliance Installer
Verify and upgrade StorageGRID Appliance Installer version
Configure network links (SG100 and SG1000)
Configure StorageGRID IP addresses
Verify network connections
Verify port-level network connections
Configure BMC interface (SG100 and SG1000)
Change root password for BMC interface
Set IP address for BMC management port
Access BMC interface
Configure SNMP settings for services appliance
Set up email notifications for alerts
Optional: Enable node encryption
Deploy services appliance node
Deploy services appliance as primary Admin Node
Deploy services appliance as Gateway or non-primary Admin Node
Monitor services appliance installation
Automate appliance installation and configuration (SG100 and SG1000)
Automate appliance configuration using StorageGRID Appliance Installer
Automate installation and configuration of appliance nodes using configure-sga.py script
Automate configuration of StorageGRID
Overview of installation REST APIs
Troubleshoot hardware installation (SG100 and SG1000)
View boot-up codes for appliance
View error codes for appliance
Hardware setup appears to hang (SG100 and SG1000)
Troubleshoot connection issues (SG100 and SG1000)
Reboot services appliance while StorageGRID Appliance Installer is running
Maintain appliance
Place appliance into maintenance mode
Turn controller identify LED on and off
Locate controller in data center
Shut down the appliance
Replace the services appliance
Replace one or both power supplies in the services appliance
Replace fan in services appliance
Replace drive in services appliance
Change link configuration of services appliance
Change MTU setting
Check DNS server configuration
Monitor node encryption in maintenance mode (SG100 and SG1000)
Clear key management server configuration
SG6000 storage appliances
Overview
SG6060 and SG6060X overview
SGF6024 overview
Controllers in SG6000 appliances
Installation and deployment overview
Prepare for installation (SG6000)
Prepare site (SG6000)
Unpack boxes (SG6000)
Obtain additional equipment and tools (SG6000)
Review appliance network connections (SG6000)
Port bond modes for SG6000-CN controller
Network bond modes for 10/25-GbE ports
Network bond modes for 1-GbE management ports
Gather installation information (SG6000)
Install hardware (SG6000)
Register hardware
SG6060 and SG6060X: Install 60-drive shelves into cabinet or rack
SG6060 and SG6060X: Install drives
SGF6024: Install 24-drive shelves into cabinet or rack
SG6000-CN: Install into cabinet or rack
Cable appliance (SG6000)
SG6060 and SG6060X: Cable optional expansion shelves
Connect power cords and apply power (SG6000)
View status indicators and buttons on SG6000-CN controller
View boot-up status codes for SG6000 and SG6060X storage controllers
Configure hardware (SG6000)
Configure StorageGRID connections (SG6000)
Access StorageGRID Appliance Installer
Verify and upgrade StorageGRID Appliance Installer version
Configure network links (SG6000)
Configure StorageGRID IP addresses
Verify network connections
Verify port-level network connections
Access and configure SANtricity System Manager (SG6000)
Set up and access SANtricity System Manager
Review hardware status in SANtricity System Manager
Set IP addresses for storage controllers using StorageGRID Appliance Installer
Configure BMC interface (SG6000)
Change root password for BMC interface
Set IP address for BMC management port
Access BMC interface
Configure SNMP settings for SG6000-CN controller
Set up email notifications for alerts
Optional: Enable node encryption
Optional: Change RAID mode (SG6000 only)
Optional: Remap network ports for appliance
Deploy appliance Storage Node
Monitor storage appliance installation
Automate appliance installation and configuration (SG6000)
Automate appliance configuration using StorageGRID Appliance Installer
Automate installation and configuration of appliance nodes using configure-sga.py script
Automate configuration of StorageGRID
Overview of installation REST APIs
Troubleshoot hardware installation (SG6000)
View boot-up codes for SG6000-CN controller
View error codes for SG6000-CN controller
Hardware setup appears to hang
Troubleshoot connection issues (SG6000)
Unable to connect to appliance
Expansion shelves do not appear in Appliance Installer
Reboot SG6000-CN controller while StorageGRID Appliance Installer is running
Maintain SG6000 appliance
Place appliance into maintenance mode
Upgrade SANtricity OS on storage controllers
Upgrade SANtricity OS on storage controllers using Grid Manager
Upgrade SANtricity OS on storage controllers using maintenance mode
Upgrade drive firmware using SANtricity System Manager
Add expansion shelf to deployed SG6060
Turn controller identify LED on and off
Locate controller in data center
Replace storage controller
Replace hardware components in storage controller shelf
Replace hardware components in optional 60-drive expansion shelf
Shut down SG6000-CN controller
Power on SG6000-CN controller and verify operation
Replace SG6000-CN controller
Replace one or both power supplies in the SG6000-CN controller
Remove SG6000-CN controller from cabinet or rack
Reinstall SG6000-CN controller into cabinet or rack
Remove SG6000-CN controller cover
Reinstall SG6000-CN controller cover
Replace Fibre Channel HBA in SG6000-CN controller
Verify Fibre Channel HBA to replace
Remove Fibre Channel HBA
Reinstall Fibre Channel HBA
Change link configuration of SG6000-CN controller
Change MTU setting
Check DNS server configuration
Monitor node encryption in maintenance mode (SG6000)
Clear key management server configuration
SG5700 storage appliances
Overview
Controllers in StorageGRID appliance
Installation and deployment overview
Prepare for installation (SG5700)
Prepare site (SG5700)
Unpack boxes (SG5700)
Obtain additional equipment and tools (SG5700)
Review appliance network connections (SG5700)
Port bond modes for E5700SG controller ports
Network bond modes for 10/25-GbE ports
Network bond modes for 1-GbE management ports
Gather installation information (SG5700)
Install hardware (SG5700)
Register hardware
Install appliance in cabinet or rack (SG5700)
Cable appliance (SG5700)
Connect power cords and apply power (SG5700)
View SG5700 boot-up status codes
Status indicators on E5700SG controller
Configure hardware (SG5700)
Configure StorageGRID connections (SG5700)
Access StorageGRID Appliance Installer
Verify and upgrade StorageGRID Appliance Installer version
Configure network links (SG5700)
Set IP configuration
Verify network connections
Verify port-level network connections
Access and configure SANtricity System Manager (SG5700)
Set up and access SANtricity System Manager
Review hardware status in SANtricity System Manager
Set IP addresses for storage controllers using StorageGRID Appliance Installer
Optional: Enable node encryption
Optional: Change RAID mode (SG5760 only)
Optional: Remap network ports for appliance
Deploy appliance Storage Node
Monitor storage appliance installation
Automate appliance installation and configuration (SG5700)
Automate appliance configuration using StorageGRID Appliance Installer
Automate installation and configuration of appliance nodes using configure-sga.py script
Automate configuration of StorageGRID
Overview of installation REST APIs
Troubleshoot hardware installation (SG5700)
Hardware setup appears to hang (SG5700)
HE error: Error synchronizing with SANtricity OS Software
Troubleshoot connection issues (SG5700)
Reboot controller while StorageGRID Appliance Installer is running
Maintain SG5700 appliance
Place appliance into maintenance mode
Upgrade SANtricity OS on storage controller
Upgrade SANtricity OS on storage controllers using Grid Manager
Upgrade SANtricity OS on E2800 controller using maintenance mode
Upgrade drive firmware using SANtricity System Manager
Replace E2800 controller
Replace E5700SG controller
Replace other hardware components
Change link configuration of E5700SG controller
Change MTU setting
Check DNS server configuration
Monitor node encryption in maintenance mode (SG5700)
Clear key management server configuration
SG5600 storage appliances
Overview
StorageGRID appliance features
Hardware diagrams
Installation and deployment overview
Prepare for installation (SG5600)
Prepare site (SG5600)
Unpack boxes (SG5600)
Obtain additional equipment and tools (SG5600)
Service laptop requirements
Review appliance network connections (SG5600)
Port bond modes for E5600SG controller ports
Network bond modes for 10-GbE ports
Network bond modes for 1-GbE management ports
Gather installation information (SG5600)
Install hardware (SG5600)
Register hardware
Install appliance in cabinet or rack (SG5600)
Cable appliance (SG5600)
Connect AC power cords (SG5600)
Turn power on (SG5600)
View boot-up status and review error codes on SG5600 controllers
E5600SG controller seven-segment display codes
Configure hardware (SG5600)
Configure StorageGRID connections (SG5600)
Access StorageGRID Appliance Installer
Verify and upgrade StorageGRID Appliance Installer version
Configure network links (SG5600)
Set IP configuration
Verify network connections
Verify port-level network connections
Configure SANtricity Storage Manager
Set IP address for E2700 controller
Add appliance to SANtricity Storage Manager
Set up SANtricity Storage Manager
Configure AutoSupport
Verify receipt of AutoSupport
Configure email and SNMP trap alert notifications
Set passwords for SANtricity Storage Manager
Optional: Enable node encryption
Optional: Change to RAID6 mode (SG5660 only)
Optional: Remap network ports for appliance
Deploy appliance Storage Node
Monitor storage appliance installation
Automate appliance installation and configuration (SG5600)
Automate appliance configuration using StorageGRID Appliance Installer
Automate installation and configuration of appliance nodes using configure-sga.py script
Automate configuration of StorageGRID
Overview of installation REST APIs
Troubleshoot hardware installation (SG5600)
Hardware setup appears to hang (SG5600)
HE error: Error synchronizing with SANtricity OS Software
Troubleshoot connection issues (SG5600)
Reboot controller while StorageGRID Appliance Installer is running
Maintain SG5600 appliance
Place appliance into maintenance mode
Upgrade SANtricity OS on storage controllers using Grid Manager
Upgrade SANtricity OS on E2700 controller using maintenance mode
Upgrade drive firmware using SANtricity Storage Manager
Replace E2700 controller
Replace E5600SG controller
Replace other hardware components
Change link configuration of E5600SG controller
Change MTU setting
Check DNS server configuration
Monitor node encryption in maintenance mode (SG5600)
Clear key management server configuration
Install and upgrade software
Upgrade StorageGRID software
Overview
What's new in StorageGRID 11.6
Removed or deprecated features
Changes to Grid Management API
Changes to Tenant Management API
Plan and prepare for upgrade
Estimate time to complete upgrade
How your system is affected during upgrade
Impact of upgrade on groups and user accounts
Verify installed StorageGRID version
Obtain required materials
Check system
Upgrade StorageGRID software
Upgrade workflow
Linux Install RPM or DEB package on all hosts
Perform upgrade
Troubleshoot upgrade issues
Upgrade does not complete
User interface issues
Docker image availability check error messages
Increase Metadata Reserved Space setting
Install Red Hat Enterprise Linux or CentOS
Overview
Plan and prepare for Red Hat or CentOS installation
Before you install (Red Hat or CentOS)
Required materials
Download and extract StorageGRID installation files
CPU and RAM requirements
Storage and performance requirements
Node container migration requirements
Deployment tools
Prepare the hosts (Red Hat or CentOS)
Install Linux
Configure host network (Red Hat or CentOS)
Configure host storage
Configure container engine storage volume
Install StorageGRID host services
Deploy virtual grid nodes (Red Hat or CentOS)
Create node configuration files for Red Hat or CentOS deployments
How grid nodes discover the primary Admin Node
Example node configuration files
Validate the StorageGRID configuration
Start the StorageGRID host service
Configure the grid and complete installation (Red Hat or CentOS)
Navigate to the Grid Manager
Specify the StorageGRID license information
Add sites
Specify Grid Network subnets
Approve pending grid nodes
Specify Network Time Protocol server information
Specify Domain Name System server information
Specify the StorageGRID system passwords
Review your configuration and complete installation
Post-installation guidelines
Automate the installation (Red Hat or CentOS)
Overview of the installation REST API
Where to go next
Troubleshoot installation issues
Example /etc/sysconfig/network-scripts
Install Ubuntu or Debian
Overview
Plan and prepare for Ubuntu or Debian installation
Before you install (Ubuntu or Debian)
Required materials
Download and extract StorageGRID installation files
CPU and RAM requirements
Storage and performance requirements
Node container migration requirements
Deployment tools
Prepare the hosts (Ubuntu or Debian)
Install Linux
AppArmor profile installation
Configure the host network (Ubuntu or Debian)
Configure host storage
Configure the Docker storage volume
Install Docker
Install StorageGRID host services
Deploy virtual grid nodes (Ubuntu or Debian)
Create node configuration files for Ubuntu or Debian deployments
How grid nodes discover the primary Admin Node
Example node configuration files
Validate the StorageGRID configuration
Start the StorageGRID host service
Configure grid and complete installation (Ubuntu or Debian)
Navigate to the Grid Manager
Specify the StorageGRID license information
Add sites
Specify Grid Network subnets
Approve pending grid nodes
Specify Network Time Protocol server information
Specify Domain Name System server information
Specify the StorageGRID system passwords
Review your configuration and complete installation
Post-installation guidelines
Automate the installation (Ubuntu or Debian)
Overview of the installation REST API
Where to go next
Troubleshoot installation issues
Example /etc/network/interfaces
Install VMware
Overview
Plan and prepare for VMware installation
Before you install (VMware)
Required materials
Download and extract the StorageGRID installation files
Software requirements
CPU and RAM requirements
Storage and performance requirements
Deploy virtual machine grid nodes (VMware)
Collect information about your deployment environment
How grid nodes discover the primary Admin Node
Deploy a StorageGRID node as a virtual machine
Configure the grid and complete installation (VMware)
Navigate to the Grid Manager
Specify the StorageGRID license information
Add sites
Specify Grid Network subnets
Approve pending grid nodes
Specify Network Time Protocol server information
Specify Domain Name System server information
Specify the StorageGRID system passwords
Review your configuration and complete installation
Post-installation guidelines
Automate the installation (VMware)
Overview of the installation REST API
Where to go next
Troubleshoot installation issues
Perform system administration
Administer StorageGRID
Overview
Get started with StorageGRID
Web browser requirements
Sign in to the Grid Manager
Sign out of the Grid Manager
Change your password
Change the browser session timeout
View StorageGRID license information
Update StorageGRID license information
Use the API
Use the Grid Management API
Grid Management API operations
Grid Management API versioning
Protect against Cross-Site Request Forgery (CSRF)
Use the API if single sign-on is enabled
Active Directory
Azure
PingFederate
Control access to StorageGRID
Change the provisioning passphrase
Change node console passwords
Control access through firewalls
Use identity federation
Manage admin groups
Deactivate features with the API
Manage users
Use single sign-on (SSO)
Configure single sign-on
Requirements for using single sign-on
Confirm federated users can sign in
Use sandbox mode
Create relying party trusts in AD FS
Create enterprise applications in Azure
Create SP connections in PingFederate
Disable single sign-on
Temporarily disable and reenable single sign-on for one Admin Node
Manage security settings
Manage certificates
About security certificates
Configure server certificates
Supported server certificate types
Configure management interface certificates
Configure S3 and Swift API certificates
Copy or download the Grid CA certificate
Configure StorageGRID certificates for FabricPool
Configure client certificates
Configure key management servers
Overview
Review StorageGRID encryption methods
Overview of KMS and appliance configuration
Considerations and requirements for using a key management server
Considerations for changing the KMS for a site
Configure StorageGRID as a client in the KMS
Add a key management server (KMS)
View KMS details
View encrypted nodes
Edit a key management server (KMS)
Remove a key management server (KMS)
Manage proxy settings
Configure Storage proxy settings
Configure Admin proxy settings
Manage untrusted Client Networks
Overview
Specify node’s Client Network is untrusted
Manage tenants
Manage tenants
Create tenant account
Change password for tenant’s local root user
Edit tenant account
Delete tenant account
Manage platform services
Manage platform services for S3 tenant accounts
Network and ports for platform services
Per-site delivery of platform services messages
Troubleshoot platform services
Manage S3 Select for tenant accounts
Configure S3 and Swift client connections
About S3 and Swift client connections
Summary: IP addresses and ports for client connections
Configure VLAN interfaces
Manage high availability groups
Overview
How are HA groups used
Configuration options for HA groups
Configure HA groups
Manage load balancing
Overview
How load balancing works - Load Balancer service
Configure load balancer endpoints
How load balancing works - CLB service
Configure S3 API endpoint domain names
Enable HTTP for client communications
Control which client operations are permitted
Manage networks and connections
Guidelines for StorageGRID networks
View IP addresses
Supported ciphers for outgoing TLS connections
Change network transfer encryption
Manage traffic classification policies
Manage traffic classification policies
Create traffic classification policies
Edit a traffic classification policy
Delete a traffic classification policy
View network traffic metrics
Manage link costs
What link costs are
Update link costs
Use AutoSupport
What is AutoSupport
Configure AutoSupport
Manually trigger an AutoSupport message
Troubleshoot AutoSupport messages
Send E-Series AutoSupport messages through StorageGRID
Manage Storage Nodes
About managing Storage Nodes
What is a Storage Node
Manage Storage options
What is object segmentation
What are storage volume watermarks
Manage object metadata storage
Configure global settings for stored objects
Configure stored object compression
Configure stored object encryption
Configure stored object hashing
Storage Node configuration settings
Manage full Storage Nodes
Manage Admin Nodes
What an Admin Node is
Use multiple Admin Nodes
Identify the primary Admin Node
Select a preferred sender
View notification status and queues
How Admin Nodes show acknowledged alarms (legacy system)
Configure audit client access
Configure audit clients for CIFS
Configure audit clients for Workgroup
Configure audit clients for Active Directory
Add a user or group to a CIFS audit share
Remove a user or group from a CIFS audit share
Change CIFS audit share user or group name
Verify CIFS audit integration
Configure the audit client for NFS
Add NFS audit client to audit share
Verify NFS audit integration
Remove NFS audit client from audit share
Change IP address of NFS audit client
Manage Archive Nodes
What an Archive Node is
Archive to the cloud through S3 API
Configure connection settings for S3 API
Modify connection settings for S3 API
Modify Cloud Tiering Service state
Reset Store Failure Count for S3 API connection
Migrate objects from Cloud Tiering - S3 to Cloud Storage Pool
Archive to tape through TSM middleware
Configure connections to TSM middleware
Optimize Archive Node for TSM middleware sessions
Configure archive state and counters for TSM
Manage Archive Node when TSM server reaches capacity
Configure Archive Node retrieve settings
Configure Archive Node replication
Set Custom alarms for the Archive Node
Integrate Tivoli Storage Manager
Archive Node configuration and operation
Configuration best practices
Complete Archive Node setup
Install new TSM server
Configure TSM server
Define TSM tape and disk storage pools
Define a domain policy and registering a node
Create and activate the domain policy
Migrate data into StorageGRID
Confirm capacity of the StorageGRID system
Determine the ILM policy for migrated data
Impact of migration on operations
Schedule and monitor data migration
Manage objects with ILM
Overview
ILM and object lifecycle
How ILM operates throughout an object's life
How objects are ingested
Data-protection options for ingest
Advantages, disadvantages, and limitations of 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
What an ILM policy is
What an ILM rule is
Create storage grades, storage pools, EC profiles, and regions
Create and assign storage grades
Configure storage pools
What a storage pool is
Guidelines for creating storage pools
Use multiple storage pools for cross-site replication
Use storage pool as temporary location (deprecated)
Create storage pool
View storage pool details
Edit storage pool
Remove storage pool
Use Cloud Storage Pools
What a Cloud Storage Pool is
Lifecycle of Cloud Storage Pool object
When to use Cloud Storage Pools
Considerations for Cloud Storage Pools
Compare Cloud Storage Pools and CloudMirror replication
Create Cloud Storage Pool
S3: Specify authentication details for Cloud Storage Pool
C2S S3: Specify authentication details for Cloud Storage Pool
Azure: Specify authentication details for Cloud Storage Pool
Edit Cloud Storage Pool
Remove Cloud Storage Pool
Troubleshoot Cloud Storage Pools
Configure Erasure Coding profiles
Create Erasure Coding profile
Rename Erasure Coding profile
Deactivate Erasure Coding profile
Configure regions (optional and S3 only)
Create ILM rule
Access Create ILM rule wizard
Step 1 of 3: Define basics
Use advanced filters in ILM rules
Step 2 of 3: Define placements
Use Last Access Time in ILM rules
Step 3 of 3: Define ingest behavior
Create default ILM rule
Create ILM policy
Overview
Create proposed ILM policy
Create ILM policy after S3 Object Lock is enabled
Simulate ILM policy
Activate ILM policy
Verify ILM policy with object metadata lookup
Work with ILM rules and ILM policies
Use S3 Object Lock with ILM
Manage objects with S3 Object Lock
Workflow for S3 Object Lock
Requirements for S3 Object Lock
Enable S3 Object Lock globally
Resolve consistency errors when updating S3 Object Lock or legacy Compliance configuration
Example ILM rules and policies
Example 1: ILM rules and policy for object storage
Example 2: ILM rules and policy for EC object size filtering
Example 3: ILM rules and policy for better protection for image files
Example 4: ILM rules and policy for S3 versioned objects
Example 5: ILM rules and policy for Strict ingest behavior
Example 6: Change ILM policy
Example 7: Compliant ILM policy for S3 Object Lock
System hardening
Overview
Hardening guidelines for software upgrades
Hardening guidelines for StorageGRID networks
Hardening guidelines for StorageGRID nodes
Hardening guidelines for server certificates
Other hardening guidelines
Configure FabricPool
Overview
Attach StorageGRID as a cloud tier
Information needed to attach StorageGRID as a cloud tier
Best practices for load balancing
Best practices for HA groups
Configure DNS server
Create HA group
Create load balancer endpoint
Create tenant account
Create S3 bucket and obtain access key
Use ILM with FabricPool data
Create traffic classification policy
Other best practices
Use StorageGRID
Use a tenant account
Overview
How to sign in and sign out
Sign in to Tenant Manager
Sign out of Tenant Manager
Tenant Manager Dashboard
Tenant Management API
Understand Tenant Management API
Tenant Management API versioning
Protect against Cross-Site Request Forgery (CSRF)
Manage system access
Use identity federation
Manage groups
Create groups for S3 tenant
Create groups for Swift tenant
Tenant management permissions
View and edit group details
Add users to local group
Edit group name
Duplicate group
Delete group
Manage local users
Manage S3 tenant accounts
Manage S3 access keys
Create your own S3 access keys
View your S3 access keys
Delete your own S3 access keys
Create another user’s S3 access keys
View another user’s S3 access keys
Delete another user’s S3 access keys
Manage S3 buckets
Use S3 Object Lock with tenants
Create S3 bucket
View S3 bucket details
Change consistency level
Enable or disable last access time updates
Change object versioning for a bucket
Configure Cross-Origin Resource Sharing (CORS)
Delete S3 bucket
Use Experimental S3 Console
Manage S3 platform services
What are platform services?
CloudMirror replication service
Notifications for buckets
Search integration service
Considerations for using platform services
Configure platform services endpoints
Specify URN for platform services endpoint
Create platform services endpoint
Test connection for platform services endpoint
Edit platform services endpoint
Delete platform services endpoint
Troubleshoot platform services endpoint errors
Configure CloudMirror replication
Configure event notifications
Use search integration service
Configure XML for search integration
Configure search integration service
JSON generated by search integration service
Object metadata included in metadata notifications
Use S3
Overview
Changes to S3 REST API support
Supported versions
Support for StorageGRID platform services
Configure tenant accounts and connections
How StorageGRID implements S3 REST API
Conflicting client requests
Consistency controls
How StorageGRID ILM rules manage objects
Object versioning
Recommendations for implementing S3 REST API
S3 REST API supported operations and limitations
Authenticate requests
Operations on the service
Operations on buckets
Create S3 lifecycle configuration
Use S3 Object Lock default bucket retention
Custom operations on buckets
Operations on objects
Use S3 Object Lock
Use S3 Select
Use server-side encryptions
GET Object
HEAD Object
POST Object restore
PUT Object
PUT Object - Copy
SelectObjectContent
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
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
GET Storage Usage request
Deprecated bucket requests for legacy Compliance
Deprecated - PUT Bucket request modifications for compliance
Deprecated - GET Bucket compliance request
Deprecated - PUT Bucket compliance request
Bucket and group access policies
Configure security for REST API
Monitor and audit operations
Monitor object ingest and retrieval rates
Access and review audit logs
S3 operations tracked in 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
Use Swift
Overview
History of Swift API support in StorageGRID
How StorageGRID implements Swift REST API
Recommendations for implementing Swift REST API
Configure tenant accounts and connections
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
Configure security for REST API
Monitor and audit operations
Monitor and maintain StorageGRID
Monitor and troubleshoot
Overview
View the Dashboard
View the Nodes page
View the Overview tab
View the Hardware tab
View the Network tab
View the Storage tab
Use the Task tab to reboot a grid node
View the Objects tab
View the ILM tab
View the Load Balancer tab
View the Platform Services tab
View the SANtricity System Manager tab
Information you should monitor regularly
Monitor system health
Monitor node connection states
View current alerts
View resolved alerts
View a specific alert
View legacy alarms
Monitor storage capacity
Monitor information lifecycle management
Monitor network connections and performance
Monitor node-level resources
Monitor tenant activity
Monitor archival capacity
Monitor load balancing operations
Apply hotfixes or upgrade software if necessary
Manage alerts and alarms
Overview
Compare alerts and alarms
Manage alerts
Overview
View alert rules
Create custom alert rules
Edit alert rules
Disable alert rules
Remove custom alert rules
Manage alert notifications
Set up SNMP notifications
Set up email notifications
Silence alert notifications
Manage alarms (legacy system)
Configure audit messages and log destinations
Use an external syslog server
Considerations for external syslog server
Configure an external syslog server
Use SNMP monitoring
Configure the SNMP agent
Update the SNMP agent
Collect additional StorageGRID data
Use charts and graphs
Use text reports
Monitor PUT and GET performance
Monitor object verification operations
Monitor events
Review audit messages
Collect log files and system data
Manually trigger an AutoSupport message
View the Grid Topology tree
Review support metrics
Run diagnostics
Create custom monitoring applications
Troubleshoot a StorageGRID system
Troubleshooting overview
Troubleshoot object and storage issues
Confirm object data locations
Object store failures
Verify object integrity
Troubleshoot lost and missing object data
Investigate lost objects
Search for and restore potentially lost objects
Reset lost and missing object counts
Troubleshoot the Low object data storage alert
Troubleshoot Low read-only watermark override alerts
Troubleshoot the Storage Status (SSTS) alarm
Troubleshoot delivery of platform services messages (SMTT alarm)
Troubleshoot metadata issues
Troubleshoot certificate errors
Troubleshoot Admin Node and user interface issues
Troubleshoot network, hardware, and platform issues
Troubleshoot external syslog server
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
Expand your grid
Overview
Plan StorageGRID expansion
Add storage capacity
Guidelines for adding object capacity
Add storage capacity for replicated objects
Add storage capacity for erasure-coded objects
Considerations for rebalancing erasure-coded data
Add metadata capacity
Add grid nodes to add capabilities to your system
Add new site
Gather required materials
Add storage volumes
Add storage volumes to Storage Nodes
VMware: Add storage volumes to Storage Node
Linux: Add direct-attached or SAN volumes to Storage Node
Add grid nodes or site
Add grid nodes to existing site or add new site
Update subnets for Grid Network
Deploy new grid nodes
Perform expansion
Configure expanded system
Configuration steps
Verify that Storage Node is active
Copy Admin Node database
Copy Prometheus metrics
Copy audit logs
Rebalance erasure-coded data after adding Storage Nodes
Contact technical support
Recover and maintain
Overview
Download Recovery Package
StorageGRID hotfix procedure
Considerations for applying a hotfix
Plan and prepare for a hotfix
How your system is affected when you apply a hotfix
Obtain required materials for hotfix
Download hotfix file
Check system’s condition before applying hotfix
Apply hotfix
Grid node recovery procedures
Warnings and considerations for grid node recovery
Gather required materials for grid node recovery
Select node recovery procedure
Recover from Storage Node failures
Recover Storage Node down more than 15 days
Recover appliance Storage Node
Prepare appliance Storage Node for reinstallation
Start StorageGRID appliance installation
Monitor StorageGRID appliance installation
Select Start Recovery to configure appliance Storage Node
Remount and reformat appliance storage volumes (“Manual Steps”)
Restore object data to storage volume for appliance
Check storage state after recovering appliance Storage Node
Recover from storage volume failure where system drive is intact
Review warnings about storage volume recovery
Identify and unmount failed storage volumes
Recover failed storage volumes and rebuild Cassandra database
Restore object data to storage volume where system drive is intact
Check storage state after recovering storage volumes
Recover from system drive failure
Review warnings for Storage Node system drive recovery
Replace the Storage Node
Select Start Recovery to configure Storage Node
Remount and reformat storage volumes (“Manual Steps”)
Restore object data to storage volume, if required
Check storage state after recovering Storage Node system drive
Recover from Admin Node failures
Recover from primary Admin Node failures
Copy audit logs from failed primary Admin Node
Replace primary Admin Node
Configure replacement primary Admin Node
Restore audit log on recovered primary Admin Node
Reset preferred sender on recovered primary Admin Node
Restore Admin Node database when recovering primary Admin Node
Restore Prometheus metrics when recovering primary Admin Node
Recover from non-primary Admin Node failures
Copy audit logs from failed non-primary Admin Node
Replace non-primary Admin Node
Select Start Recovery to configure non-primary Admin Node
Restore audit log on recovered non-primary Admin Node
Reset preferred sender on recovered non-primary Admin Node
Restore Admin Node database when recovering non-primary Admin Node
Restore Prometheus metrics when recovering non-primary Admin Node
Recover from Gateway Node failures
Replace Gateway Node
Select Start Recovery to configure Gateway Node
Recover from Archive Node failures
Replace Archive Node
Select Start Recovery to configure Archive Node
Reset Archive Node connection to the cloud
All grid node types: Replace VMware node
All grid node types: Replace Linux node
Deploy new Linux hosts
Restore grid nodes to the host
Restore and validate grid nodes
Fix missing network interface errors
Fix missing block device errors
Start StorageGRID host service
Recover nodes that fail to start normally
What’s next: Perform additional recovery steps, if required
Replace failed node with services appliance
Install services appliance (platform change only)
Prepare appliance for reinstallation (platform replacement only)
Start software installation on services appliance
Monitor services appliance installation
How site recovery is performed by technical support
Decommission procedure
Grid node decommission
Prepare to decommission grid nodes
Considerations for grid node decommission
Considerations Admin Node or Gateway Node decommission
Considerations for Storage Node decommission
Understand the ADC quorum
Review ILM policy and storage configuration
Decommission disconnected Storage Nodes
Consolidate Storage Nodes
Decommission multiple Storage Nodes
Check data repair jobs
Gather required materials
Access Decommission Nodes page
Decommission disconnected grid nodes
Decommission connected grid nodes
Pause and resume decommission process for Storage Nodes
Troubleshoot node decommissioning
Site decommission
Considerations for removing a site
Gather required materials
Step 1: Select Site
Step 2: View Details
Step 3: Revise ILM Policy
Step 4: Remove ILM References
Step 5: Resolve Node Conflicts (and start decommission)
Step 6: Monitor Decommission
Network maintenance procedures
Update subnets for Grid Network
Configure IP addresses
Change node network configuration
Add to or change subnet lists on Admin Network
Add to or change subnet lists on Grid Network
Change IP addresses for all nodes
Add interfaces to existing node
Linux: Add Admin or Client interfaces to node
Linux: Add trunk or access interfaces to node
VMware: Add trunk or access interfaces to node
Configure DNS servers
Modify DNS configuration for single grid node
Configure NTP servers
Restore network connectivity for isolated nodes
Host-level and middleware procedures
Linux: Migrate grid node to new host
Linux: Export node from source host
Linux: Import node on target host
Linux: Start migrated node
Archive Node maintenance for TSM middleware
VMware: Configure virtual machine for automatic restart
Grid node procedures
View Server Manager status and version
View current status of all services
Start Server Manager and all services
Restart Server Manager and all services
Stop Server Manager and all services
View current status of service
Stop service
Place appliance into maintenance mode
Force service to terminate
Start or restart service
Remove port remaps
Remove port remaps on bare metal hosts
Reboot grid node
Reboot grid node from Grid Manager
Reboot grid node from command shell
Shut down grid node
Power down host
Power off and on all nodes in grid
Stop services and shut down grid nodes
Start up grid nodes
Use a DoNotStart file
Add DoNotStart file for service
Remove DoNotStart file for service
Troubleshoot Server Manager
Access Server Manager log file
Service with an error state
Appliance node cloning
How appliance node cloning works
Considerations and requirements for appliance node cloning
Clone appliance node
Review audit logs
Overview
Audit message flow and retention
Access audit log file
Audit log file rotation
Audit log file and message formats
Audit log file format
Use audit-explain tool
Use 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
Example: S3 Select on an object
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 message reference
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
ECMC: Missing Erasure Coded Data Fragment
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
LKCU: Overwritten Object Cleanup
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
Enable StorageGRID
Other versions
Legal notices