hyper2kvm

Operational Guides

Production-ready operational procedures, automation scripts, and best practices for VM migrations.

📋 Planning & Preparation

⭐ Best Practices & Examples

🤖 Automation & Monitoring

Operational Toolkit Overview

Complete Migration Workflow

┌─────────────────────────────────────────┐
│  Phase 1: PLANNING                      │
│  ├─ Pre-Flight Validation               │
│  ├─ Migration Checklist (Planning)      │
│  └─ Create Runbook from Template        │
└────────┬────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────┐
│  Phase 2: PREPARATION                   │
│  ├─ Run Automation Scripts              │
│  │  ├─ Bulk VMDK Inspection             │
│  │  ├─ Config Generation                │
│  │  └─ Storage Calculation              │
│  └─ Review Examples Library             │
└────────┬────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────┐
│  Phase 3: EXECUTION                     │
│  ├─ Follow Migration Checklist          │
│  ├─ Apply Best Practices                │
│  ├─ Execute from Runbook                │
│  └─ Use Automation Scripts              │
│     ├─ Parallel Migration               │
│     └─ Progress Monitoring              │
└────────┬────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────┐
│  Phase 4: VALIDATION                    │
│  ├─ Run Validation Scripts              │
│  │  ├─ Batch Validator                  │
│  │  └─ Network Validator                │
│  └─ Migration Checklist (Post)          │
└────────┬────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────┐
│  Phase 5: PRODUCTION                    │
│  ├─ Setup Monitoring (Monitoring Guide) │
│  ├─ Health Checks                        │
│  └─ Ongoing Operations                   │
└─────────────────────────────────────────┘

Guide Descriptions

Migration Checklist

850 lines of comprehensive checklists:

Use for: Ensuring nothing is missed, tracking progress, team coordination

Pre-Flight Validation

1,100 lines including:

Use for: Verifying readiness before migration, catching issues early

Migration Runbook Template

950 lines customizable template:

Use for: Documenting migrations, standardizing process, audit trail

Best Practices

2,100 lines of proven practices:

Use for: Learning optimal approaches, avoiding mistakes, team standardization

Examples Library

1,000 lines with 23+ examples:

Use for: Copy-paste configurations, learning by example, quick start

Automation Scripts

1,350 lines documenting 10 scripts:

Pre-Migration:

  1. Bulk VMDK Inspector
  2. Migration Config Generator
  3. Storage Space Calculator

Execution:

  1. Parallel Batch Migration
  2. Migration Progress Monitor

Validation:

  1. Batch VM Validator
  2. Network Configuration Validator

Monitoring:

  1. VM Health Monitor

Utilities:

  1. Cleanup Old Migrations
  2. Migration Statistics Generator

Use for: Automating workflows, reducing manual effort, batch processing

Monitoring Guide

1,150 lines of observability:

Use for: Production monitoring, performance tracking, issue detection

Quick Start Workflows

Scenario 1: First Single VM Migration

# 1. Pre-flight check
Use: Pre-Flight Validation (run automated script)

# 2. Find example
Use: Examples Library → Basic Examples → Simple Linux VM

# 3. Create migration plan
Use: Migration Checklist → Simple Migration Template

# 4. Execute
Follow: Migration Checklist → Migration Day

# 5. Validate
Use: Monitoring Guide → VM Health Checks

Scenario 2: Batch Migration Project

# 1. Plan
Use: Migration Checklist → Planning Phase
Use: Pre-Flight Validation

# 2. Automate
Use: Automation Scripts → Bulk VMDK Inspector
Use: Automation Scripts → Config Generator
Use: Automation Scripts → Storage Calculator

# 3. Create runbook
Use: Migration Runbook Template (customize for project)

# 4. Execute
Use: Automation Scripts → Parallel Batch Migration
Use: Automation Scripts → Progress Monitor

# 5. Validate
Use: Automation Scripts → Batch Validator
Use: Automation Scripts → Network Validator

# 6. Monitor
Use: Monitoring Guide → Setup Prometheus/Grafana
Use: Automation Scripts → Health Monitor

Scenario 3: Production Deployment

# 1. Review best practices
Use: Best Practices → Read all sections
Use: Best Practices → Avoid anti-patterns

# 2. Setup monitoring
Use: Monitoring Guide → Production deployment
Use: Monitoring Guide → Tool integration

# 3. Create runbook
Use: Migration Runbook Template

# 4. Execute with monitoring
Use: Automation Scripts → Parallel Migration
Use: Monitoring Guide → Performance baseline

# 5. Ongoing operations
Use: Automation Scripts → Health Monitor
Use: Monitoring Guide → Alerting
Use: Automation Scripts → Statistics Generator

Value Metrics

Time Savings

Quality Improvements

Tool Selection Matrix

Your Need Recommended Guide
First migration ever Examples Library + Migration Checklist
Planning large project Migration Checklist + Runbook Template
Need to automate Automation Scripts
Production deployment Best Practices + Monitoring Guide
Team standardization Best Practices + Runbook Template
Reduce manual work Automation Scripts
Track performance Monitoring Guide
Copy-paste config Examples Library
Avoid mistakes Best Practices (anti-patterns)
Validate before migration Pre-Flight Validation

Integration with Other Documentation

These operational guides work together with:

Decision Support (../decision-support/):

Quick Reference (../../quick-reference/):

Testing (../../testing/):

Deployment (../../deployment/):

Contributing

Suggestions for improving operational guides? See Contributing to Docs.

Summary

7 comprehensive operational guides covering:

Total: ~8,500 lines of operational documentation

Last Updated: February 2026 Documentation Version: 2.1.0 Guides: 7 operational guides with complete toolkit

This site is open source. Improve this page.