Skip to main content

Migrate AhsayUBS to Debian

November 24, 2025

Product Version

AhsayUBS: 9

Operating System

AhsayUBS

Description

This guide provides instructions for migrating AhsayUBS to Debian.

We strongly recommend creating backups of your system and configuration files before proceeding with the migration.

Solution

Since AhsayUBS has been discontinued in v10, the steps below are provided to guide users on how to migrate AhsayUBS to Debian.

First record all settings of your AhsayUBS. Then the Debian OS must be setup before the AhsayUBS links are created, and System Home Directory and System Log Database are configured. The steps to do these are outlined below.

  1. Login to the AhsayUBS console and take note of the network and storage information.

    To get the network information go to Information > System Status > Network.

    Network Information

    To get the storage information go to Information > System Status > Space.

    Storage Information

  2. Format the USB swap partition and install the Debian OS there.

    Debian 12 is used as an example, for more information on how to setup other versions please refer to this article.

    1. Select Graphical install.

      Debian Setup

    2. Select the language, then click Continue.

      Debian Setup

    3. Select the location, then click Continue.

      Debian Setup

    4. Select the keyboard, then click Continue.

      Debian Setup

    5. Network autoconfiguration will fail, click Continue.

      Debian Setup

    6. Select Do not configure the network at this time, then click Continue.

      Debian Setup

    7. Configure the hostname, then click Continue.

      Debian Setup

    8. Set 'test' as root password, then click Continue.

      Debian Setup

    9. Enter the name of the user: type 'guest', then click Continue.

      Debian Setup

    10. Select username for the new account which is 'guest', then click Continue.

      Debian Setup

    11. Set 'guest' as the password for the user, then click Continue.

      Debian Setup

    12. Select Guided - use entire disk, then click Continue.

      Debian Setup

    13. Select the disk to partition, then click Continue.

      Debian Setup

    14. Select the partitioning scheme All files in one partition (recommended for new users), then click Continue.

      Debian Setup

    15. Select Finish partitioning and write changes to disk, then click Continue.

      Debian Setup

    16. Select Yes when asked to "Write the changes to disks?", then click Continue.

      Debian Setup

    17. Select No when asked to "Scan extra installation media?", then click Continue.

      Debian Setup

    18. Select No when asked to "Use a network mirror?", then click Continue.

      Debian Setup

    19. Select No when asked to "Participate in the package usage survey?", then click Continue.

      Debian Setup

    20. Uncheck "standard system utilities" and check SSH server, click Continue.

      Debian Setup

    21. Select Yes when asked to "Install the GRUB boot loader to your primary drive?", click Continue.

      Debian Setup

    22. Select the device for boot loader installation, then click Continue.

      Debian Setup

    23. Once installation is complete, click Continue to finish.

      Debian Setup

  3. Perform the apt update command.

    apt update
    apt install linux-headers-$(uname -r)
    apt install zfsutils-linux 
    systemctl enable zfs-import-scan
    systemctl enable zfs-import-cache
    systemctl enable zfs-mount
    systemctl enable zfs.target
  4. Create the ZFS volume mount points.

    mkdir -p /ubs/mnt/esms00
    mkdir -p /ubs/mnt/eslsfw  
    zpool import -f eslsfwxE8F99119
    zpool import -f esms00xE8F99119
    zfs set mountpoint=/ubs/mnt/eslsfw eslsfwxE8F99119
    zfs set mountpoint=/ubs/mnt/esms00 esms00xE8F99119
    zfs set sharesmb=off eslsfwxE8F99119
    zfs set sharesmb=off esms00xE8F99119  
    zpool set cachefile=/etc/zfs/zpool.cache eslsfwxE8F99119
    zpool set cachefile=/etc/zfs/zpool.cache esms00xE8F99119
    zfs get all
  5. Create the AhsayUBS links.

    mkdir -p /ubs/mnt/esms00
    mkdir -p /ubs/mnt/eslsfw
    mkdir -p /ubs/mnt/esfmfw/obsr/system/obsr
    mkdir -p /ubs/mnt/eslsfw/obsr/download
  6. Configure System Home Directory and System Log Database

    mkdir -p /ubs/module/obsr/system/
    ln -s /ubs/storage/obsr obsr