4.1. Configuration Type

FSR은 대표적으로 다음과 같은 구성 유형을 지원합니다. 

4.1.1. 1:1 Replication

소스 노드와 타깃노드를 대상으로 한 1:1 복제 구성입니다.

<그림>

4.1.2. 1:N Replication

하나의 소스노드를 다수의 타깃노드로 동시 복제하는 1:N 복제 구성입니다.

<그림>

4.1.3. N:1 Replication

다수의 노드를 소스로 하고 하나의 노드를 타깃으로 구성하는 N:1 복제 방식 입니다.

<그림>

4.1.4. Local Replication

소스와 타깃의 경로를 하나의 노드로 지정하는 방식입니다. 타깃노드를 별도로 구성하지 않고 로컬 마이그레이션을 하기위한 용도로 사용합니다.

<그림>

4.1.5. Shared Volume Replication

하나의 소스 데이터를 두 노드가 공유하고 타깃 노드로 복제하는 구성입니다. 공유 볼륨은 SAN 형태의 스토리지 볼륨, NFS의 공유볼륨을 대상으로 합니다.

다만 NFS 공유 볼륨에 대한 복제는 네트워크 공유의 특성상 FSR이 공유 볼륨에 접근하는 클라이언트 호스트들 모두 통제할 수 없기 때문에 복제 대상 데이터의 변경분을 실시간 추적할 수 없는 구조입니다. 따라서 NFS 공유 복제는 주기적으로 동기화를 하는 백업 방식입니다.

<그림- 공유 스토리지>

<그림- NFS 공유>

4.2. 구성 파일

구성파일은 FSR 의 구성형태를 표현하는 json 형식의 텍스트 파일로 시스템 구성파일과 리소스 구성파일이 있습니다. 시스템 구성파일은 FSR의 동작에 필요한 노드 기준의 전반적인 경로들이 지정되고, 리소스 구성파일에서 ip주소, 복제대상, 핸들러 등 복제를 위한 구체적인 사항을 기술합니다. 

구성파일은 직접 작성하고, 운영중인 구성 파일을 수정할 경우는 직접 수정하여 CLI 명령 또는 REST-API 로 갱신할 수 있습니다.

FSR 엔진은 리소스 기동 시점에 구성 파일을 해석하여 구성 형태에 맞게 노드 간 연결 및 복제 대상경로 등을 초기화 하고 복제 서비스를 리소스 단위로 준비합니다. 

구성파일의 형식과 관련한 세부 속성은 Appendix C. 구성파일의 내용을 참고하세요.

4.2.1. 시스템 구성

시스템 구성파일은 config.json 파일입니다. 별도 경로를 지정하지 않을 경우

Configuration Type

FSR typically supports the following configuration types:

1:1

1:1 replication configuration for source and target nodes.

1:N

1: N replication configuration that simultaneously replicates one source node to multiple target nodes.

N:1

N:1 replication method with multiple nodes as source and one node as target.

Local Replication

This is a way to specify the source and target of replication to one node. It is used to do local backup or local migration without separate target node.

Shared Volume Replication

A configuration in which one source data is shared by two (active-standby) nodes and replicates this source data to a third target node. This approach is used when a SAN-like storage shared volume is shared by two nodes simultaneously and replicated to DR in real time.

Periodic synchronization

This is a configuration method for volumes that only perform periodic synchronization. It does not perform real-time replication. In particular, volumes that cannot perform real-time replication, such as remote NAS shared volumes, can be backed up periodically using this method.

The target can be DAS or NAS, but in the case of NAS targets, FSR cannot be installed on the NAS, so it must be ensured that no writes occur to the target resource (to maintain consistency).

However, be sure to specify synchronization for NFS shared volumes as a source only, and not as a synchronization target. Because NFS shared volumes are written to by multiple clients, you cannot control the FSR engine as a single synchronization target. For more information on this, see Periodic synchronization in the appendix.

Configuration File

The configuration file is a json format text file that describes the configuration type and attributes of the replication. It is described as a system configuration file and a resource configuration file. The system configuration file specifies node global paths necessary for FSR operation, and the resource configuration file describes the specifics of replication such as ip address, replication target, and handler. Basically, the configuration file should be created by hand. If you want to change the properties of a running resource, modify the configuration file and apply it by executing adjust command using CLI or REST-API.

The FSR engine prepares replication services by interpreting configuration files at resource startup and initializing node-to-node connections and replication target paths according to the configuration.

For details on the configuration file format, refer to Attributes.

System Config.

The system configuration file is a config.json file. If you do not specify a separate path, it is located in the path in %FSR_HOME%/conf/config.json 의 경로에 위치합니다.구성파일을 수정한 뒤 적용하기 위해서는 프로그램을 재 실행하거나 다음의 갱신 명령을 실행합니다.

After modifying the configuration file, run the program again or run the following update command.

fsradm config adjust

4.2.2. 리소스 구성

...

Resource Config.

The file format of the resource file is '*.res' 이며, 경로는 시스템 설정 파일의 and the path is specified in the 'options/resource_path' 항목에 명시되어 있습니다entry in the system configuration file.
The default value of resource_path 의 기본 값은 현재 위치is the current location ('.') 이고 시스템 구성 파일의 위치를 기준으로 하여, 기본 위치는 config.json 파일의 위치와 같습니다.다음은 리소스 구성 파일의 예 입니다and based on the location of the system configuration file, the default location is the same as the location of the config.json file.

The following is an example of a resource configuration file.

{
  "id": "r0",
  "description": "test resource",
  "auto_start": true,
  "nodes": [
    {
      "name": "node1-hostname",
      "urls": {
        "repl": "10.20.200.75:9810",
        "sync": "10.20.200.75:9811"
      },
      "directories": [
        {
          "path": "G:/test/r0",
          "exclude_patterns": [
          ]
        }
      ]
    },
    {
      "name": "node2-hostname",
      "urls": {
        "repl": "10.20.200.76:9810",
        "sync": "10.20.200.76:9811"
      },
      "directories": [
        {
          "path": "G:/test/r0",
          "exclude_patterns": [
          ]
        }
      ]
    }
  ],
  "connections": [
    {
      "node1": {
        "name": "node1-hostname"
      },
      "node2": {
        "name": "node2-hostname"
      },
      "buffer": {
        "size": 1024
      },
      "network": {
        "ping_interval": 10,
        "compress": false,
        "tls": false,
        "limit": 0
      }
    }
  ],
  "options": {
    "exclude_patterns": [
    ]
  }
}

기본 구성

• 리소스를 식별하기 위한 ID를 기술합니다.
• 복제 대상 노드들을 nodes 항목에 배열 형식으로 기술합니다. node 항목 내에서 hostname, ip 주소:포트 를 기술합니다. hostname 을 기술하지 않고 IP 주소로 name 항목을 기술할 수도 있습니다.
• 복제대상을 directories 항목에 디렉터리와 파일로 기술합니다. 필요하다면 제외패턴을 추가적으로 기술합니다.

개별 연결 구성

...

Basic Config.

• Describes an ID to identify a resource.
• The replication target nodes are described in an array format in the nodes item. Describe the hostname, ip address: port in the node entry. You can also describe the name entry by IP address without describing hostname.
• The replication target is described as directories and files in the directories item. If necessary, provide additional exclusion patterns.

Connection Config.

Unless otherwise noted in the connections entry, all replicated nodes individually establish TCP connections. This is called a mesh network. In a mesh network, duplicate connections for n nodes are created by n * (n-1) / 2 만큼 생성됩니다.

운영 상황에 따라 복제 연결을 제한하거나 연결 정보를 별도 기술할 필요가 있을 때 connections 항목을 기술합니다. connections 는 개별 연결에 대해 배열로 기술합니다.

각각의 연결은 2 개의 노드에 대한 연결을 의미하여 node1, node2로 고정된 항목에서 기술합니다. node1.name, node2.name 의 항목은 앞서 node 항목에서 기술한 name 내용을 동일하게 기술하여 node 항목과 connections.node1, connections.node2 의 항목이 매칭되도록 합니다.

보통의 경우에 있어서는 개별연결을 구성하지 않고 mesh 네트워크로 구성하여 복제합니다.

제외 패턴

복제 대상에서 배제할 필요가 있는 파일에 대해선 제외 패턴을 통해 복제 대상에서 제외할 수 있습니다. 제외 패턴은 와일드카드(*, !) 기호를 사용하여 손쉽게 기술할 수 있습니다.

버퍼 구성

비동기 복제에 있어서 실시간 I/O 변경 분은 버퍼에 축적되어 타깃에 순차적으로 반영되기 때문에 버퍼링이 지속되는 한 타깃이 데이터는 최신의 복제 상태를 유지할 수 있게 됩니다. 따라서 버퍼를 구성하는 것은 FSR 구성에 있어서 가장 중요한 사항으로 리소스를 기동하기 전에 버퍼 용량과 관련한 사항들을 운영환경에 맞게 구성해야 합니다. 

버퍼는 커널에 고정적으로 할당되는(비페이징 풀) 커널 메모리 버퍼와 파일로 할당되는 파일버퍼로 제공됩니다. 시스템의 가용한 커널 메모리는 한정적이기 때문에 시스템의 메모리 상황에 맞게 메모리 버퍼를 산정해야 하고 메모리 버퍼 공간이 부족할 경우 추가적으로 파일버퍼로 충당할 수 있습니다. FSR은 메모리버퍼를 우선하여 사용하고 메모리 버퍼가 다 사용될 경우 파일버퍼링으로 전환하여 처리합니다. 만약 두 버퍼가 모두 오버플로우 된다면 버퍼링은 중단되어 버퍼링되었던 데이터들은 버려지고 재동기화 단계로 이행하게 됩니다. 따라서 가능한 한 버퍼링 공간을 많이 확보하여 동기화 상태로 전환되지 않도록 복제 상태를 유지할 필요가 있습니다.

또한 이 두가지 방식의 버퍼는 메모리와 파일을 대상으로 I/O를 수행하기 때문에 근본적으로 성능에 큰 차이를 보입니다. 로컬 시스템의 I/O 부하가 큰 상황에서는 메모리 버퍼를 많이 확보하는 운영방식이 성능에 유리합니다.

버퍼는 복제 연결 단위로 작동하기 때문에 1:N 복제의 경우 연결 개수(N) 만큼 개별적으로 지정해야 합니다.

메모리 버퍼

커널에서 할당되는 메모리는 가용 용량이 제한적입니다. 시스템 가용 용량에 비해 너무 많이 할당할 경우 시스템 성능에 영향을 줄 수 있으므로 적정한 수준으로 할당해야 합니다.

최대 수십GB 까지 할당할 수 있으며 보통 수GB 수준으로 할당합니다.

파일 버퍼

파일버퍼는 파일버퍼가 위치하는 디스크의 공간이 허용되는 용량 만큼 할당할 수 있습니다. 최대 수십TB 까지 할당할 수 있으며 보통 수십GB 수준의 대용량으로 운영할 수 있습니다. 파일버퍼는 시스템 볼륨의 경로로 구성할 경우 파일버퍼의 읽기,쓰기 I/O 로 인해 시스템 전반의 성능에 영향을 줄 수 있기 때문에 별도의 디스크 경로로 운영하는 것을 권장합니다. .

If you need to limit the replication connection or describe the connection information according to the operating situation, additionally describe the “connections” item. connections describes an individual connection as an array.

Each connection is a connection to two nodes and is described in the fixed items of node1 and node2. The node1.name and node2.name entries describe the same name as described in the node entry above so that the node entries match the connections.node1 and connections.node2 entries.

In the normal case, the network is replicated by configuring a mesh network instead of configuring individual connections.

Exclusion Pattern

Files that need to be excluded from the replication target can be excluded from the replication target through the exclusion pattern. Exclusion patterns can easily be described using wildcard (*,!) Symbols.

Buffer Config.

In asynchronous replication, real-time I/O changes are accumulated in the buffer and reflected in the target sequentially so that the target data can be kept up to date as long as buffering continues. Therefore, configuring a buffer is the most important aspect of FSR configuration. Before starting resources, the buffer capacity must be configured according to the operating environment.

The buffers are provided as kernel memory buffers that are fixedly allocated to the kernel (nonpaged pool) and file buffers that are allocated as files. Since the available kernel memory of the system is limited, it is necessary to estimate the memory buffer according to the memory situation of the system, and if the memory buffer space is insufficient, additional file buffers can be used. FSR takes priority of the memory buffer and switches to file buffering when the memory buffer is used up. If both buffers overflow, the buffering stops and the buffered data is discarded and moved to the resynchronization phase. Therefore, it is necessary to reserve as much buffering space as possible so that replication status remains.

In addition, these two types of buffers perform I/O to memory and files, so there is a fundamental difference in performance. In situations where the local system has a high I/O load, operating with more memory buffers is advantageous for performance.

Because buffers operate on a per-connection basis, for 1:N replication, you must separately specify as many as the number of connections.

Memory Buffer

Memory allocated by the kernel is limited in its available capacity. Allocating too much for the system's usable capacity can affect system performance and should be allocated at an appropriate level.

You can allocate up to several tens of gigabytes, and usually assign several gigabytes.

File Buffer

The file buffer can be allocated as much space as the space on the disk where the file buffer is located. Up to several tens of Tera Bytes can be allocated and can operate at large capacity, typically tens of gigabytes. If a file buffer is configured as a path of the system volume, it is recommended to operate as a separate disk path because file buffer read/write I/O can affect the overall system performance.

Configure DRX integration

To configure DRX integration for building a DR site, see Configuring file replication.