Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

4.1. Configuration Type

...

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. 시스템 구성파일은 FSR의 동작에 필요한 노드 기준의 전반적인 경로들이 지정되고, 리소스 구성파일에서 ip주소, 복제대상, 핸들러 등 복제를 위한 구체적인 사항을 기술합니다. 

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

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

구성파일의 형식과 관련한 세부 속성은 Appendix C. 구성파일의 내용을 참고하세요 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 Appendix C. Configuration Files.

4.2.1.

...

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.

Code Block
languagejs
titler0.res
{
  "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": [
    ]
  }
}


Info

FSR의 구성파일은 json 형식으로 기술하며 json 형식에 따라 하나의 속성을 키와 값의 쌍으로 기술합니다. 속성의 유형에 따라 객체(object)와 배열(array)형식으로 기술할 수 있으며, 객체는 중괄호로 구분하고 배열은 대괄호로 구분합니다. 또한 객체와 배열은 혼합하여 기술할 수 있습니다.

기본 구성

...

The configuration file of an FSR is described in the json format, which describes one attribute as a key and value pair according to the json format. Depending on the type of property, it can be described in the form of object and array, with the object separated by braces and the array separated by square brackets. In addition, objects and arrays can be described in a mixture.

Basic Configuration

  • 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.

개별 연결 구성

connections 항목을 별도 기술하지 않을 경우 복제 대상 노드들은 개별적으로 모두 연결을 수립합니다. 이것을 mesh 네트워크라고 합니다. mesh 네트워크에서 n 노드에 대한 복제 연결은 n*(n-1)/2 만큼 생성됩니다.

...