Docs / Migration Guides / How to Plan a Multi-Server Migration

How to Plan a Multi-Server Migration

By Admin · Mar 1, 2026 · Updated Apr 23, 2026 · 26 views · 2 min read

Migrating an entire infrastructure across multiple Breeze instances demands careful coordination. A structured plan reduces downtime and prevents data loss during the transition.

Phase 1: Discovery and Inventory

  • List all servers, their roles (web, database, cache, worker), and interdependencies
  • Document IP addresses, DNS records, firewall rules, and SSL certificates
  • Identify stateful services (databases, file storage) that need special handling
  • Map application dependencies to determine migration order

Phase 2: Prepare the Destination

# Provision new Breeze instances matching or exceeding current specs
# Install and configure base software stack
sudo apt update && sudo apt upgrade -y
# Replicate firewall rules
sudo ufw status numbered  # on source
# Apply matching rules on destination

Phase 3: Define Migration Order

Follow this general sequence to minimize downtime:

  • Databases first -- set up replication before cutting over
  • Shared storage -- sync file systems with rsync
  • Application servers -- deploy code and test against new databases
  • Load balancers and DNS -- switch traffic last

Phase 4: Execute with a Runbook

Create a step-by-step runbook with time estimates and rollback procedures:

# Example runbook entry
# Step 5: Switch database primary (estimated: 2 min)
# Action: Promote replica on new-db-server
# Rollback: Revert DNS to old-db-server within 60s
# Verify: Run health check query on application

Post-Migration Checklist

  • Verify all services are responding on the new infrastructure
  • Monitor error rates and latency for 24-48 hours
  • Keep old servers running in standby for quick rollback
  • Update monitoring, alerting, and backup configurations for the new IPs
  • Document the new infrastructure layout for future reference

Was this article helpful?