This document describes the hardware and software requirements for deploying Spanner Omni on-premises and in cloud environments.
On-premises requirements
Deploying Spanner Omni on-premises requires the following:
Hardware requirements
The right hardware helps Spanner Omni and the CLI run reliably and efficiently on-premises. Check these minimum and recommended configurations to optimize your deployment.
Server hardware
Server hardware should meet the following recommended configurations:
| OS and platform | Recommended hardware configuration |
|---|---|
| Linux |
|
| macOS (Developer version) |
|
Spanner Omni CLI hardware
The Spanner Omni CLI should meet the following recommended hardware configurations:
| OS and platform | Recommended hardware configuration |
|---|---|
| Linux |
|
| macOS |
|
Software requirements
For stable and secure operation, Spanner Omni needs supported operating systems and container environments. Confirm your environment meets these software specifications before you proceed.
Server software
Server software should meet the following requirements:
| OS and platform | Recommended software requirements |
|---|---|
| Linux |
|
| macOS (Developer version) |
|
Spanner Omni CLI software
The Spanner Omni CLI software should meet the following requirements:
| OS and platform | Software requirements |
|---|---|
| Linux | RHEL 8+, Ubuntu 20+ |
| macOS | macOS 14.7+ |
Storage
Proper storage setup is important for data durability and high performance. Use these recommendations for SSDs, file systems, and disk I/O to meet high-availability standards.
- For each VM, use a dedicated, persistent, and attachable solid-state drive
(SSD) with an
ext4file system to store your data. - Allocate 500 GB of storage per vCPU.
- Make sure the storage is durable enough for a high-availability system.
- Spanner Omni is tested with Dell PowerFlex block storage, which is recommended for production usage.
- Local disks aren't supported.
Disk I/O
Your disk I/O should achieve 500 IOPS and 30 MB per second per vCPU.
Cloud requirements
Deploying Spanner Omni in cloud environments requires the following:
Google Cloud
Review the compute and storage specifications for Google Kubernetes Engine (GKE) and Compute Engine. Meeting these requirements optimizes database performance on the cloud infrastructure.
GKE-based deployment
A GKE-based deployment has the following requirements:
Nodes with at least 4 vCPU and at least 16 GB RAM
Zonal persistent disk (
pd-ssd) or Hyperdisk Balanced for storage
VM-based deployment on Google Cloud
A VM-based deployment on Google Cloud requires a VM with 4 vCPUs
and 16 GB RAM. For storage, use a zonal persistent disk (pd-ssd) or Hyperdisk Balanced.
Amazon Web Services (AWS)
To deploy Spanner Omni on AWS, follow the Amazon Elastic Kubernetes Service
(EKS) and Amazon Elastic Compute Cloud (EC2) configuration requirements. These
requirements ensure compatibility with AWS-specific features, such as
/dev/vmclock0 for precise timekeeping.
All AWS deployments must access the /dev/vmclock0 device. To support this, do
the following:
Configure your environment with a supported machine type (for example,
M7a) and Amazon Linux 2023.Enable read permissions on the host by running
sudo chmod a+r /dev/vmclock0.Ensure the application can access the device:
For Docker, pass the device using
--device /dev/vmclock0.For Kubernetes, mount the device path into the Pod specification.
EKS-based deployment
An EKS-based deployment requires nodes with 4 vCPU and 16 GB. For
storage, use SSD-backed EBS (Zonal, io2 Block Express or gp3) volumes.
VM-based deployment on AWS
A VM-based deployment on AWS requires a minimum of 4 vCPUs and 16 GB RAM.
For storage, use SSD-backed EBS (Zonal, io2 Block Express or gp3) volumes.