Files
adastra-vtl/README.md

110 lines
3.3 KiB
Markdown

# VTL Linux Distro
An opinionated Linux distribution specifically designed for Virtual Tape Library (VTL) operations using mhvtl with iSCSI connectivity.
## Features
- **mhvtl Integration**: Pre-configured virtual tape library with multiple tape drives and media changer
- **iSCSI Target**: Network-based storage connectivity for Linux and Windows clients
- **Optimized Performance**: Tuned kernel parameters for tape operations
- **Easy Deployment**: Automated installation and configuration scripts
- **Minimal Footprint**: Stripped-down base system focused on VTL operations
## Architecture
```
┌─────────────────────────────────────┐
│ VTL Linux Distro (Server) │
│ ┌──────────────────────────────┐ │
│ │ mhvtl │ │
│ │ - Virtual Tape Drives │ │
│ │ - Media Changer │ │
│ │ - Tape Media Management │ │
│ └──────────────────────────────┘ │
│ ┌──────────────────────────────┐ │
│ │ iSCSI Target (tgt) │ │
│ │ - Network Block Devices │ │
│ │ - Multi-client Support │ │
│ └──────────────────────────────┘ │
└─────────────────────────────────────┘
│ iSCSI (IP Network)
┌──────┴──────┐
│ │
┌───▼────┐ ┌───▼────┐
│ Linux │ │Windows │
│ Client │ │ Client │
└────────┘ └────────┘
```
## Directory Structure
```
/vtl/
├── build/ # Build scripts and configurations
├── config/ # System configuration files
├── scripts/ # Installation and management scripts
├── systemd/ # Systemd service files
├── docs/ # Documentation
└── iso/ # ISO build output
```
## Quick Start
### Building the ISO
```bash
cd /vtl
sudo ./build/build-iso.sh
```
### Installation
1. Boot from the generated ISO
2. Follow the installation prompts
3. Configure network settings
4. Set up iSCSI targets and mhvtl devices
### Connecting Clients
**Linux Client:**
```bash
iscsiadm -m discovery -t st -p <VTL_IP>:3260
iscsiadm -m node --login
```
**Windows Client:**
```powershell
iscsicli QAddTargetPortal <VTL_IP>
iscsicli ListTargets
iscsicli LoginTarget <target_name>
```
## Configuration
### mhvtl Configuration
- Default library: `/etc/mhvtl/`
- Tape storage: `/opt/mhvtl/`
- Supported drives: LTO-5, LTO-6, LTO-7, LTO-8
### iSCSI Configuration
- Target configuration: `/etc/tgt/conf.d/`
- Default port: 3260
- Authentication: CHAP supported
## Requirements
- x86_64 architecture
- Minimum 2GB RAM
- 50GB+ storage for tape media
- Network interface for iSCSI
## License
MIT License
## Support
For issues and questions, please refer to the documentation in `/vtl/docs/`