fix storage

docs/alpha/components/mhvtl/INSTALLATION.md

@@ -0,0 +1,90 @@
+# mhvtl Installation and Configuration Guide
+
+This guide details the steps to install and configure the `mhvtl` (Virtual Tape Library) on this system, including compiling from source and setting up custom paths.
+
+## 1. Prerequisites
+
+Ensure the necessary build tools are installed on the system.
+
+```bash
+sudo apt-get update
+sudo apt-get install -y git make gcc
+```
+
+## 2. Download and Compile Source Code
+
+First, clone the `mhvtl` source code from the official repository and then compile and install both the kernel module and the user-space utilities.
+
+```bash
+# Create a directory for the build process
+mkdir /src/calypso/mhvtl_build
+
+# Clone the source code
+git clone https://github.com/markh794/mhvtl.git /src/calypso/mhvtl_build
+
+# Compile and install the kernel module
+cd /src/calypso/mhvtl_build/kernel
+make
+sudo make install
+
+# Compile and install user-space daemons and utilities
+cd /src/calypso/mhvtl_build
+make
+sudo make install
+```
+
+## 3. Configure Custom Paths
+
+By default, `mhvtl` uses `/etc/mhvtl` for configuration and `/opt/mhvtl` for media. The following steps reconfigure the installation to use custom paths located in `/opt/calypso/`.
+
+### a. Create Custom Directories
+
+Create the directories for the custom configuration and media paths.
+
+```bash
+sudo mkdir -p /opt/calypso/conf/vtl/ /opt/calypso/data/vtl/media/
+```
+
+### b. Relocate Configuration Files
+
+Copy the default configuration files generated during installation to the new location. Then, update the `device.conf` file to point to the new media directory. Finally, replace the original configuration directory with a symbolic link.
+
+```bash
+# Copy default config files to the new directory
+sudo cp -a /etc/mhvtl/* /opt/calypso/conf/vtl/
+
+# Update the Home directory path in the new device.conf
+sudo sed -i 's|Home directory: /opt/mhvtl|Home directory: /opt/calypso/data/vtl/media|g' /opt/calypso/conf/vtl/device.conf
+
+# Replace the original config directory with a symlink
+sudo rm -rf /etc/mhvtl
+sudo ln -s /opt/calypso/conf/vtl /etc/mhvtl
+```
+
+### c. Relocate Media Data
+
+Move the default media files to the new location and replace the original data directory with a symbolic link.
+
+```bash
+# Move the media contents to the new directory
+sudo mv /opt/mhvtl/* /opt/calypso/data/vtl/media/
+
+# Replace the original media directory with a symlink
+sudo rmdir /opt/mhvtl
+sudo ln -s /opt/calypso/data/vtl/media /opt/mhvtl
+```
+
+## 4. Start and Verify Services
+
+With the installation and configuration complete, start the `mhvtl` services and verify that they are running correctly.
+
+```bash
+# Load the kernel module (this service should now work)
+sudo systemctl start mhvtl-load-modules.service
+
+# Start the main mhvtl target, which starts all related daemons
+sudo systemctl start mhvtl.target
+
+# Verify the status of the main services
+systemctl status mhvtl.target vtllibrary@10.service vtltape@11.service
+```