Arcfra logoDocs
API Doc
Search Docs...
⌘ K
OverviewDeploymentManagementOperationReferenceGlossary
    ACOS 6.3.0
  • Arcfra Cloud Operating System>
  • CLI command>
  • Managing physical disks

Managing journal partitions

Each node's SSD reserves certain partition spaces as journal partitions. ABS records operations in the journal partition to ensure data security.

Viewing journal partition information on the current node

Procedure

Run the following command on a cluster node to view all its journal partitions:

zbs-chunk [--ins_id <id>] journal list

ParameterDescription
--ins_id <id>Optional. The physical disk pool ID. This parameter can be used to filter and display information for a specific physical disk pool in environments with multiple physical disk pools.

Output example

==============  ==================  =============  ========  ============  ===============
PATH              RESERVED ENTRIES    MAX ENTRIES    SEQ NO  STATUS          NUM IO ERRORS
==============  ==================  =============  ========  ============  ===============
/dev/nvme0n1p3                   0      418377728     67005  JOURNAL_IDLE                0
/dev/nvme0n1p3            20819968      418377728     67001  JOURNAL_BUSY                0
==============  ==================  =============  ========  ============  ===============
==============  ===============================================  ====================================  ====================================  ==========  ====================  ===============  ===========
PATH            DEVICE ID                                        UUID                                  PART UUID                               ERRFLAGS  STATUS                  NUM IO ERRORS    WARNFLAGS
==============  ===============================================  ====================================  ====================================  ==========  ====================  ===============  ===========
/dev/nvme0n1p3  nvme-eui.01000000000000005cd2e4d80f575551-part3  2e7322aa-5041-44a2-bda0-a1e53a39b8ab  78ebfe36-4b80-4f5f-813c-3dff49e549d1           0  JOURNALGROUP_MOUNTED                0            0
/dev/nvme1n1p3  nvme-eui.01000000000000005cd2e42a6a5d5551-part3  3d8f44a6-c8d6-42c3-8784-93612236ba40  9f64a25c-a680-43b1-aada-9870feef838f           0  JOURNALGROUP_MOUNTED                0            0
==============  ===============================================  ====================================  ====================================  ==========  ====================  ===============  ===========

Output note

In the output, multiple lines may correspond to a journal partition successfully mounted by one journal mount command (related to the space for mounting journal partitions).

ParameterDescription
INS IDThe physical disk pool ID (displayed only if there are multiple physical disk pools and no filter is applied).
PATHThe journal partition path.
RESERVED ENTRIESThe number of entries used by the journal partition group.
MAX ENTRIESThe number of journal partition entries.
SEQ NOThe journal partition reuse count.
STATUSThe journal partition status: IDLE, BUSY.
NUM IO ERRORSThe number of I/O errors.
ParameterDescription
INS IDThe physical disk pool ID (displayed only if there are multiple physical disk pools and no filter is applied).
PATHThe journal partition path.
DEVICE IDThe physical disk ID.
UUIDThe unique UUID identifier of the journal partition.
PART UUIDThe unique UUID identifier of the physical partition.
ERRFLAGSThe error flags.
STATUS The partition status.
NUM IO ERRORSThe number of I/O errors.
WARNFLAGSThe alarm flags.

Formatting the journal partition under the specified path

Procedure

  • Format the empty journal partition under the specified path

    Run the following command on a cluster node to format the empty journal partition under the specified path:

    zbs-chunk [--ins_id <id>] journal format <path>

  • Format the journal partition with existing data under the specified path

    Run the following command on a cluster node to format the journal partition with existing data under the specified path:

    zbs-chunk [--ins_id <id>] journal format --force <path>

    Note:

    Running this command will erase all existing data on the journal partition. Proceed with caution.

Information:

In environments with multiple physical disk pools, if the specified partition is mounted by another physical disk pool, the command will fail. In this case, you must unmount the corresponding partition before running the command.

ParameterDescription
--ins_id <id>Optional (required in a multi-physical disk pool environment). The physical disk pool ID. This parameter specifies the physical disk pool used for formatting in a multi-physical disk pool environment.

Output example

Journal successfully formatted

Mounting a journal partition to a chunk

Procedure

Run the following command on a cluster node to mount a journal partition to the chunk under the specified path:

zbs-chunk [--ins_id <id>] journal mount <path>

ParameterDescription
--ins_id <id>Optional (required in a multi-physical disk pool environment). The physical disk pool ID. This parameter specifies the physical disk pool used for mounting in a multi-physical disk pool environment. It must be consistent with the physical disk pool used for formatting.

Output example

Journal successfully mounted

Unmounting a journal partition from a chunk

Procedure

Run the following command on a cluster node to unmount a journal partition under the specified path from the chunk:

zbs-chunk journal umount <path>

Output example

Journal successfully unmounted

Setting the journal partition to a healthy status

Procedure

Run the following command on a cluster node to set the journal partition under the specified path to a healthy status:

zbs-chunk journal set-healthy <path>

Output example

Journal device is set healthy!

Setting the journal partition to an unhealthy status

Procedure

Run the following command on a cluster node to set the journal partition under the specified path to an unhealthy status:

zbs-chunk journal set-unhealthy <path>

Output example

Journal device is set unhealthy!

Refreshing all journal partitions on the node

Procedure

Run the following command on a cluster node to refresh all journal partitions on that node:

zbs-chunk journal flush

Output example

Journal successfully flushed

Output note

This command is asynchronous and returns immediately, even before completion.

In this article