Skip to main content

ConfigImportBareMetal

The bare-metal restore of an archive onto a fresh install, present when the installation has no array configured and the archive's schema is not newer.

schemaUpgradebooleanrequired

The archive's database is older than the running schema and is upgraded, on a staged copy, by the migration runner.

disks object[]required
  • Array [
  • namestringrequired

    What a user calls it: the role and index, its mountpoint and the identity it was recorded with.

    roleArrayDiskRolerequired

    A role the array-setup wizard assigns. Ignore is omitted — those disks never appear in the plan.

    Possible values: [parity, data, cache]

    roleIndexinteger<int64>required

    Possible values: >= 1

    mountpointstringrequired
    fsUuidstringrequired

    The filesystem UUID the archive records for the slot.

    wwnstring
    serialstring
    byIdNamestring
    weakIdentitybooleanrequired
    sizeBytesinteger<int64>
    stateConfigImportDiskStaterequired

    matched: exactly one attached disk carries the recorded identity (WWN, else serial; a weak-identity disk by filesystem UUID and size) and its filesystem is the recorded one. absent: no attached disk is it. replaced: the identity or the filesystem differs, either an attached disk holds the recorded filesystem with another identity or the disk with the recorded identity holds another filesystem. ambiguous: more than one attached disk matches, a disk and its clone. A disk that is not matched stays a row of the restored array with its recorded filesystem, is never mounted or adopted by the restore, and leaves the array degraded.

    Possible values: [matched, absent, replaced, ambiguous]

    devicestring

    The attached disk it matched, or the disk holding its filesystem when replaced; absent for absent and ambiguous.

  • ]
  • diskMapping objectrequired

    The mapping of the archive's array disks to the attached disks that a user confirms: one entry per matched disk, and none for any other. An empty list confirms an archive that records no array disks, or that none of its disks is attached.

    disks object[]required

    Possible values: <= 512

  • Array [
  • roleArrayDiskRolerequired

    A role the array-setup wizard assigns. Ignore is omitted — those disks never appear in the plan.

    Possible values: [parity, data, cache]

    roleIndexinteger<int64>required

    Possible values: >= 1

    devicestringrequired

    The attached disk the slot was matched to.

    Possible values: non-empty and <= 256 characters

  • ]
  • ConfigImportBareMetal
    {
    "schemaUpgrade": true,
    "disks": [
    {
    "name": "string",
    "role": "parity",
    "roleIndex": 0,
    "mountpoint": "string",
    "fsUuid": "string",
    "wwn": "string",
    "serial": "string",
    "byIdName": "string",
    "weakIdentity": true,
    "sizeBytes": 0,
    "state": "matched",
    "device": "string"
    }
    ],
    "diskMapping": {
    "disks": [
    {
    "role": "parity",
    "roleIndex": 0,
    "device": "string"
    }
    ]
    }
    }