개요

버전

FSR 1.x

XML 표기 방식

dump-xml을 통해 얻을 수 있는 XML 형식의 구성 파일 내용에는 userdata 속성이 누락됩니다제외됩니다.

• 태그명

  • 속성의 상위에 다음과 같이 태그가 존재함을 나타냄
    예) tag1/tag2

    Code Block
    language xml
    <tag1> <tag2></tag2> </tag1>

• Status
  colour Purple title attribute

  • 해당 태그의 attribute를 사용 함

• Status
  title text

  • 해당 태그의 텍스트를 사용 함

...

• Status
  colour Red title no

  • 동적으로 적용되지 않는 속성. 시스템 구성의 경우 서비스 재시작, 리소스 구성의 경우 Down/Up의 절차가 필요 함Up이 필요합니다.

• Status
  colour Yellow title adjust

  • 구성 조정 명령을 통해 동적으로 갱신 되는 속성가능한 속성입니다.

• Status
  colour Yellow title adjust_EACH

  • 시스템 구성 조정 명령 실행 후, 실행 중인 리소스에 적용하려면 해당 리소스에 대한 구성 조정 명령도 실행해야 하는 속성속성입니다.

• Status
  colour Green title reconn

  • 구성 조정 명령 실행 후 노드 간 재 접속이 필요한 속성속성입니다.

• Status
  colour Green title promote

  • 구성 조정 명령 실행 후 강등/승격이 필요한 속성속성입니다.

숫자 자료형의 범위

• 32비트 정수: 0부터 2³¹-1 (2147483647)

...

• options

  • hostname

  • resources_path

  • database_path

  • auto_up

  • rpc_address

  • rest_address

  • file_handle_limit

  • sync_hash_type

  • max_block_size

• log

  • level

  • console

    • enable

  • file

    • enable

    • location

    • size_limit

    • size_limit

• file_buffer

  • location

  • limit

  • warn

  • auto_recover

• disk

  • minimum

  • period

• archive

  • period

  • location

• userdata

항목별 옵션

options

프로그램 시작 시 사용되는 설정. 동적으로 적용되지 않는다시작점에 적용 되는 설정 입니다. 동적으로 적용할 수 없습니다.

log

로그 관련 설정 입니다.

file_buffer

파일 버퍼 설정 입니다.

disk

디스크 모니터링 관련 설정 입니다.

archive

삭제/고아 파일 보관 관련 설정입니다.

...

사용자 속성. object 형태의 데이터를 자유롭게 추가 할 수 있다있습니다.

리소스 설정

{
  "id": "r0",
  "description": "test resource",
  "auto_up": true,
  "nodes": [
    {
      "name": "node1",
      "url": "192.168.35.101:9876",
      "files": [
        {
          "path": "E:\\Repl\\Datas",
          "type": "directory",
          "recursive": true,
          "exclude_patterns": [],
        },
        {
          "path": "E:\\Repl\\data.xml",
          "type": "file",
        }
      ],
      "auto_file_lock": "off"
    },
    {
      "name": "node2",
      "url": "192.168.35.102:9876",
      "directories": [
        {
          "path": "F:\\Repl\\Datas",
          "type": "directory",
          "recursive": true,
          "exclude_patterns": [],
        },
        {
          "path": "F:\\Repl\\data.xml",
          "type": "file",
        }
      ],
      "auto_file_lock": "off"
    }
  ],
  "connections": [],
  "options": {
    "recursive": true,
    "exclude_patterns": [
      "*.tmp"
    ],
    "sync": {
      "attributes": false,
      "permissions": "none",
    },
    "auto_file_lock": "off",
    "database_path": ""
  },
  "userdata": null
}

...

노드 목록은 동적 적용 시 'name'을 기준으로 적용되므로 작성 순서는 관계없다관계 없습니다. 네트워크 관련 속성은 재 접속이 필요한 속성이 있으므로 해당 속성은 'RECONN'으로 명시하였다명시하였습니다.

최상위 옵션

리소스의 기본 설정

...

특이사항

• 0.7에서 추가 된 hostname 속성을 지정하지 않으면 기존과 같이 name 속성이 노드명과 호스트명의 역할을 동시에 수행한다수행합니다.

connections

노드 간 연결에 대한 정의. node1과 node2의 연결에 대한 정의를 기록하며, 연결 설정이 정의되지 않은 노드 간 연결은 기본 값을 사용한다사용합니다.
(XML: connections/connection)

...

사용자 속성. object 형태의 데이터를 자유롭게 추가 할 수 있다있습니다.

속성의 적용 수순

동일한 이름의 항목이 서로 다른 섹션에 정의 된 경우, 하위 섹션의 값을 사용하여 동작한다동작합니다. 즉 하위 섹션에서 재정의 할 수 있다있습니다.
각 섹션의 상하 관계는 다음과 같다같습니다. (우측이 하위 섹션)

시스템 구성 > 리소스 구성의 상위 속성 (network, options) > 리소스 구성의 nodes > 리소스 구성의 connections

목록으로 정의된 값(예: 제외 필터)의 경우 상위 섹션의 값에 하위 섹션의 값을 병합시켜 동작한다동작합니다. 예를 들어 다음의 항목은 우측의 값이 우선 적용 된다됩니다.

• resource.options.recursive → resource.nodes.files.recursive

• resource.options.sync.attributes → resource.nodes.files.sync.attributes

• resource.options.sync.permissions → resource.nodes.files.sync.permissions

• system.archive.period → resource.nodes.files.archive.period

• system.archive.location → resource.nodes.files.archive.location

• resource.nodes.buffer.size → resource.connections.buffer.size

• system.file_buffer.location → resource.nodes.file_buffer.location

• system.file_buffer.limit → resource.nodes.file_buffer.limit → resource.connections.file_buffer.limit

• system.file_buffer.warn → resource.nodes.file_buffer.warn → resource.connections.file_buffer.warn

• resource.network.ping_interval → resource.connections.network.ping_interval

• resource.network.compress → resource.connections.network.compress

• resource.network.tls → resource.connections.network.tls

• resource.network.limit → resource.connections.network.limit

다음의 항목은 위의 방식과 다르게 동작한다동작합니다.

• 병합되어 사용되는 항목

  • resource.options.exclude_patterns + resource.nodes.files.exclude_patterns

• 상하 관계로 동작하는 항목

  • system.auto_up / resource.auto_up

    • 시스템 구성의 값을 true로 지정한 경우에만 리소스 구성의 값이 유효하다유효합니다.