Commands
- 1 Target
- 2 outline
- 2.1 setting
- 2.2 check
- 2.3 control
- 2.4 watch
- 2.5 management
- 3 REST-API
- 4 command
- 4.1 setting
- 4.2 control
- 4.2.1 sync options
- 4.3 check
- 4.4 EFS
- 4.5 network file system
- 4.6 snapshot
- 4.7 snapshot image
- 4.8 snapshot storage
- 4.9 management
- 4.10 equipment
- 4.11 license
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 | ||
---|---|---|---|---|---|---|
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, | |
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, | |
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. | |
24 | stop resource | POST | /api/v1/resource/{ID}/down | Disconnect and detach resources | all available. | |
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 | 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 | 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 | 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 | 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. control
Since 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 | |
---|---|---|---|---|---|
1 | system config dump | - | - | GET /api/v1/config/dump | Output the contents of a system configuration file as JSON. |
2 | system config dump-xml | - | - | GET /api/v1/config/dump-xml | Output the contents of system configuration files to XML. |
3 | system config show | - | - | GET /api/v1/config | Outputs system configuration contents in operation as JSON. |
4 | system config adjust | - | - | POST /api/v1/config/adjust | The contents of the system configuration file are applied to running resources and activated. |
5 | system config edit | -u, -user | Edit with text editor | GET /api/v1/config | Interactively edit and apply system configurations. |
6 | system config property get | - | - | GET/api/v1/config | Outputs the value of the specified property in the system configuration file. |
7 | system config property set | --adjust | apply to resource | GET/api/v1/config | Changes the specified property value in the system configuration file. |
8 | system config property unset | - | - | same | Change the specified properties in the system configuration file to default values. |
9 | control config dump | - | - | GET /api/v1/resource/{ID}/dump | Output the contents of a resource configuration file as JSON. |
10 | control config dump-xml | - | - | GET /api/v1/resource/{ID}/dump-xml | Output the content of a resource configuration file to XML. |
11 | control config show | - | - | GET /api/v1/resource/{ID} | Outputs the contents of the resource configuration in operation as JSON. |
12 | control config adjust | - | - | 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 | --force | force overwrite | PUT /api/v1/resource/{ID} | Add resource configuration file. |
14 | --interactive | Interactive setting mode | |||
15 |
| --force | force delete | DELETE/api/v1/resource/{ID} | Delete the resource configuration file. |
16 | control config edit | --user | Edit with text editor | GET/api/v1/resource/{ID} | Interactively edit and apply resource configurations. |
17 | control config property get | - | - | GET/api/v1/resource/{ID} | Outputs the value of the specified property in the resource configuration file. |
18 | control config property add | --adjust | apply to resource | GET/api/v1/resource/{ID} | Adds a value to a specified attribute in a resource configuration. |
19 | --index
| insert at specified index | |||
20 |
| --adjust | apply to resource | same | Delete the specified attribute of the resource configuration. |
21 | control config property set | same | same | same | Changes the value of the specified attribute in the resource configuration file. |
22 | control config property unset | 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 | |
---|---|---|---|---|---|
1 | control meta create | --force | force overwrite | POST /api/v1/resource/{ID}/create-meta | Generate resource metadata. |
2 | control meta delete | --force | force delete | POST /api/v1/resource/{ID}/delete-meta | Delete resource metadata. |
3 | control meta cleanup | - | - | POST /api/v1/resource/cleanup-meta | Clean up unused metadata. |
4 | control add | - | - | POST /api/v1/resource/{ID}/add | Read the resource configuration file and load it into the resource list. |
5 | control of | - | - | POST /api/v1/resource/{ID}/delete | Remove loaded resources from the list. |
6 | control attach | - | - | POST /api/v1/resource/{ID}/attach | Load resource file. |
7 | control detach | - | - | POST /api/v1/resource/{ID}/detach | Separate resource files. |
8 | control up | - | - | POST /api/v1/resource/{ID}/up | resource activation. (load, file load, connect) |
9 | control down | - | - | POST /api/v1/resource/{ID}/down | Disable resource. (end connection, disconnect file, disconnect) |
10 | control primary | --force | forced promotion | POST /api/v1/resource/{ID}/primary | Promote a resource to Primary. |
11 | --unlock | unlock file | |||
12 | control secondary | --timeout | time limit | POST /api/v1/resource/{ID}/secondary | Demote a resource to Secondary. The --read-only option must be used together with the --lock option. |
13 | --lock | file lock | |||
14 | --read-only | lock to read only | |||
15 | control connect | --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 | - | - | POST /api/v1/resource/{ID}/disconnect/{PEER} | Disconnection with partner node. It changes to standalone status. |
17 | control invalidate | --level | synchronization level | POST /api/v1/resource/{ID}/resync/{PEER} | Synchronization starts with partner node as source. |
18 | --report | Report generation scope | |||
19 | control invalidate-remote | --level | synchronization level | POST /api/v1/resource/{ID}/resync-remote/{PEER} | Start synchronization with this node as source. |
20 | --report | Report generation scope | |||
21 | control verify | - | - | POST /api/v1/resource/{ID}/verify/{PEER} | Start consistency verification with partner node as source. |
22 | control verify-stop | - | - | POST /api/v1/resource/{ID}/verify-stop/{PEER} | Abort Consistency Verification in progress. 1.1 or higher. |
23 | control pause | - | - | POST /api/v1/resource/{ID}/pause | Synchronization or replication paused. |
24 | control resume | - | - | POST /api/v1/resource/{ID}/resume | Resume synchronization or replication. |
25 | control lock | --read-only | lock to read only | POST /api/v1/resource/{ID}/lock/{LEVEL} | Start protecting your files. |
26 | control unlock | - | - | POST /api/v1/resource/{ID}/unlock | Unprotect the file. |
27 | control close-files | - | - | POST /api/v1/resource/{ID}/close-files | Closes handles to files that are open for cloning. |
28 | control override network-limit | - | - | PUT /api/v1/resource/{ID}/override/network-limit/{PEER} | Randomly change the network bandwidth. |
29 | control restore network-limit | - | - | 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:
Modify the content without changing the size of the file
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 | |
---|---|---|---|---|---|
1 | system info | - | - | GET /api/v1/system | Engine information output. |
2 | control status | --verbose | verbose output | GET /api/v1/resource/{ID}/status | Status output of resources and connections. |
3 | --watch | monitoring | |||
4 | --interval | Renewal cycle when monitoring | |||
5 | control perf | --verbose | verbose output | GET /api/v1/resource/{ID}/perf | Performance statistics output, such as buffers and networks for resource connections. |
6 | --watch | monitoring | |||
7 | --interval | Renewal cycle when monitoring | |||
8 | control latency | --verbose | 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 | monitoring | |||
10 | --interval | Renewal cycle when monitoring | |||
11 | control result | --verbose | verbose output | GET /api/v1/resource/{ID}/result | Output the results of the most recent synchronization or consistency verification. |
12 | control rid show | --verbose | verbose output | GET /api/v1/resource/{ID}/rid | RID output of the resource. |
13 | --long | Long version of RID output | |||
14 | events | --json | output in JSON format | GRPC SubscribeEvents | event monitoring. |
15 | --sync | Include sync progress | |||
16 | --perf | Include performance statistics | |||
17 | --interval | Synchronization progress and performance statistics refresh rate | |||
18 | log | --home | engine home path | GRPCSubscribeEvents | Print the contents of the log file. |
19 | --lines | number of lines to output | |||
20 | --resource | resource designation | |||
21 | --no-main | Disable main log | |||
22 | --no-resource | Disable resource log | |||
23 | --no-color | do not produce | |||
24 | --follow | continuous output | |||
25 | perfmon | --json | Export to JSON file | GRPC SubscribePerfs | Displays performance monitor information. If you use the --display option, you can output to the screen while exporting to a file. |
26 | --csv | Export to CSV file | |||
27 | --interval | information update cycle | |||
28 | --display | output to console screen | |||
29 | --watch | 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
nothing
is 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.
full
When synchronizing , this information is created only when the report creation range is specified as ,summary
and 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, occur
you can get the occurrence time of the event through the field.
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. |
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 | |||
92 | younger | younger node name | - | |||
93 | Recognize partner node name | peer_recognized | resource | resource ID | - | Occurs only when the partner node is a group. |
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. |
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 | |
---|---|---|---|---|---|
1 | efs analyze dir | --json | 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 | verbose output | |||
3 | efs analyze resource | --json | 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 | verbose output |
Control the engine execution account store
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 | --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 | --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 | set as current certificate | |||
5 | efs cert set-current | - | - | 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 | - | - | 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 | |
---|---|---|---|---|---|
1 | efs usercert list | - | - | GET/api/v1/efs/cert | Prints a list of certificates in the certificate store. |
2 | efs usercert export | --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 | --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 | set as current certificate | |||
5 | efs usercert set-current | - | - | 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 | - | - | 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 | |
---|---|---|---|---|---|
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 | --username | username | PUT/api/v1/nfs | Register network file system connection information in the FSR execution account. |
3 | --password | password | |||
4 | nfs del | - | - | DELETE /api/v1/nfs/{name} | Deletes the network file system connection information registered in the FSR execution account. |
5 | nfs connect | - | - | POST /api/v1/nfs/{name}/connect | Connect to the specified network file system. |
6 | nfs disconnect | - | - | 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 | |
---|---|---|---|---|---|
1 | snapshot list | --verbose | verbose output | GET /api/v1/resource/{ID}/snapshot | Prints a list of snapshots of the specified resource. |
2 | --desc | sort in reverse order | |||
3 | snapshot list-exposed | --desc | sort in reverse order | GET/api/v1/resource/{ID}/snapshot | Prints a list of snapshots linked to the letter. |
4 | snapshot show | - | - | GET /api/v1/resource/{ID}/snapshot/{SnapshotID} | Display detailed information of the specified snapshot. |
5 | snapshot create | - | - | PUT /api/v1/resource/{ID}/snapshot/{SnapshotID} | Creates a snapshot of the specified ID. |
6 | snapshot delete | - | - | DELETE/api/v1/resource/{ID}/snapshot/{SnapshotID} | Delete the specified snapshot. |
7 | snapshot rename | - | - | POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/rename-to/{NewSnapshotID} | Changes the ID of the specified snapshot. |
8 | snapshot recovery
| - | - | POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/recovery | Restores the resource replication path to the specified snapshot. |
9 | snapshot export | --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 | - | - | POST /api/v1/resource/{ID}/snapshot/cancel | Cancels the snapshot-related operation of the specified resource. |
11 | snapshot cleanup | - | - | 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 | - | - | POST /api/v1/resource/{ID}/snapshot/{SnapshotID}/expose/{SnapshotIndex} | Links the specified snapshot image to the specified path (letter). |
13 | snapshot unexpose | - | - | 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 | |
---|---|---|---|---|---|
1 | snapshot-image list | --unlinked-only | Outputs only lists that are not associated with resources | GET /api/v1/snapshot-image | Prints a list of snapshot images. |
2 | --local | Doing fsradm itself | |||
3 | snapshot-image delete | --local | Doing fsradm itself | DELETE /api/v1/snapshot-image/{image} | Delete the specified snapshot image. |
4 | snapshot-image expose | --local | Doing fsradm itself | POST /api/v1/snapshot-image/{image}/expose | Links the specified snapshot image to the specified path (letter). |
5 | snapshot-image unexpose | --local | 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 | --local | 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 | |
---|---|---|---|---|---|
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 | Doing fsradm itself | |||
4 | snapshot-storage add | --local | Doing fsradm itself | PUT /api/v1/snapshot-storage/{volume}/to/{storage} | Add snapshot storage. |
5 | snapshot-storage change | --local | Doing fsradm itself | POST/api/v1/snapshot-storage/{volume}/to/{storage} | Change the settings of snapshot storage. |
6 | snapshot-storage delete | --local | 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 | |
---|---|---|---|---|---|---|
1 | driver installation | driver install | --force | force install | - | Install the driver. Fails when the driver is loading. |
2 | remove driver | driver uninstall | --force | forced removal | - | uninstall the driver Fails when the driver is loading. |
3 | engine restart | system restart | - |
| POST /api/v1/system/restart | Restarts the entire operation of the engine while maintaining the current process PID. |
4 | engine shutdown | system 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 | |
---|---|---|---|---|---|---|
1 | RID comparison | control rid compare | - | - | POST /api/v1/tool/rid_compare | Outputs the comparison result of two RIDs. |
2 |
Create support file | system support | --dump | Specify dump files to include |
| Create support file |
license
classification | command | option | Usage API | Description | |
---|---|---|---|---|---|
1 | setting | license set | - | 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. |