DCVM - Datacenter Virtual Machine Manager

DCVM is a comprehensive bash script collection that allows you to easily manage your KVM/QEMU-based virtual datacenter environment. It's a powerful tool that automates virtual machine creation, management, backup, and monitoring operations.

Quick Installation

You can setup dcvm quickly with curl or wget commands: (you should be in root user)

Method	Command
curl	bash -c "$(curl -fsSL https://raw.githubusercontent.com/metharda/dcvm/main/lib/installation/install-dcvm.sh)"
wget	bash -c "$(wget -qO- https://raw.githubusercontent.com/metharda/dcvm/main/lib/installation/install-dcvm.sh)"

Custom Branch or Fork Installation

You can install from a different branch or fork using environment variables:

Use Case	Command
Install from a specific branch	DCVM_REPO_BRANCH=<awesome-branch> bash -c "$(curl -fsSL https://raw.githubusercontent.com/metharda/dcvm/<awesome-branch>/lib/installation/install-dcvm.sh)"
Install from a fork	DCVM_REPO_SLUG=<yourusername>/dcvm bash -c "$(curl -fsSL https://raw.githubusercontent.com/<yourusername>/dcvm/main/lib/installation/install-dcvm.sh)"
Install from a fork with specific branch	DCVM_REPO_SLUG=yourusername/dcvm DCVM_REPO_BRANCH=feature-test bash -c "$(curl -fsSL https://raw.githubusercontent.com/<yourusername>/dcvm/main/lib/installation/install-dcvm.sh)"

Available environment variables:

• DCVM_REPO_SLUG: Repository in format owner/repo (default: metharda/dcvm)
• DCVM_REPO_BRANCH: Branch name (default: main)

Features

Virtual Machine Management

• Automated VM Creation: Debian 12, Ubuntu 20.04/22.04 and Arch Linux based VMs with cloud-init support
• Custom ISO Support: Create VMs from any installer ISO (Windows, Arch, Fedora, etc.)
• User-Friendly Wizard: Step-by-step VM configuration
• Resource Optimization: Automatic sizing based on host system resources
• Package Management: Pre-installed packages like nginx, apache2, mysql-server, docker

Network Management

• Isolated Network: Private datacenter-net network (10.10.10.0/24)
• Automatic DHCP: Dynamic IP assignment
• Port Forwarding: Automatic port forwarding for SSH and HTTP access
• Connection Testing: VM accessibility verification

Storage & Backup

• Shared NFS: File sharing between VMs
• Automated Backup: Snapshot backup system
• Storage Monitoring: Disk usage tracking and cleanup
• Archiving: Automatic archiving of old files

System Management

• Centralized Management: All operations through dcvm command
• Self-Update: Update DCVM with a single command
• System Services: systemd integration
• Log Management: Detailed operation logs
• Security: SSH key-based secure access

Requirements

Hardware

• CPU: VT-x/AMD-V capable processor
• RAM: Minimum 4GB (8GB+ recommended)
• Disk: 50GB+ free space
• Network: Internet connection

Software

• Operating System: Ubuntu 20.04/22.04, Debian 11/12, Arch Linux
• Virtualization: KVM/QEMU support
• Root Access: sudo/root privileges

Installation

Quick Install (Recommended)

See installation commands at the top of this README.

Manual Installation

If you prefer step-by-step installation:

1. Clone Repository

git clone https://github.com/metharda/dcvm.git
cd dcvm

2. Run Installation Script

sudo bash install/install-dcvm.sh

3. Verify Installation

dcvm --version
dcvm status

For detailed installation instructions, see Installation Guide.

Quick Start

Create Your First VM

# Interactive mode (recommended for first time)
dcvm create myvm

# Or use force mode with defaults
dcvm create myvm -f -p mypassword123

Check VM Status

dcvm list
dcvm status myvm

Connect to Your VM

# Find VM IP
dcvm network

# SSH into VM
ssh admin@<vm-ip>

Usage Guide

Basic Commands

# Create VMs
dcvm create myvm                     # Interactive mode
dcvm create webserver -f -p pass123  # Force mode with password
dcvm create myvm -o /path/to/iso     # Create from custom ISO
dcvm create-iso myvm --iso /path/to/archlinux.iso  # Alternative ISO syntax

# Manage VMs
dcvm list                            # List all VMs
dcvm start myvm                      # Start VM
dcvm stop myvm                       # Stop VM
dcvm restart myvm                    # Restart VM
dcvm delete myvm                     # Delete VM
dcvm console myvm                    # Connect to console

# Network
dcvm network                         # Show network info
dcvm network ports setup             # Setup port forwarding

# Storage & Backup
dcvm backup myvm                     # Backup VM
dcvm restore myvm                    # Restore VM
dcvm storage                         # Show storage info
dcvm storage-cleanup                 # Clean up storage

# System
dcvm fix-lock                        # Fix locked resources
dcvm self-update                     # Update to latest version
dcvm self-update --check             # Check for updates
dcvm uninstall                       # Uninstall DCVM
dcvm --version                       # Show version
dcvm --help                          # Show help

For detailed usage, see Usage Guide.

Documentation

• Installation Guide - Detailed installation instructions
• Usage Guide - Complete command reference
• Examples - Practical examples and tutorials

Project Structure

dcvm/
├── bin/                          # Main executable
│   └── dcvm                      # CLI entry point
├── lib/                          # Core libraries
│   ├── core/                     # VM management
│   ├── installation/             # Installation scripts
│   ├── network/                  # Network utilities
│   ├── storage/                  # Backup & storage
│   └── utils/                    # Common utilities
├── templates/                    # VM templates
└── docs/                         # Documentation

Bulk Operations

# Manage all VMs
dcvm start                           # Start all VMs
dcvm stop                            # Stop all VMs
dcvm restart                         # Restart all VMs

# Network management
dcvm network ports setup             # Port forwarding setup
dcvm clear-leases show               # Show DHCP leases
dcvm clear-leases clear-all          # Clear all leases

VM Creation Example

# Create web server
dcvm create web-server nginx,mysql-server

# After VM creation:
# 1. IP address is automatically assigned
# 2. SSH access is prepared
# 3. Port forwarding is configured
# 4. NFS share is mounted

Network Configuration

Default Network Settings

• Network Range: 10.10.10.0/24
• Gateway: 10.10.10.1
• DHCP Pool: 10.10.10.100-10.10.10.254
• DNS: Host system DNS

Port Mapping

• SSH: 2220+ ports (per VM)
• HTTP: 8080+ ports (per VM)
• Access: ssh -p 2221 admin@host-ip

Directory Structure

/srv/datacenter/
├── vms/                    # VM disk files
│   ├── vm1/
│   │   ├── vm1-disk.qcow2
│   │   └── cloud-init/
├── storage/
│   └── templates/          # Base OS images
├── nfs-share/              # Shared files
├── backups/                # VM backups
└── scripts/                # Management scripts

Script Descriptions

Main Scripts

• install-dcvm.sh: System installation and startup
• vm-manager.sh: Central VM management interface

Helper Scripts

• create-vm.sh: New VM creation wizard
• delete-vm.sh: VM deletion and cleanup
• backup.sh: Backup and restore
• setup-port-forwarding.sh: Port forwarding setup
• storage-manager.sh: Storage space management
• dhcp.sh: DHCP management
• fix-lock.sh: System lock fix

Security

Access Control

• SSH key-based authentication
• Strong password policies
• Isolated network environment
• Privilege control

Security Best Practices

# SSH key creation
ssh-keygen -t rsa -b 4096 -f ~/.ssh/dcvm-key

# Firewall settings
ufw enable
ufw allow 22
ufw allow 2220:2250/tcp  # SSH ports
ufw allow 8080:8090/tcp  # HTTP ports

Monitoring and Maintenance

System Status

dcvm status                 # General system status
virsh list --all           # All VMs
virsh net-list             # Network status

Log Files

tail -f /var/log/datacenter-startup.log        # System logs
tail -f /var/log/datacenter-storage.log        # Storage logs
journalctl -u libvirtd                         # KVM/QEMU logs

Performance Monitoring

# VM resource usage
virsh domstats --cpu-total --balloon

# Network traffic
virsh domifstat vm-name vnet0

# Disk I/O
virsh domblkstat vm-name vda

Troubleshooting

Common Issues

No KVM Support

# Check CPU virtualization support
egrep -c '(vmx|svm)' /proc/cpuinfo

# Load KVM modules
modprobe kvm
modprobe kvm_intel  # For Intel
modprobe kvm_amd    # For AMD

Network Connection Issues

# Restart network
virsh net-destroy datacenter-net
virsh net-start datacenter-net

# DHCP cleanup
dcvm clear-leases clear-all

VM Startup Issues

# Check VM state
virsh domstate vm-name

# Check VM logs
virsh console vm-name

# Check disk file
ls -la /srv/datacenter/vms/vm-name/

Complete System Reset

# WARNING: Deletes all VMs!
dcvm delete --all

# Restart system services
systemctl restart libvirtd
./install-dcvm.sh

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.