Console Level OpenZFS Storage Pool Importing

From OSNEXUS Wiki
Jump to: navigation, search

A script included with QuantaStor called qs-zconvert may assist you with importing a storage pool from other Open-ZFS based solutions. QuantaStor has a special naming convention for the storage pools (ZPOOLs) and storage volumes (ZVOLs) which the conversion script will take care of. Note that this command must be run from the console/ssh while logged in as root ('sudo -i').

qs-zconvert is a helper utility for importing ZFS pools and converting them to QuantaStor naming format.
This makes it so that foreign zpools can be managed as a QuantaStor Storage Pools while retaining all
their original data.
WARNING: Please backup your data before converting. This tool has been shown to be reliable but not every
         combination of ZFS to ZFSonLinux has been tested or is guaranteed to work.

Usage:

    qs-zconvert list                   : Displays a list of all the pools available for importing
    qs-zconvert listall                : Displays a detailed list of all the pools available for importing
    qs-zconvert import POOLNAME        : Imports and converts the zpool and associated zvols into QuantaStor naming format
    qs-zconvert convertvols POOLNAME   : Converts just the ZVOLs to quantastor UUID format naming conventions
    qs-zconvert importhg HGFILE        : Creates host groups and host entries using the 'stmfadm list-hg -v' output in HGFILE
    qs-zconvert importlumap LUFILE        : Assigns logical units to host groups.

Note also that if the particular features and version information for your OpenZFS system can be found by running the 'zpool upgrade -v' command. When run on QuantaStor you will see this for the feature list. If your OpenZFS based system has more features and you're using them with your zpool then you may have import problems and the qs-zconvert script may not work for you.

This system supports ZFS pool feature flags.

The following features are supported:

FEAT DESCRIPTION
-------------------------------------------------------------
async_destroy                         (read-only compatible)
     Destroy filesystems asynchronously.
empty_bpobj                           (read-only compatible)
     Snapshots use less space.
lz4_compress
     LZ4 compression algorithm support.

The following legacy versions are also supported:

VER  DESCRIPTION
---  --------------------------------------------------------
 1   Initial ZFS version
 2   Ditto blocks (replicated metadata)
 3   Hot spares and double parity RAID-Z
 4   zpool history
 5   Compression using the gzip algorithm
 6   bootfs pool property
 7   Separate intent log devices
 8   Delegated administration
 9   refquota and refreservation properties
 10  Cache devices
 11  Improved scrub performance
 12  Snapshot properties
 13  snapused property
 14  passthrough-x aclinherit
 15  user/group space accounting
 16  stmf property support
 17  Triple-parity RAID-Z
 18  Snapshot user holds
 19  Log device removal
 20  Compression using zle (zero-length encoding)
 21  Deduplication
 22  Received properties
 23  Slim ZIL
 24  System attributes
 25  Improved scrub stats
 26  Improved snapshot deletion performance
 27  Improved snapshot creation performance
 28  Multiple vdev replacements

For more information on a particular version, including supported releases,
see the ZFS Administration Guide.