Commands

Target

  • FSR 1.1-A5, 1.2-A1

  • kernel filter driver

  • Applied Replication Engine

  • Linked Application

    • user

    • clone console

    • HA/DR

outline

  • The user/replication console application can perform all operations related to the operation of the FSR by passing CLI commands to the FSR.

  • All FSR CLIs are provided as REST-API.

  • Individual settings for each node are set or controlled with commands on each node. (Cluster-level control commands are not provided)

  • All settings can be dynamically applied during operation by default (except for some settings such as essential properties).

setting

  • Create, modify, delete configuration files

  • Modify the properties of the configuration file.

  • Applies the changes made to the configuration file.

  • Set up the replication engine.

    • Set the required/optional option items of the configuration file.

    • Set the kernel path filter by resource.

      • Set the destination path.

      • Set exclusion filters.

      • Set file lock information.

      • Set the memory buffer.

      • Set up the file buffer.

check

  • Query the (detailed) status of a resource.

    • Kernel path filters are queried by resource.

  • Query the (detailed) performance of a resource.

  • Query (detailed) statistics of a resource.

  • Query the current settings of a resource.

  • Dump the configuration file of the resource.

control

  • Start/stop the replication engine.

    • Activates/stops the kernel path filter for each resource.

  • Start/stop synchronization.

  • start the resource

    • Attach the resource configuration.

    • Connect resource replication.

  • stop the resource

    • Detach resource configuration.

    • Disconnect resource replication.

  • Promote/demote a resource.

  • Enable/disable resource file locking.

watch

  • (Real-time) Search logs.

  • Request notification (event) subscription.

management

  • Install/Uninstall

  • update

  • license

REST-API

All REST-APIs are based on gRPC and operate in the form of JSON-RPC over HTTP .
The function for monitoring requires continuous data delivery, so only gRPC is provided.

classification

item

REST-API

movement

note

classification

item

REST-API

movement

note

1

setting

Query system settings

GET

/api/v1/config

Returns the setting in action

-

2

Query system settings (file)

GET

/api/v1/config/dump

read file and return

-

3

Query system settings (file, XML)

GET

/api/v1/config/dump-xml

Read the file and return it as XML

-

4

Change system settings

PUT

/api/v1/config

save to file

-

5

Change system settings (update)

PUT

/api/v1/config/update

Apply settings and save to file

Accepts and processes only the parts to change,
no need to call adjust

6

Update system settings

POST

/api/v1/config/adjust

Reading from a file and updating the settings in operation

-

7

Resource list lookup

GET

/api/v1/resources

Return a list of resource IDs

Necessity check required

8

Query individual resource settings

GET

/api/v1/resource/{ID}

Returns the setting in action

all available

9

Look up individual resource settings (file)

GET

/api/v1/resource/{ID}/dump

read file and return

all available

10

Look up individual resource settings (file, XML)

GET

/api/v1/resource/{ID}/dump-xml

Read the file and return it as XML

all available

11

Change individual resource settings

PUT

/api/v1/resource/{ID}

save to file

Create a new resource file when specifying an ID that does not exist

12

Change individual resource settings (update)

PUT

/api/v1/resource/{ID}/update

Apply settings and save to file

Accepts and processes only the parts to change,
no need to call adjust

13

Updating individual resource settings

POST

/api/v1/resource/{ID}/adjust

Reading from a file and updating the settings in operation

all available

14

Delete individual resource settings

DELETE

/api/v1/resource/{ID}

delete file

Running resources are not affected.

15

control

Generate metadata

POST

/api/v1/resource/{ID}/create-meta

Generate resource metadata

all available

16

Delete metadata

POST

/api/v1/resource/{ID}/delete-meta

Delete resource metadata

all available

17

Reset metadata

POST

/api/v1/resource/{ID}/reset-meta

Reset resource metadata

all available. 1.2 or higher

18

Metadata Cleanup

POST

/api/v1/resource/cleanup-meta

Delete obsolete metadata

-

19

Add resource

POST

/api/v1/resource/{ID}/add

Read and load resource files

all available

20

delete resource

POST

/api/v1/resource/{ID}/delete

Remove resource from list

all available

21

Load resource file

POST

/api/v1/resource/{ID}/attach

Loading a file into a resource

all available

22

Separate resource files

POST

/api/v1/resource/{ID}/detach

Separate files from resources

all available

23

resource startup

POST

/api/v1/resource/{ID}/up

Load resources and run

all available.
add, attach, connect operations

24

stop resource

POST

/api/v1/resource/{ID}/down

Disconnect and detach resources

all available.
disconnect, detach, del actions

25

promotion

POST

/api/v1/resource/{ID}/primary

Attempt to promote to Primary

-

26

demotion

POST

/api/v1/resource/{ID}/secondary

Demote to Secondary

-

27

connection

POST

/api/v1/resource/{ID}/connect/{PEER}

Change to Connecting state

all available. All connections when peer is omitted

28

Disconnect

POST

/api/v1/resource/{ID}/disconnect/{PEER}

Change to standalone status

all available. Disconnect all connections when peer is omitted

29

sync start

POST

/api/v1/resource/{ID}/resync/{PEER}

Synchronize partner node as source

all available

30

Start remote sync

POST

/api/v1/resource/{ID}/resync-remote/{PEER}

Start syncing this node as source

all available

31

Consistency Verification Start

POST

/api/v1/resource/{ID}/verify/{PEER}

Start consistency verification with partner node as source

all available

32

Consistency check stopped

POST

/api/v1/resource/{ID}/verify-stop/{PEER}

Aborting Consistency Verification in Progress

all available. 1.1 or later

33

pause

POST

/api/v1/resource/{ID}/pause

Synchronization or replication paused

all available. Full pause when peer is omitted

34

resumption

POST

/api/v1/resource/{ID}/resume

Resume synchronization or replication

all available. Full resume when peer is omitted

35

file protection

POST

/api/v1/resource/{ID}/lock/{LEVEL}

Start file protection

all available. Write protection, read/write protection

36

Unprotect the file

POST

/api/v1/resource/{ID}/unlock

Unprotect the file

all available

37

RID renewal

POST

/api/v1/resource/{ID}/rid/update

Renew the resource's RID (Rotate)

-

38

Force RID

POST

/api/v1/resource/{ID}/rid

Change the RID of a resource

-

39

Close open files

POST

/api/v1/resource/{ID}/close-files

Close all open files for cloning

all available

40

Network bandwidth change

PUT

/api/v1/resource/{ID}/override/network-limit/{PEER}

Randomly change network bandwidth

all available

41

Revert Network Bandwidth

DELETE

/api/v1/resource/{ID}/override/network-limit/{PEER}

Return network bandwidth to configured values

all available

42

check

Resource Status Query

GET

/api/v1/resource/{ID}/status

Returns a list of status values ​​for resources and connections

all available

43

Resource Performance Query

GET

/api/v1/resource/{ID}/perf

Returns performance information such as BAB and sockets

all available

44

Query resource replication latency

GET

/api/v1/resource/{ID}/lag

Returns a list of replication processing times

all available. 1.1 or later

45

Consistency verification/synchronization result query (summary)

GET

/api/v1/resource/{ID}/result

Returns a summary of synchronization or consistency verification results

-

46

Consistency verification/synchronization result query (range)

GET

/api/v1/resource/{ID}/result/batch/{index}/{count}

Returns file results of synchronization or consistency verification

Specify starting index and number of requests

47

Consistency verification/synchronization result inquiry (file)

GET

/api/v1/resource/{ID}/result/file/{dir}/{name}

Returns file results of synchronization or consistency verification

Specify directory index and file name

48

RID lookup

GET

/api/v1/resource/{ID}/rid

Returns the resource's RID value (abbreviated Old ULID)

all available

49

RID lookup (all)

GET

/api/v1/resource/{ID}/rid-long

Return RID value of resource (full Old ULID)

all available

50

EFS

Certificate list lookup

GET

/api/v1/efs/cert

Return a list of certificates for the Run As account

-

51

export certificate

POST

/api/v1/efs/cert/{Thumbprint}/export

Return the specified certificate in pfx format

The certificate content is passed in base64 encoding.

52

import certificate

POST

/api/v1/efs/cert

Import the certificate into your store

The certificate content is passed in base64 encoding.

53

Specify the current certificate for encryption

POST

/api/v1/efs/cert/{Thumbprint}/set-current

Make the specified certificate the current certificate

-

54

Delete certificate

DELETE

/api/v1/efs/cert/{Thumbprint}

Delete designated certificate

-

55

Snapshot
(1.2+)

Snapshot list query

GET

/api/v1/resource/{ID}/snapshot

Returns a list of snapshots of a specified resource

all available

56

View individual snapshots

GET

/api/v1/resource/{ID}/snapshot/{SnapshotID}

Return details of a specified snapshot

-

57

create snapshot

PUT

/api/v1/resource/{ID}/snapshot/{SnapshotID}

Create a snapshot of the specified ID

-

58

Remove Snapshot

DELETE

/api/v1/resource/{ID}/snapshot/{SnapshotID}

Remove specified snapshot

-

59

Rename snapshot

POST

/api/v1/resource/{ID}/snapshot/{SnapshotID}/rename-to/{NewSnapshotID}

Change the ID of a given snapshot

-

60

Snapshot restore

POST

/api/v1/resource/{ID}/snapshot/{SnapshotID}/recovery

Pointed Snapshot Restore

-

61

Export snapshot

POST

/api/v1/resource/{ID}/snapshot/{SnapshotID}/export

Export Specified Snapshots

-

62

Cancel Snapshot

POST

/api/v1/resource/{ID}/snapshot/cancel

Cancel snapshot restore or export

-

63

Snapshot Cleanup

POST

/api/v1/resource/{ID}/snapshot/cleanup

Delete snapshot information where no real image exists

all available

64

Link Snapshot to Letter

POST

/api/v1/resource/{ID}/snapshot/{SnapshotID}/expose/{SnapshotIndex}

Associate the specified snapshot image to letter

-

65

Unlink Snapshot Letter

POST

/api/v1/resource/{ID}/snapshot/{SnapshotID}/unexpose/{SnapshotIndex}

Unlink the letter of the specified snapshot image

-

66

Snapshot
image
(1.2+)

Snapshot image list query

GET

/api/v1/snapshot-image

Return a list of snapshot images

-

67

Delete snapshot image

DELETE

/api/v1/snapshot-image/{image}

Delete the specified snapshot image

-

68

Link snapshot image to letter

POST

/api/v1/snapshot-image/{image}/expose

Associate the specified snapshot image to letter

-

69

Unlink Snapshot Image Letter

POST

/api/v1/snapshot-image/{image}/unexpose

Unlink the letter of the specified snapshot image

-

70

Unlink snapshot image via letter

POST

/api/v1/snapshot-image/unexpose-by-path

Unlink snapshot image via letter

-

71

Snapshot
Storage
(1.2+)

Snapshot Storage List Query

GET

/api/v1/snapshot-storage

Return snapshot storage list

-

72

Add snapshot storage

PUT

/api/v1/snapshot-storage/{volume}/to/{storage}

Add Storage for Designated Letters

-

73

Change snapshot storage

POST

/api/v1/snapshot-storage/{volume}/to/{storage}

Change storage settings for designated letters

-

74

Delete snapshot storage

DELETE

/api/v1/snapshot-storage/{volume}/to/{storage}

Clear Storage for Designated Letter

-

75

Network filesystem
(1.2 or higher)

NFS List Query

GET

/api/v1/nfs

Returns a list of registered NFS connection information

-

76

Add NFS

PUT

/api/v1/nfs

Add NFS connection information

-

77

Delete NFS

DELETE

/api/v1/nfs/{name}

Delete specified NFS connection information

-

78

NFS connection

POST

/api/v1/nfs/{name}/connect

Connect to designated NFS

-

79

Disconnect NFS

POST

/api/v1/nfs/{name}/disconnect

Disconnect from designated NFS

-

80

management

FSR information inquiry

GET

/api/v1/system

Return general information such as version

-

81

FSR restart

POST

/api/v1/system/restart

Restart the FSR process

-

82

Stop FSR

POST

/api/v1/system/stop

Stop the FSR process

-

83

equipment

RID comparison

POST

/api/v1/tool/rid_compare

Compare two RIDs

-

84

license

License Lookup

GET

/api/v1/license

License Status Inquiry

-

85

License settings

PUT

/api/v1/license

License settings

-

Resource ID extension

With the addition of the local clone function in 0.7, two or more nodes can be loaded locally in one resource file.
In this case, since nodes cannot be identified only with resource IDs, node names must be additionally specified as follows.

Resource ID: Node Name

  • Only nodes that are recognized as own nodes by recognizing the host name can be specified.

  • If the node name is omitted and only the resource ID is specified, it is collectively applied to all of its own nodes.

    • However, in the following command, the node name can be omitted only when there is only one node.

      • Promote, demote, start synchronization/consistency verification

Example of use)

  • Specify node name: fsradm up r0:node1

  • Omit node name: fsradm up r0

Output of query command

Resource Status Query

  • Resources(Array)

    • id: resource ID

    • node: your node name

    • role: role

    • file_state: file state

    • lock: file lock status

    • last_promoted: Last promoted time

    • pending: number of files being downloaded

    • filesystem_type: filesystem type (1.2+)

    • snapshot_state: snapshot state (1.2+)

    • snapshot_progress: Snapshot progress (1.2+)

    • connections(Array): list of connections with partner nodes

      • peer: peer node name

      • state: my state

      • role: role of partner node

      • peer_state: peer node state

      • file_state: relative node file state

      • repl_started: Time when replication started

      • last_synced: Last sync completed time

      • out_of_sync: amount of unbuffered data that has not been applied to the target

      • sync_errors: number of sync errors

      • sync: Synchronization status. NULL if not in progress

        • message: status message

        • errored_files: number of files with errors

        • bytes_done: number of bytes synced

        • bytes_total: total number of bytes to sync

        • progress: progress (0-100%)

      • pending: The number of files that the other node is downloading

      • last_error: latest error content (1.2 or later)

Resource Performance Query

  • Resources(Array)

    • id: resource ID

    • node: your node name

    • connections(Array): list of connections with partner nodes

      • peer: peer node name

      • bytes_in: received per second

      • bytes_out: Transmission per second

      • memory_buffer: memory buffer status

        • usage: usage

        • size: size

      • file_buffer: file buffer status

        • usage: usage

        • limit: limit

command

All functions of fsradm operate through gRPC and REST-API.
controlSince the command is designated as a basic command, you can omit it and use the subcommand directly.

Command structure:

  • control, ctl: resource-related control

    • config, conf: control resource configuration files

      • property, prop: control individual properties

    • meta: Meta data control

    • rid: RID control

  • driver: driver control (Windows only)

  • efs: NTFS EFS analysis and certificate control (Windows only)

    • cert: FSR engine certificate control

    • usercert: User certificate control

  • events, ev: event monitoring

  • license: license control

  • log, l: log monitoring

  • perfmon, p: performance monitor

  • system, sys: system control

    • config, conf: control system configuration files

      • property, prop: control individual properties

The arguments and notation of commands used in this document are as follows.

  • Arguments that can be omitted:{arg}

  • Required Arguments:<arg>

  • Resource ID:<id>

  • Resource ID or all:<id|all>

In the case of time values, units can be entered together as follows. The default unit is 'seconds'.

  • 100ms, 0.1s, 1m, 1h

setting

command

option

Option Description

Usage API

descriptions

command

option

Option Description

Usage API

descriptions

1

system config dump
sys conf dump

-

-

GET /api/v1/config/dump

Output the contents of a system configuration file as JSON.

2

system config dump-xml
sys conf dump-xml

-

-

GET /api/v1/config/dump-xml

Output the contents of system configuration files to XML.

3

system config show
sys conf show

-

-

GET /api/v1/config

Outputs system configuration contents in operation as JSON.

4

system config adjust
sys conf adjust

-

-

POST /api/v1/config/adjust

The contents of the system configuration file are applied to running resources and activated.

5

system config edit
sys conf edit

-u, -user

Edit with text editor

GET /api/v1/config
PUT/api/v1/config
POST /api/v1/config/adjust

Interactively edit and apply system configurations.

6

system config property get {key}
sys conf prop get {key}

-

-

GET/api/v1/config

Outputs the value of the specified property in the system configuration file.

7

system config property set <key> <value>
sys conf prop set <key> <value>

--adjust
-a

apply to resource

GET/api/v1/config
PUT/api/v1/config
POST/api/v1/config/adjust

Changes the specified property value in the system configuration file.

8

system config property unset <key>
sys conf prop unset <key>

-

-

same

Change the specified properties in the system configuration file to default values.

9

control config dump <id|all>
conf dump <id>

-

-

GET /api/v1/resource/{ID}/dump

Output the contents of a resource configuration file as JSON.

10

control config dump-xml <id|all>
conf dump-xml <id>

-

-

GET /api/v1/resource/{ID}/dump-xml

Output the content of a resource configuration file to XML.

11

control config show <id|all>
conf show <id|all>

-

-

GET /api/v1/resource/{ID}

Outputs the contents of the resource configuration in operation as JSON.

12

control config adjust <id|all>
conf adjust <id|all>

-

-

POST /api/v1/resource/{ID}/adjust

The contents of the resource configuration file are applied to the running resource and activated.

13

control config add <id>
conf add <id>

--force
-f

force overwrite

PUT /api/v1/resource/{ID}

Add resource configuration file.

14

--interactive
-i

Interactive setting mode

15

<id>
conf check config<id>

--force
-f

force delete

DELETE/api/v1/resource/{ID}

Delete the resource configuration file.

16

control config edit <id>
conf edit <id>

--user
-u

Edit with text editor

GET/api/v1/resource/{ID}
PUT/api/v1/resource/{ID}
POST/api/v1/resource/{ID}/adjust

Interactively edit and apply resource configurations.

17

control config property get <id> {key}
conf prop get <id> {key}

-

-

GET/api/v1/resource/{ID}

Outputs the value of the specified property in the resource configuration file.

18

control config property add <id> <key> <value>
conf prop add <id> <key> <value>

--adjust
-a

apply to resource

GET/api/v1/resource/{ID}
PUT/api/v1/resource/{ID}
POST/api/v1/resource/{ID}/adjust

Adds a value to a specified attribute in a resource configuration.
Valid only for properties in list form.

19

--index <숫자>

  • i

<숫자>

insert at specified index

20

<id> <key>
conf prop control config property<id> <key>

--adjust
-a

apply to resource

same

Delete the specified attribute of the resource configuration.
Valid only for properties in list form.

21

control config property set <id> <key> <value>
conf prop set <id> <key> <value>

same

same

same

Changes the value of the specified attribute in the resource configuration file.

22

control config property unset <id> <key>
conf prop unset <id> <key>

same

same

same

Change the specified properties in the resource configuration file to default values.

Set individual properties

The key value pointing to the property is written in the following way, and all configurable properties are displayed in the help of the property command (property).

  • In the format of the configuration file, write the location of the attribute in the form of a path.

    λ fsradm conf prop get r0 network/ping_interval 10
  • Array type properties are accessed by index number.

    λ fsradm conf prop get r0 nodes/0/directories/0/path e:/test/local/main
  • For attributes that use node names, access through node names is also supported.

    • node list

      λ fsradm conf prop get r0 nodes/node1/url 192.168.35.151:9890
    • Even if the order of two nodes in the linked list
      is changed, they are normally accessed.

  • When adding a value to an array-type property, enter a string value suitable for the property.
    If the value already exists, no error occurs and is ignored.

    • node list

    • linked list

    • directory

    • exclude filter

  • Index numbers and node names can also be used when removing values ​​from array-type properties.

control

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

control meta create <id|all>
meta create <id|all>

--force
-f

force overwrite

POST /api/v1/resource/{ID}/create-meta

Generate resource metadata.
It can be performed only when the resources are separated.

2

control meta delete <id|all>
meta delete <id|all>

--force
-f

force delete

POST /api/v1/resource/{ID}/delete-meta

Delete resource metadata.
It can be performed only when the resources are separated.

3

control meta cleanup
meta cleanup

-

-

POST /api/v1/resource/cleanup-meta

Clean up unused metadata.

4

control add <id|all>
add <id|all>

-

-

POST /api/v1/resource/{ID}/add

Read the resource configuration file and load it into the resource list.

5

control of <id|all>
the<id|all>

-

-

POST /api/v1/resource/{ID}/delete

Remove loaded resources from the list.

6

control attach <id|all>
attach <id|all>

-

-

POST /api/v1/resource/{ID}/attach

Load resource file.

7

control detach <id|all>
detach <id|all>

-

-

POST /api/v1/resource/{ID}/detach

Separate resource files.

8

control up <id|all>
up <id|all>

-

-

POST /api/v1/resource/{ID}/up

resource activation. (load, file load, connect)

9

control down <id|all>
down <id|all>

-

-

POST /api/v1/resource/{ID}/down

Disable resource. (end connection, disconnect file, disconnect)

10

control primary <id|all>
primary <id|all>

--force
-f

forced promotion

POST /api/v1/resource/{ID}/primary

Promote a resource to Primary.

11

--unlock
-u

unlock file

12

control secondary <id|all>
secondary <id|all>

--timeout <num>
-t <num>

time limit

POST /api/v1/resource/{ID}/secondary

Demote a resource to Secondary.
If there is a timeout value, it waits for the buffer to be emptied for that amount of time. After that time, the buffer is forcibly emptied and demoted.

The --read-only option must be used together with the --lock option.

13

--lock
-l

file lock

14

--read-only

lock to read only

15

control connect <id|all> {peer|all}
connect <id|all> {peer|all}

--discard-my-data

throw away my data

POST /api/v1/resource/{ID}/connect/{PEER}

Linking resources to partner nodes. It changes to connecting state.

16

control disconnect <id|all> {peer|all}
disconnect <id|all> {peer|all}

-

-

POST /api/v1/resource/{ID}/disconnect/{PEER}

Disconnection with partner node. It changes to standalone status.

17

control invalidate <id|all> {peer}
invalidate <id|all> {peer}

--level <num>
-l <num>

synchronization level

POST /api/v1/resource/{ID}/resync/{PEER}

Synchronization starts with partner node as source.

18

--report <mode>

Report generation scope

19

control invalidate-remote <id|all> {peer|all}
invalidate-remote <id|all> {peer|all}

--level <num>
-l <num>

synchronization level

POST /api/v1/resource/{ID}/resync-remote/{PEER}

Start synchronization with this node as source.

20

--report<mode>

Report generation scope

21

control verify <id|all> {peer}
verify <id|all> {peer}

-

-

POST /api/v1/resource/{ID}/verify/{PEER}

Start consistency verification with partner node as source.

22

control verify-stop <id|all> {peer}
verify-stop <id|all> {peer}

-

-

POST /api/v1/resource/{ID}/verify-stop/{PEER}

Abort Consistency Verification in progress. 1.1 or higher.

23

control pause <id|all> {peer|all}
pause <id|all> {peer|all}

-

-

POST /api/v1/resource/{ID}/pause

Synchronization or replication paused.

24

control resume <id|all> {peer|all}
resume <id|all> {peer|all}

-

-

POST /api/v1/resource/{ID}/resume

Resume synchronization or replication.

25

control lock <id|all>
lock <id|all>

--read-only

lock to read only

POST /api/v1/resource/{ID}/lock/{LEVEL}

Start protecting your files.

26

control unlock <id|all>
unlock <id|all>

-

-

POST /api/v1/resource/{ID}/unlock

Unprotect the file.

27

control close-files <id|all>
close-files <id|all>

-

-

POST /api/v1/resource/{ID}/close-files

Closes handles to files that are open for cloning.

28

control override network-limit <res-id|all> <peer-node|all> <value>
override network-limit <res-id|all> <peer-node|all> <value>

-

-

PUT /api/v1/resource/{ID}/override/network-limit/{PEER}

Randomly change the network bandwidth.

29

control restore network-limit <res-id|all> {peer-node|all}
restore network-limit <res-id|all> {peer-node|all}

-

-

DELETE/api/v1/resource/{ID}/override/network-limit/{PEER}

Return the network bandwidth to the configured value.

sync options

  • synchronization level

    • 0: Synchronize all files without hash comparison. Same as the previous -f option.

    • 1: If the properties are exactly the same, the contents of the file are also determined to be the same. (default value)

      • In most cases, this option is sufficient, but if you change only the contents of a file while preserving properties, it will not sync, such as:

        1. Modify the content without changing the size of the file

        2. Restore the modification time of the file to the value before the content change

    • 2: Hash comparison is performed even if the properties are the same.

  • Report generation scope

    • nothing: do not generate reports

      • Previously generated reports are retained.

      • All automatic synchronizations without a synchronization command operate with this option.

    • summary: generate summary information only

    • full: Generates all file-level information

check

command

options

Option Description

Usage API

Description

command

options

Option Description

Usage API

Description

1

system info
sys info

-

-

GET /api/v1/system

Engine information output.

2

control status {id|all}
status{id|all}

--verbose
-v

verbose output

GET /api/v1/resource/{ID}/status

Status output of resources and connections.

3

--watch
-w

monitoring

4

--interval <시간>
-i <시간>

Renewal cycle when monitoring

5

control perf {id|all}
perf {id|all}

--verbose
-v

verbose output

GET /api/v1/resource/{ID}/perf

Performance statistics output, such as buffers and networks for resource connections.

6

--watch
-w

monitoring

7

--interval <시간>
-i <시간>

Renewal cycle when monitoring

8

control latency {id|all}
latency {id|all}

--verbose
-v

verbose output

GET /api/v1/resource/{ID}/lag

Output of the time required for each phase of replication data processing. 1.1 or higher.

9

--watch
-w

monitoring

10

--interval <시간>
-i <시간>

Renewal cycle when monitoring

11

control result <id> {dir-index} {filename}
result <id> {dir-index} {filename}

--verbose
-v

verbose output

GET /api/v1/resource/{ID}/result

Output the results of the most recent synchronization or consistency verification.
Since the result is stored in the target, it can be output only on the target.
If a directory and file name are specified, summary information is omitted and the result of the specified file is output.

12

control rid show <id|all>
rid show <id|all>

--verbose
-v

verbose output

GET /api/v1/resource/{ID}/rid

RID output of the resource.
By default, only 2 old ULIDs are output, and all 32 are output when the long version option is specified.

13

--long
-l

Long version of RID output

14

events
ev

--json
-j

output in JSON format

GRPC SubscribeEvents

event monitoring.
Synchronization progress and performance statistics are basically transmitted every update cycle, but are omitted if there is no change with previous data.

15

--sync

Include sync progress

16

--perf

Include performance statistics

17

--interval <시간>
-i <시간>

Synchronization progress and performance statistics refresh rate

18

log
l

--home <경로>

engine home path

GRPCSubscribeEvents

Print the contents of the log file.
It operates similarly to the tail command and reads the system configuration file of the engine directly to determine the location of the log file, so it can be used even when the engine is shut down.
Receives resource loading events through gRPC and changes log files that should be output in real time.

19

--lines <숫자>
-n <숫자>

number of lines to output

20

--resource <id>
-t <id>

resource designation

21

--no-main

Disable main log

22

--no-resource

Disable resource log

23

--no-color

do not produce

24

--follow
-f

continuous output

25

perfmon {id|all}
p {id|all}

--json <파일명>
-j <파일명>

Export to JSON file

GRPC SubscribePerfs

Displays performance monitor information.
If you do not use the option to export to JSON or CSV, it will be output to the console screen.

If you use the --display option, you can output to the screen while exporting to a file.

26

--csv <파일명>
-c<파일명>

Export to CSV file

27

--interval <시간>
-i <시간>

information update cycle

28

--display
-d

output to console screen

29

--watch
-w

monitoring mode

Query synchronization and consistency results

Depending on the execution argument designation, it operates as follows.

  • Specify only the resource name (e.g. fsradm result r0)

    • Only the summary information of the report is output.

    • When synchronizing, if the report generation range nothingis specified as , it is not updated, so previously generated information is output.

  • Specify directory index (e.g. fsradm result r0 0)

    • Outputs all file result lists of the replication target.

    • fullWhen synchronizing , this information is created only when the report creation range is specified as , summaryand nothing is output when performed as .

    • The directory index is the number of replication destination paths defined in the replication destination – files entry – you write in the configuration file. The first replication target path is number 0 and increments by 1 in the order defined.

  • Specify the file path (e.g. fsradm result r0 0 data/)

    • Outputs a list of all the specified path and its subfiles.

    • Enter the file path as a relative path to the replication target path.

    • If you enter an exact file name, only the results for that file will be output, and /if you enter a path separator after the file name, the results of all files under that directory will be output.

event list

When you start looking up events, the latest events by category of each resource are delivered. For these events, occuryou can get the occurrence time of the event through the field.

classification

type name

field

value

data range

note

classification

type name

field

value

data range

note

1

RPC connection status

rpc

state

connection status

connected, disconnected

-

2

cause

error content

Used only in disconnected state

3

Program start/end

program

state

program startup status

started, exit

-

4

cause

error content

Used only in exit state

5

Update system settings

system_updated

-

-

-

Occurs when adjust is performed

6

crashed

crashed

cause

error content

-

In case of abnormal termination before starting the program.
1.1-A2

7

Add resource

added

resource

resource ID

-

-

8

node

own node name

-

9

group

your group name

-

10

delete resource

deleted

resource

resource ID

-

-

11

node

own node name

-

12

group

your group name

-

13

Add resource relative node

peer_added

resource

resource ID

-

-

14

node

own node name

-

15

group

your group name

-

16

peer

partner node name

-

17

peer_group

partner group name

-

18

Remove resource relative node

peer_deleted

resource

resource ID

-

-

19

node

own node name

-

20

group

your group name

-

21

peer

partner node name

-

22

peer_group

partner group name

-

23

Change resource node name

renamed

resource

resource ID

-

-

24

node

own node name

-

25

group

your group name

-

26

value

new node name

-

27

Change resource node name (relative)

peer_renamed

resource

resource ID

-

-

28

node

own node name

-

29

group

your group name

-

30

peer

partner node name

-

31

peer_group

partner group name

-

32

value

Opponent's new node name

-

33

Change resource group name

group_renamed

resource

resource ID

-

1.1-A5

34

node

own node name

-

35

group

your group name

-

36

value

new group name

-

37

Change resource group name (relative)

peer_group_renamed

resource

resource ID

-

1.1-A5

38

node

own node name

-

39

group

your group name

-

40

peer

partner node name

-

41

peer_group

partner group name

-

42

value

Opponent's new group name

-

43

Update resource settings

updated

resource

resource ID

-

Occurs when adjust is performed

44

node

own node name

-

45

group

your group name

-

46

resource connection status

state

resource

resource ID

-

-

47

node

own node name

-

48

group

your group name

-

49

peer

partner node name

-

50

peer_group

partner group name

-

51

value

state value

standalone, established 등

52

resource connection state (relative)

peer_state

resource

resource ID

-

-

53

node

own node name

-

54

group

your group name

 

55

peer

partner node name

-

56

peer_group

partner group name

-

57

value

state value

standalone, established 등

58

resource file status

file_state

resource

resource ID

-

 

59

node

own node name

-

60

group

your group name

-

61

value

state value

inconsistent, consistent 등

62

resource file state (relative)

peer_file_state

resource

resource ID

-

-

63

node

own node name

-

64

group

your group name

-

65

peer

partner node name

-

66

peer_group

partner group name

-

67

value

state value

inconsistent, consistent 등

68

resource role

role

resource

resource ID

-

-

69

node

own node name

-

70

group

your group name

-

71

value

role value

primary, secondary

72

resource role (relative)

peer_role

resource

resource ID

-

-

73

node

own node name

-

74

group

your group name

-

75

peer

partner node name

-

76

peer_group

partner group name

-

77

value

role value

primary, secondary

78

Node Connection Behavior

connection

resource

resource ID

-

-

79

node

own node name

-

80

group

your group name

-

81

peer

partner node name

-

82

peer_group

partner group name

-

83

state

connection status

connected, accepted, disconnected

84

url

IP:Port

address of peer node

85

cause

error content

Used only with disconnected

86

Connection refused from peer node

refuse

resource

resource ID

-

-

87

node

own node name

-

88

group

your group name

-

89

peer

partner node name

-

90

peer_group

partner group name

-

91

cause

reason for refusal

irrelevance (irrelevant node), split-brain
two-primary, invalid-direction

92

younger

younger node name

-

93

Recognize partner node name

peer_recognized

resource

resource ID

-

Occurs only when the partner node is a group.
Remove name attribute from 1.1-A1 and later 1.1-A5

94

node

own node name

-

95

group

your group name

-

96

peer

partner node name

-

97

peer_group

partner group name

-

98

Error during state operation

state_err

resource

resource ID

-

1.2 or higher

99

node

own node name

-

100

group

your group name

-

101

peer

partner node name

-

102

peer_group

partner group name

-

103

value

error content

-

104

next

next state

Output only when automatically transitioning to the next state

105

write error

write_error

resource

resource ID

-

-

106

node

own node name

-

107

group

your group name

-

108

filename

file name

absolute path

109

cause

error content

-

110

disk space status

diskspace

resource

resource ID

-

-

111

node

own node name

-

112

group

your group name

-

113

state

space state

not_enough, enough

114

remain

remaining capacity

units of bytes. string format

115

performance information

perf

resource

resource ID

-

--perf option required

116

node

own node name

-

117

group

your group name

-

118

peer

partner node name

-

119

peer_group

partner group name

-

120

perf

performance information

It is the same as the performance information of REST-API.

121

sync status

sync

resource

resource ID

-

--sync option required

122

node

own node name

-

123

group

your group name

-

124

peer

partner node name

-

125

peer_group

partner group name

-

126

status

sync status

It is the same as the sync state of REST-API.

127

file lock

file_lock

resource

resource ID

-

-

128

state

locked state

It is the same as the file lock status of REST-API.

129

node

own node name

-

130

group

your group name

-

131

consistency warning

consistency_warn

resource

resource ID

-

An event that occurs when the target node unlocks a file.
To be removed in 1.2

132

node

own node name

-

133

group

your group name

-

134

RID

rid

resource

resource ID

 

-

135

node

own node name

 

136

group

your group name

-

137

value

RID value

 

138

consistency

flag

true if the file state is Consistent or higher

139

outdated

flag

true if the file status is Outdated

140

primary

flag

true if promoted

141

crashed_primary

flag

true if abnormal termination in Primary state

142

File buffer usage warning

file_buf_warn

resource

resource ID

-

0.9.1

143

node

own node name

-

144

group

your group name

-

145

peer

partner node name

-

146

peer_group

partner group name

-

147

buffer overflow

overflowed

resource

resource ID

-

0.9.1

148

node

own node name

-

149

group

your group name

-

150

peer

partner node name

-

151

peer_group

partner group name

-

152

snapshot state

snapshot_state

resource

resource ID

-

1.2

153

node

own node name

-

154

group

your group name

-

155

snapshot

situation

available, creating, … etc.

156

err

error content

Used only in case of error

157

Add snapshot

snapshot_added

resource

resource ID

-

1.2

158

node

own node name

-

159

group

your group name

-

160

snapshot

Snapshot ID

-

161

images

List of image GUIDs

-

162

Delete snapshot

snapshot_deleted

resource

resource ID

-

1.2

163

node

own node name

-

164

group

your group name

-

165

snapshot

Snapshot ID

-

166

images

List of image GUIDs

-

167

Rename snapshot

snapshot_renamed

resource

resource ID

-

1.2

168

node

own node name

-

169

group

your group name

-

170

snapshot

Snapshot ID (source)

-

171

value

Changed ID (dest)

-

172

Add snapshot image

snapshot_image_added

image

Image GUID

-

1.2

173

path

original volume letter path

-

174

volume

Source Volume GUID Path

-

175

Delete snapshot image

snapshot_image_deleted

image

Image GUID

-

1.2

176

Attach snapshot image

snapshot_image_exposed

resource

resource ID

Used only if the snapshot image belongs to a resource

1.2

177

node

own node name

Used only if the snapshot image belongs to a resource

178

group

your group name

Used only if the snapshot image belongs to a resource

179

snapshot

Snapshot ID

Used only if the snapshot image belongs to a resource

180

image

Image GUID

-

181

value

Linked Letters

-

182

Unlink snapshot image

snapshot_image_unexposed

resource

resource ID

Used only if the snapshot image belongs to a resource

1.2

183

node

own node name

Used only if the snapshot image belongs to a resource

184

group

your group name

Used only if the snapshot image belongs to a resource

185

snapshot

Snapshot ID

Used only if the snapshot image belongs to a resource

186

image

Image GUID

-

187

value

linked letters

-

188

Snapshot images and resources are disconnected

snapshot_image_unlinked

resource

resource ID

-

1.2

189

node

own node name

-

190

group

your group name

-

191

snapshot

Snapshot ID

-

192

image

Image GUID

-

193

license status

license

status

license status

invalid, expired, not exist, valid

-

194

license-type

License type

temporary, permanent

195

expires-at

Limited time (date)

Year-Month-Day (e.g. 2020-11-30)

196

expires-in

Time limit (remaining days)

-

EFS

This is a Windows-only command and cannot be used on Linux.

analyze

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

efs analyze dir <dir…>
efs analyze by-dir <dir…>

--json
-j

output in JSON format

GRPCEFSA analysis

Searches encrypted files under the specified directory to analyze the list of certificates required for decryption and the installation status.

2

--verbose
-v

verbose output

3

efs analyze resource <id>
efs analyze by-res <id>

--json
-j

output in JSON format

GRPCEFSA analysis

Searches encrypted files under the replication path of the specified resource to analyze the list of certificates required for decryption and the installation status.

4

--verbose
-v

verbose output

Control the engine execution account store

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

efs cert list

-

-

GET /api/v1/efs/cert

Prints a list of certificates in the certificate store.

2

efs cert export <thumbprint> <file>

--password <password>
-p <password>

certificate password

POST /api/v1/efs/cert/{Thumbprint}/export

Analyzes the list of certificates required for decryption and the installation status by looking up encrypted files under the replication path of the specified resource.

3

efs cert import <file>

--password <password>
-p <password>

certificate password

POST/api/v1/efs/cert

Import the certificate in the specified file and register it in the certificate store

4

--set-current
-c

set as current certificate

5

efs cert set-current <thumbprint>

-

-

POST/api/v1/efs/cert/{Thumbprint}/set-current

Make the specified certificate in the certificate store the current certificate for encryption

6

efs cert delete <thumbprint>

-

-

DELETE /api/v1/efs/cert/{Thumbprint}

Delete a given certificate from the certificate store

CLI Run As Account Store Control

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

efs usercert list

-

-

GET/api/v1/efs/cert

Prints a list of certificates in the certificate store.

2

efs usercert export <thumbprint> <file>

--password <password>
-p <password>

certificate password

POST/api/v1/efs/cert/{Thumbprint}/export

Analyzes the list of certificates required for decryption and the installation status by looking up encrypted files under the replication path of the specified resource.

3

efs usercert import <file>

--password <password>
-p <password>

certificate password

POST/api/v1/efs/cert

Import the certificate in the specified file and register it in the certificate store

4

--set-current
-c

set as current certificate

5

efs usercert set-current <thumbprint>

-

-

POST /api/v1/efs/cert/{Thumbprint}/set-current

Make the specified certificate in the certificate store the current certificate for encryption

6

efs usercert delete <thumbprint>

-

-

DELETE /api/v1/efs/cert/{Thumbprint}

Delete a given certificate from the certificate store

network file system

This is a Windows-only command and cannot be used on Linux. 1.2 or higher

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

nfs list

-

-

GET /api/v1/nfs

Displays a list of network file system connection information registered in the FSR execution account.

2

nfs add <remote-path>

--username <username>
-u <username>

username

PUT/api/v1/nfs

Register network file system connection information in the FSR execution account.

3

--password <password>
-p <password>

password

4

nfs del <remote-path>

-

-

DELETE /api/v1/nfs/{name}

Deletes the network file system connection information registered in the FSR execution account.

5

nfs connect <remote-path>

-

-

POST /api/v1/nfs/{name}/connect

Connect to the specified network file system.

6

nfs disconnect <remote-path>

-

-

POST /api/v1/nfs/{name}/disconnect

Terminate the connection to the specified network file system.

snapshot

This is a Windows-only command and cannot be used on Linux. 1.2 or higher

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

snapshot list <id|all>

--verbose
-v

verbose output

GET /api/v1/resource/{ID}/snapshot

Prints a list of snapshots of the specified resource.

2

--desc
-d

sort in reverse order

3

snapshot list-exposed

--desc
-d

sort in reverse order

GET/api/v1/resource/{ID}/snapshot

Prints a list of snapshots linked to the letter.

4

snapshot show <id> <snapshot>

-

-

GET /api/v1/resource/{ID}/snapshot/{SnapshotID}

Display detailed information of the specified snapshot.

5

snapshot create <id> <snapshot>

-

-

PUT /api/v1/resource/{ID}/snapshot/{SnapshotID}

Creates a snapshot of the specified ID.

6

snapshot delete <id> <snapshot>

-

-

DELETE/api/v1/resource/{ID}/snapshot/{SnapshotID}

Delete the specified snapshot.

7

snapshot rename <id> <snapshot> <rename-to>

-

-

POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/rename-to/{NewSnapshotID}

Changes the ID of the specified snapshot.

8

snapshot recovery <id> <snapshot>

 

-

-

POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/recovery

Restores the resource replication path to the specified snapshot.

9

snapshot export <id> <snapshot> <target-paths...>

--combine

Copy multiple replication paths to one destination

POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/export

Copy the files to be copied from the snapshot to the specified path.

10

snapshot cancel <id>

-

-

POST /api/v1/resource/{ID}/snapshot/cancel

Cancels the snapshot-related operation of the specified resource.

11

snapshot cleanup <id|all>

-

-

POST /api/v1/resource/{ID}/snapshot/cleanup

Cycles through the snapshots of the specified resource and deletes the snapshots whose images have been deleted.

12

snapshot expose <id> <snapshot> <image-index> <expose-path>

-

-

POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/expose/{SnapshotIndex}

Links the specified snapshot image to the specified path (letter).

13

snapshot unexpose <id> <snapshot>

-

-

POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/unexpose/{SnapshotIndex}

Disconnect the path (letter) of the specified snapshot image.

snapshot image

This is a Windows-only command and cannot be used on Linux. 1.2+ FSR option is provided
so that it can be done even with the service stopped .--local

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

snapshot-image list

--unlinked-only
-u

Outputs only lists that are not associated with resources

GET /api/v1/snapshot-image

Prints a list of snapshot images.

2

--local
-l

Doing fsradm itself

3

snapshot-image delete <guid>
snapshot-image del <guid>

--local
-l

Doing fsradm itself

DELETE /api/v1/snapshot-image/{image}

Delete the specified snapshot image.

4

snapshot-image expose <guid> <expose-path>

--local
-l

Doing fsradm itself

POST /api/v1/snapshot-image/{image}/expose

Links the specified snapshot image to the specified path (letter).

5

snapshot-image unexpose <guid>

--local
-l

Doing fsradm itself

POST /api/v1/snapshot-image/{image}/unexpose

Disconnect the path (letter) of the specified snapshot image.

6

snapshot-image unexpose-by-path <expose-path>

--local
-l

Doing fsradm itself

POST /api/v1/snapshot-image/unexpose-by-path

Disconnects the specified path (letter) and the snapshot image.

snapshot storage

This is a Windows-only command and cannot be used on Linux. 1.2+ FSR option is provided
so that it can be done even with the service stopped .--local

command

option

Option Description

Usage API

Description

command

option

Option Description

Usage API

Description

1

snapshot-storage list

--for

Query the storage where snapshots of a given letter are stored

GET /api/v1/snapshot-storage

Prints the snapshot storage list.

2

--on

Storage inquiry in designated letter

3

--local
-l

Doing fsradm itself

4

snapshot-storage add <for> <on> {max-size|unbounded}

--local
-l

Doing fsradm itself

PUT /api/v1/snapshot-storage/{volume}/to/{storage}

Add snapshot storage.
The last argument has a default value of unbouned, and is limited so that it cannot exceed the size when entered in units of capacity.

5

snapshot-storage change <for> <on> {max-size|unbounded}

--local
-l

Doing fsradm itself

POST/api/v1/snapshot-storage/{volume}/to/{storage}

Change the settings of snapshot storage.

6

snapshot-storage delete <for> <on>
snapshot-storage del <for> <on>

--local
-l

Doing fsradm itself

DELETE/api/v1/snapshot-storage/{volume}/to/{storage}

Delete the snapshot storage.

management

The driver command is for Windows only and is not available for Linux.

classification

command

option

Option Description

Usage API

Description

classification

command

option

Option Description

Usage API

Description

1

driver installation

driver install

--force
-f

force install

-

Install the driver. Fails when the driver is loading.
When using the forced installation option, remove the driver being loaded before installing it.

2

remove driver

driver uninstall

--force
-f

forced removal

-

uninstall the driver Fails when the driver is loading.
When using the forced installation option, separate and remove the driver being loaded.

3

engine restart

system restart
sys restart

-

 

POST /api/v1/system/restart

Restarts the entire operation of the engine while maintaining the current process PID.

4

engine shutdown

system stop
sys stop

-

 

POST /api/v1/system/stop

Sends a shutdown command to the running engine to shut itself down. If running as a service, it will automatically restart.

equipment

classification

command

option

Option Description

Usage API

Description

classification

command

option

Option Description

Usage API

Description

1

RID comparison

control rid compare <rid1> <rid2>
rid compare <rid1> <rid2>

-

-

POST /api/v1/tool/rid_compare

Outputs the comparison result of two RIDs.

2

 

Create support file

system support
sys su

--dump <file>
-d <file>

Specify dump files to include

 

Create support file

license

classification

command

option

Usage API

Description

classification

command

option

Usage API

Description

1

setting

license set <license-file>

-

PUT /api/v1/license

Read the specified file to set the license.

2

check

license show

-

GET/api/v1/license

Print the current license status.