vtl-appliance/INSTALLER-README.md

Adastra VTL Installer Package

Binary installer untuk Adastra Virtual Tape Library (VTL) yang support Debian-based dan RPM-based Linux distributions.

Supported Distributions

Debian-based:

• Debian 10+
• Ubuntu 18.04+
• Linux Mint
• Pop!_OS

RPM-based:

• RHEL/CentOS 7+
• Fedora 30+
• Rocky Linux 8+
• AlmaLinux 8+

System Requirements

• Root access (sudo)
• Internet connection (untuk download mhvtl source)
• Minimum 2GB RAM
• 10GB free disk space
• Kernel headers installed

Installation

1. Extract Package

tar -xzf adastra-vtl-installer-1.0.0.tar.gz
cd adastra-vtl-installer

2. Run Installer

sudo ./install.sh

Installer akan otomatis:

• Detect distro (Debian/Ubuntu atau RHEL/CentOS/Fedora)
• Install dependencies (Apache/httpd, PHP, build tools, dll)
• Download & compile mhvtl dari source
• Install Adastra VTL ke /opt/adastra-vtl
• Deploy Web UI ke /var/www/html/mhvtl-config
• Setup systemd service
• Configure firewall (RPM-based)
• Create user & group vtl

3. Post-Installation

Setelah instalasi selesai:

# Load mhvtl kernel modules
mhvtl-load

# Start mhvtl service
systemctl start mhvtl

# Enable on boot
systemctl enable mhvtl

# Check status
systemctl status mhvtl

Web UI Access

Setelah instalasi, Web UI bisa diakses di:

http://[SERVER-IP]/mhvtl-config

Gunakan Web UI untuk:

• Configure library settings
• Add/remove drives
• Generate tape configuration
• Export device.conf

Configuration Files

• Main config: /etc/mhvtl/device.conf
• Library contents: /etc/mhvtl/library_contents.*
• mhvtl config: /etc/mhvtl/mhvtl.conf
• Web UI: /var/www/html/mhvtl-config/
• Install dir: /opt/adastra-vtl/

Useful Commands

# Load mhvtl modules
mhvtl-load

# Unload mhvtl modules
mhvtl-unload

# Check mhvtl status
systemctl status mhvtl

# View SCSI devices
lsscsi -g

# Restart mhvtl
systemctl restart mhvtl

# View logs
journalctl -u mhvtl -f

Uninstallation

sudo ./uninstall.sh

Ini akan:

• Stop & disable mhvtl service
• Unload kernel modules
• Remove installed files
• Preserve config files di /etc/mhvtl/

Troubleshooting

mhvtl service tidak start

# Check if binaries exist
which vtltape vtllibrary

# Check if modules loaded
lsmod | grep mhvtl

# Try manual start
vtltape -q
vtllibrary -q

Web UI tidak bisa diakses

# Check Apache/httpd status
systemctl status apache2  # Debian/Ubuntu
systemctl status httpd     # RHEL/CentOS

# Check firewall (RPM-based)
firewall-cmd --list-services

# Check permissions
ls -la /var/www/html/mhvtl-config/

Kernel module tidak load

# Check if kernel headers installed
dpkg -l | grep linux-headers  # Debian/Ubuntu
rpm -qa | grep kernel-devel   # RHEL/CentOS

# Rebuild mhvtl
cd /tmp
git clone https://github.com/markh794/mhvtl.git
cd mhvtl
make clean
make
sudo make install

Support

Untuk issues dan pertanyaan, silakan buka issue di GitHub repository.

License

See LICENSE file in the repository.