feat: Add MHVTL kernel module installer and iSCSI binding guide- Add install-kernel-module.sh script for Ubuntu 24.04- Compile and install mhvtl kernel module automatically- Add MHVTL_ISCSI_BINDING_GUIDE.md with complete setup instructions- Document how to expose MHVTL devices via iSCSI- Include troubleshooting and best practices- Support for library (changer) and tape drives- Client connection examples (iscsiadm)- Backup software integration (Bacula, Amanda, Veeam)- Tested on Ubuntu 24.04.3 LTS, Kernel 6.8.0-88

This commit is contained in:
2025-12-09 15:17:58 +00:00
parent 8b6fad85a2
commit f2c6ed286d
5 changed files with 867 additions and 1 deletions

Binary file not shown.

View File

@@ -1,4 +1,4 @@
Adastra VTL Installer
Version: 1.0.0
Build Date: 2025-12-09 14:54:54
Build Date: 2025-12-09 15:17:44
Build Host: vtl-dev

View File

@@ -0,0 +1,84 @@
#!/bin/bash
set -e
echo "=== Installing MHVTL Kernel Module ==="
# Check if running as root
if [ "$EUID" -ne 0 ]; then
echo "Error: This script must be run as root"
exit 1
fi
# Check Ubuntu version
if ! grep -q "24.04" /etc/os-release; then
echo "Warning: This script is designed for Ubuntu 24.04"
echo "Your version: $(lsb_release -d | cut -f2)"
read -p "Continue anyway? (y/n) " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
exit 1
fi
fi
# Install dependencies
echo "Installing dependencies..."
apt-get update -qq
apt-get install -y linux-headers-$(uname -r) build-essential git lsscsi sg3-utils
# Download MHVTL source
echo "Downloading MHVTL source..."
cd /tmp
rm -rf mhvtl
git clone https://github.com/markh794/mhvtl.git
cd mhvtl/kernel
# Compile kernel module
echo "Compiling kernel module..."
make
# Check if compilation succeeded
if [ ! -f mhvtl.ko ]; then
echo "Error: Kernel module compilation failed"
exit 1
fi
echo "Kernel module compiled successfully ($(du -h mhvtl.ko | cut -f1))"
# Install kernel module
echo "Installing kernel module..."
make install
# Update module dependencies
echo "Updating module dependencies..."
depmod -a
# Load module
echo "Loading mhvtl module..."
modprobe mhvtl
# Verify module is loaded
if lsmod | grep -q mhvtl; then
echo "✓ mhvtl module loaded successfully"
else
echo "Error: Failed to load mhvtl module"
exit 1
fi
# Configure auto-load on boot
echo "Configuring auto-load on boot..."
echo "mhvtl" > /etc/modules-load.d/mhvtl.conf
# Cleanup
cd /
rm -rf /tmp/mhvtl
echo ""
echo "=== MHVTL Kernel Module Installation Complete ==="
echo "Module: mhvtl"
echo "Status: Loaded"
echo "Auto-load: Enabled"
echo ""
echo "You can now start MHVTL service:"
echo " systemctl start mhvtl"
echo ""