Files
vtl-appliance/INSTALLER-README.md

179 lines
3.0 KiB
Markdown

# 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
```bash
tar -xzf adastra-vtl-installer-1.0.0.tar.gz
cd adastra-vtl-installer
```
### 2. Run Installer
```bash
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:
```bash
# 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
```bash
# 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
```bash
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
```bash
# 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
```bash
# 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
```bash
# 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.