LFS-MIRROR-SPLIT(1)

NAME
lfs-mirror-split - split a specified mirror from an existing mirrored file

SYNOPSIS
lfs mirror split {--mirror-id MIRROR_ID | --component-id|--comp-id|-I COMP_ID | --pool POOL} [--destroy|-d] [-f NEW_FILE] MIRRORED_FILE

DESCRIPTION
This command splits a mirror with mirror ID MIRROR_ID or containing a component with COMP_ID or containing a component on POOL out of a mirrored file specified by the path name MIRRORED_FILE. By default, the layout of the split mirror will be stored into a new file named MIRRORED_FILE.mirror~MIRROR_ID. If -f NEW_FILE option is specified, then the layout of the split mirror will be stored into the named file. If MIRRORED_FILE has only one mirror existing after split, it will be converted to a regular non-mirrored file.

If the original MIRRORED_FILE is not a mirrored file, then the command will return an error.

OPTIONS

--mirror-id MIRROR_ID
    The numerical unique identifier for a mirror. The mirror ID is unique within a mirrored file and is automatically assigned at file creation or extension time. It can be fetched by lfs getstripe command (see lfs(1)).

--comp-id COMP_ID
    The numerical unique identifier for a component contained within a mirror.

--pool POOL
    The pool storing a component contained within a mirror.

-d, --destroy
    This option indicates the split mirror will be destroyed.

This option is mandatory on encrypted files when the encryption key is not available. Otherwise operation results in -ENOKEY.

-f NEW_FILE
    This option indicates the layout of the split mirror will be stored into NEW_FILE.

This option cannot be used on encrypted files when the encryption key is not available. It will result in -ENOKEY.

EXAMPLES
Split a mirror with ID 1 out of /mnt/lustre/file1 and store it into /mnt/lustre/file1.mirror~1:
        # lfs mirror split --mirror-id 1 /mnt/lustre/file1

Split a mirror with ID 2 out of /mnt/lustre/file1 and destroy it:
        # lfs mirror split --mirror-id 2 -d /mnt/lustre/file1

Split a mirror with ID 3 out of /mnt/lustre/file1 and store it into /mnt/lustre/file2:
        # lfs mirror split --mirror-id 3 -f /mnt/lustre/file2 /mnt/lustre/file1

Split a mirror containing the component with ID 65537 out of /mnt/lustre/file1 and destroy it:
        # lfs mirror split --comp-id 65537 -d /mnt/lustre/file1

Split a mirror on pool lustre-nvme out of /mnt/lustre/file1 and destroy it:
        # lfs mirror split --pool lustre-nvme -d /mnt/lustre/file1

AVAILABILITY
The lfs mirror split command is part of the lustre(7) filesystem package since release 2.11.0

SEE ALSO
lfs(1), lfs-mirror-create(1), lfs-mirror-delete(1), lfs-mirror-extend(1), lfs-mirror-resync(1), lfs-mirror-verify(1), lfs-setstripe(1)