vtl-appliance/dist/adastra-vtl-installer/web-ui/README.md

mhvtl Configuration Web UI

Web-based configuration manager for mhvtl (Virtual Tape Library).

Features

• 📚 Library configuration
• 💾 Drive management (add/remove/configure)
• 📼 Tape generation settings
• 📤 Export configuration files
• 🎨 Modern UI with Adastra theme

Usage

Local Development

Simply open index.html in your web browser:

cd web-ui
python3 -m http.server 8080
# or
php -S localhost:8080

Then open http://localhost:8080 in your browser.

Deploy to VTL System

Copy the web-ui directory to your VTL system:

scp -r web-ui/ root@vtl-server:/var/www/html/mhvtl-config/

Or include it in the ISO build by adding to the build script.

Configuration Workflow

1. Library Tab: Configure library settings (ID, vendor, serial, etc.)
2. Drives Tab: Add/remove drives and configure each drive
3. Tapes Tab: Set tape generation parameters
4. Export Tab:
   • Generate configuration preview
   • Download device.conf file
   • Copy mktape command for tape generation

Generated Files

• device.conf - Main mhvtl configuration file (goes to /etc/mhvtl/)
• mktape command - Run this to generate virtual tapes

Integration with Build

To include this in the ISO build, add to build/build-iso.sh:

# Copy web UI
mkdir -p "$WORK_DIR/chroot/var/www/html"
cp -r web-ui "$WORK_DIR/chroot/var/www/html/mhvtl-config"

Customization

Edit style.css to customize colors and theme. Current theme matches adastra.id branding.