Table of Contents |
---|
...
Include Page |
---|
버전
|
...
XML 표기 방식
dump-xml을 통해 얻을 수 있는 XML 형식의 구성 파일 내용에는 userdata 속성이 제외됩니다.
태그명
속성의 상위에 다음과 같이 태그가 존재함을 나타냄
예) tag1/tag2Code Block language xml <tag1> <tag2></tag2> </tag1>
Status colour Purple title attribute 해당 태그의 attribute를 사용 함
Status title text 해당 태그의 텍스트를 사용 함
동적 적용 표기 방식
Status colour Red title no 동적으로 적용되지 않는 속성. 시스템 구성의 경우 서비스 재시작, 리소스 구성의 경우 Down/Up이 필요합니다.
Status colour Yellow title adjust 구성 조정 명령을 통해 동적으로 갱신 가능한 속성입니다.
Status colour Yellow title adjust_EACH 시스템 구성 조정 명령 실행 후, 실행 중인 리소스에 적용하려면 해당 리소스에 대한 구성 조정 명령도 실행해야 하는 속성입니다.
Status colour Green title reconn 구성 조정 명령 실행 후 노드 간 재 접속이 필요한 속성입니다.
Status colour Green title promote 구성 조정 명령 실행 후 강등/승격이 필요한 속성입니다.
숫자 자료형의 범위
32비트 정수: 0부터 231-1 (2147483647)
시스템 설정
...
title | 설정 파일 예제 |
---|
...
language | json |
---|
...
|
...
Expand | |||||
---|---|---|---|---|---|
| |||||
|
구조
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
space
minimum
period
health
period
archive
period
location
userdata
항목별 옵션
options
프로그램 시작점에 적용 되는 설정 입니다. 동적으로 적용할 수 없습니다.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
hostname
...
호스트명
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
FSR에서 사용할 호스트명
설정하지 않으면 장비의 호스트명을 사용
...
Status | ||||
---|---|---|---|---|
|
...
resources_path
...
.
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
리소스 파일들이 위치하는 경로
설정 파일 위치를 기준으로 상대 경로로 동작한다
...
paths/resources/
Status | ||
---|---|---|
|
...
database_path
...
../db
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
리소스 상태를 저장하기 위한 경로
설정 파일 위치를 기준으로 상대 경로로 동작한다
...
paths/database/
Status | ||
---|---|---|
|
...
auto_up
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
true인 경우 FSR 시작 시 리소스 UP이 수행된다
...
Status | ||||
---|---|---|---|---|
|
...
rpc_address
...
0.0.0.0:5168
...
IPv4 / IPv6
...
{ip}:{port}
...
Status | ||||
---|---|---|---|---|
|
...
gRPC Listen address
...
addresses/rpc/
Status | ||
---|---|---|
|
...
rest_address
...
0.0.0.0:5167
...
IPv4 / IPv6
...
{ip}:{port}
...
Status | ||||
---|---|---|---|---|
|
...
REST-API Listen address
...
addresses/rest/
Status | ||
---|---|---|
|
...
file_handle_limit
...
128
...
32비트 정수
...
개수
...
Status | ||||
---|---|---|---|---|
|
...
복제를 위해 동시에 여는 파일 핸들 개수 제한
0으로 설정 시 기본 값 사용
...
Status | ||||
---|---|---|---|---|
|
...
sync_hash_type
...
crc32
...
crc32 / md5 / sha1 / sha256 / sha512
...
해시 유형
...
Status | ||||
---|---|---|---|---|
|
...
동기화에 사용할 해시 알고리즘 유형
...
Status | ||||
---|---|---|---|---|
|
...
0.9
...
max_block_size
...
1
...
1~30
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
최대 복제 I/O 블럭 크기
...
Status | ||||
---|---|---|---|---|
|
...
1.0-A2
log
로그 관련 설정 입니다.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
level
...
debug
...
debug / info / warn / error / fatal / panic
...
로그 레벨
...
Status | ||||
---|---|---|---|---|
|
...
로그 출력 레벨
...
Status | ||||
---|---|---|---|---|
|
...
console
...
enable
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
로그 콘솔 출력 여부
...
console/
Status | ||||
---|---|---|---|---|
|
...
file
...
enable
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
로그 파일 사용 여부
...
file/
Status | ||||
---|---|---|---|---|
|
...
filename
...
../logs
...
파일 경로
...
Status | ||||
---|---|---|---|---|
|
...
로그 파일의 경로 및 파일명
설정 파일 위치를 기준으로 상대 경로로 동작한다
...
file/
Status | ||
---|---|---|
|
...
size_limit
...
10
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
로그 파일 개별 크기 제한
0으로 설정 시 기본 값 사용
...
file/
Status | ||||
---|---|---|---|---|
|
...
rotate_count
...
10
...
32비트 정수
...
개수
...
Status | ||||
---|---|---|---|---|
|
...
로그 파일 롤링 시 유지할 개수
0으로 설정 시 기본 값 사용
...
file/
Status | ||||
---|---|---|---|---|
|
file_buffer
파일 버퍼 설정 입니다.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
location
...
../buffer
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
파일 버퍼 기본 위치
...
Status | ||
---|---|---|
|
...
limit
...
1024M
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
최대 크기. 동적 적용 시 리소스의 조정 명령도 실행해야 적용 된다.
0으로 설정 시 파일 버퍼 미사용
...
Status | ||||
---|---|---|---|---|
|
...
warn
...
10M
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
사용량 경고 임계치
0으로 설정 시 경고 비활성화
...
Status | ||||
---|---|---|---|---|
|
...
auto_recover
...
false
...
true / false
...
Boolean
...
-
...
동작 중지 임계치 도달 시 자동 재시작 여부
...
Status | ||||
---|---|---|---|---|
|
...
미사용
disk
디스크 모니터링 관련 설정 입니다.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
space
...
minimum
...
1024
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
디스크 남은 용량으로 인한 동작 중지 임계치
0으로 설정 시 모니터링 비활성화
...
Status | ||||
---|---|---|---|---|
|
...
period
...
30
...
32비트 정수
...
초
...
Status | ||||
---|---|---|---|---|
|
...
디스크 남은 용량 확인 주기
0으로 설정 시 모니터링 비활성화
...
Status | ||||
---|---|---|---|---|
|
...
health
...
period
...
1
...
32비트 정수
...
초
...
Status | ||||
---|---|---|---|---|
|
...
디스크 상태 확인 주기
0으로 설정 시 모니터링 비활성화
...
Status | ||||
---|---|---|---|---|
|
archive
삭제/고아 파일 보관 관련 설정입니다.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
period
...
0
...
32비트 정수
...
보관 기간(day)
...
Status | ||||
---|---|---|---|---|
|
...
삭제/고아 파일 보관 기간
0으로 설정 시 무기한 보관
...
Status | ||||
---|---|---|---|---|
|
...
location
...
../archives
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
삭제/고아 파일 보관 위치
설정 파일 위치를 기준으로 상대 경로로 동작한다
...
Status | ||
---|---|---|
|
userdata
...
|
...
리소스 설정
Expand | |||||
---|---|---|---|---|---|
| |||||
|
...
title | XML 출력 예제 |
---|
...
language | xml |
---|
...
|
...
|
...
|
...
구조
id
description
auto_up
nodes
index
name
hostname
url
files
path
type
recursive
exclude_patterns
sync
attributes
permissions
archive
enable
period
location
buffer
size
file_buffer
location
limit
warn
auto_up
auto_file_lock
connections
node1
name
url
node2
name
url
buffer
size
file_buffer
limit
warn
network
ping_interval
compress
tls
limit
options
recursive
exclude_patterns
auto_file_lock
database_path
sync
attributes
permissions
network
ping_interval
compress
tls
limit
handlers
options
timeout
timeout_action
after_resync_target
before_resync_target
before_resync_source
out_of_sync
local_io_error
userdata
항목별 옵션
노드 목록은 동적 적용 시 'name'을 기준으로 적용되므로 작성 순서는 관계 없습니다. 네트워크 관련 속성은 재 접속이 필요한 속성이 있으므로 해당 속성은 'RECONN'으로 명시하였습니다.
최상위 옵션
리소스의 기본 설정
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
id
...
파일명으로 사용 가능해야 함
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
리소스의 ID
리소스 파일명과 같아야 함
...
Status | ||||
---|---|---|---|---|
|
...
description
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
리소스의 설명
...
description/
Status | ||
---|---|---|
|
...
미사용
...
auto_up
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
true인 경우 FSR 시작 시 리소스 UP이 수행된다
...
Status | ||||
---|---|---|---|---|
|
nodes
복제 네트워크의 노드 목록.
(XML: nodes/node)
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
비고
...
index
...
0
...
32비트 정수
...
0 이상의 숫자
...
Status | ||||
---|---|---|---|---|
|
...
노드의 고유 번호
...
Status | ||||
---|---|---|---|---|
|
...
1.0-A3
...
name
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
노드명 또는 호스트명
...
Status | ||||
---|---|---|---|---|
|
...
hostname
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
노드의 호스트명
...
hostname/
Status | ||
---|---|---|
|
...
url
...
IPv4 / IPv6
...
{ip}:{port}
...
Status | ||||
---|---|---|---|---|
|
...
복제 연결 주소
...
Status | ||||
---|---|---|---|---|
|
...
files
(list)
...
path
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
복제 대상
...
files/file/
Status | ||||
---|---|---|---|---|
|
...
type
...
directory
...
directory / file
...
대상 유형
...
Status | ||||
---|---|---|---|---|
|
...
복제 대상 유형
...
files/file/
Status | ||||
---|---|---|---|---|
|
...
0.9
...
recursive
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
하위 디렉토리 포함 여부
...
files/file/
Status | ||||
---|---|---|---|---|
|
...
exclude_patterns (list)
...
제외 패턴
...
Status | ||||
---|---|---|---|---|
|
...
제외 패턴
...
files/file/exclude_patterns/pattern/
Status | ||
---|---|---|
|
...
sync
...
attributes
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
속성 동기화 여부
...
files/file/sync/
Status | ||||
---|---|---|---|---|
|
...
1.0
...
permissions
...
name
...
name / sid / none
...
문자열 플래그
...
Status | ||||
---|---|---|---|---|
|
...
보안 설정 복제 기준
...
files/file/sync/
Status | ||||
---|---|---|---|---|
|
...
0.9.1
...
archive
...
enable
...
false
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
고아 파일 보관 여부
...
files/file/archive/
Status | ||||
---|---|---|---|---|
|
...
period
...
0
...
32비트 정수
...
보관 기간(day)
...
Status | ||||
---|---|---|---|---|
|
...
고아 파일 보관 기간
0으로 설정 시 무기한
...
files/file/archive/
Status | ||||
---|---|---|---|---|
|
...
location
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
고아 파일 보관 위치
...
files/file/archive/
Status | ||
---|---|---|
|
...
buffer
...
size
...
10
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
BAB 크기
0으로 설정 시 메모리 버퍼 미사용
...
buffer/
Status | ||||
---|---|---|---|---|
|
...
1.0-A3
...
file_buffer
...
limit
...
1024M
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
파일 버퍼 최대 크기
0으로 설정 시 파일 버퍼 미사용
...
file_buffer/
Status | ||||
---|---|---|---|---|
|
...
warn
...
10M
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
사용량 경고 임계치
0으로 설정 시 경고 비활성화
...
file_buffer/
Status | ||||
---|---|---|---|---|
|
...
0.9.1
...
location
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
파일 버퍼 위치
...
file_buffer/
Status | ||
---|---|---|
|
...
auto_up
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
자동 Up
...
Status | ||||
---|---|---|---|---|
|
...
0.9.4
...
auto_file_lock
...
off, on, read_only
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
자동 파일 잠금 유형
...
Status | ||||
---|---|---|---|---|
|
...
0.9
특이사항
hostname
속성을 지정하지 않으면 기존과 같이name
속성이 노드명과 호스트명의 역할을 동시에 수행합니다.
connections
노드 간 연결에 대한 정의. node1과 node2의 연결에 대한 정의를 기록하며, 연결 설정이 정의되지 않은 노드 간 연결은 기본 값을 사용합니다.
(XML: connections/connection)
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
node1
...
name
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
연결을 설정할 노드의 호스트명
...
node1/
Status | ||||
---|---|---|---|---|
|
...
url
...
IPv4 / IPv6
...
{ip}:{port}
...
Status | ||||
---|---|---|---|---|
|
...
복제 연결 주소
...
node1/
Status | ||||
---|---|---|---|---|
|
...
node2
...
name
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
연결을 설정할 노드의 호스트명
...
node2/
Status | ||||
---|---|---|---|---|
|
...
url
...
IPv4 / IPv6
...
{ip}:{port}
...
Status | ||||
---|---|---|---|---|
|
...
복제 연결 주소
...
node2/
Status | ||||
---|---|---|---|---|
|
...
buffer
...
size
...
10
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
BAB 크기
0으로 설정 시 메모리 버퍼 미사용
...
buffer/
Status | ||||
---|---|---|---|---|
|
...
file_buffer
...
limit
...
1024
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
파일 버퍼 최대 크기
0으로 설정 시 파일 버퍼 미사용
...
file_buffer/
Status | ||||
---|---|---|---|---|
|
...
warn
...
10M
...
32비트 정수
...
MB
...
Status | ||||
---|---|---|---|---|
|
...
사용량 경고 임계치
0으로 설정 시 경고 비활성화
...
file_buffer/
Status | ||||
---|---|---|---|---|
|
...
0.9.1
...
network
...
ping_interval
...
10
...
32비트 정수
...
초
...
Status | ||||
---|---|---|---|---|
|
...
PING 전송 간격
0으로 설정 시 비활성화
...
network/
Status | ||||
---|---|---|---|---|
|
...
compress
...
false
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
프로토콜 압축 여부
...
network/
Status | ||||
---|---|---|---|---|
|
...
tls
...
false
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
암호화 통신 여부
...
network/
Status | ||||
---|---|---|---|---|
|
...
limit
...
0
...
32비트 정수
...
bps
...
Status | ||||
---|---|---|---|---|
|
...
초당 전송량 제한 (bits per seconds)
0으로 설정 시 제한 없음
...
network/
Status | ||||
---|---|---|---|---|
|
options
리소스 전역 복제 / 동기화 설정.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
recursive
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
하위 디렉토리 포함 여부
...
Status | ||||
---|---|---|---|---|
|
...
exclude_patterns (list)
...
제외 패턴
...
Status | ||||
---|---|---|---|---|
|
...
제외 패턴
...
exclude_patterns/patterns/
Status | ||
---|---|---|
|
...
auto_file_lock
...
read_only
...
off, on, read_only
...
문자열
...
Status | ||||
---|---|---|---|---|
|
...
파일 잠금 유형
...
Status | ||||
---|---|---|---|---|
|
...
0.9
...
database_path
...
디렉토리 경로
...
Status | ||||
---|---|---|---|---|
|
...
리소스 상태를 저장하기 위한 경로
...
database_path/
Status | ||
---|---|---|
|
...
sync
...
attributes
...
true
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
속성 동기화 여부
...
sync/
Status | ||||
---|---|---|---|---|
|
...
0.9.1
...
permissions
...
name
...
name / sid / none
...
문자열 플래그
...
Status | ||||
---|---|---|---|---|
|
...
보안 설정 복제 기준
...
sync/
Status | ||||
---|---|---|---|---|
|
network
리소스 전역 네트워크 설정.
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
ping_interval
...
10
...
32비트 정수
...
초
...
Status | ||||
---|---|---|---|---|
|
...
PING 전송 간격
0으로 설정 시 비활성화
...
Status | ||||
---|---|---|---|---|
|
...
compress
...
false
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
프로토콜 압축 여부
...
Status | ||||
---|---|---|---|---|
|
...
tls
...
false
...
true / false
...
Boolean
...
Status | ||||
---|---|---|---|---|
|
...
암호화 통신 여부
...
Status | ||||
---|---|---|---|---|
|
...
limit
...
0
...
32비트 정수
...
bps
...
Status | ||||
---|---|---|---|---|
|
...
초당 전송량 제한 (bits per seconds)
0으로 설정 시 제한 없음
...
Status | ||||
---|---|---|---|---|
|
handlers
리소스 상황에 따라 실행 할 스크립트
...
항목
...
기본 값
...
설정 범위
...
단위
...
동적 적용
...
설명
...
XML
...
비고
...
options
...
timeout
...
0
...
32비트 정수
...
초
...
Status | ||||
---|---|---|---|---|
|
...
핸들러 실행 시간 제한
0으로 설정 시 제한 없음
...
options/
Status | ||||
---|---|---|---|---|
|
...
timeout_action
...
kill
...
kill / continue
...
문자열 플래그
...
Status | ||||
---|---|---|---|---|
|
...
실행 시간 이후의 동작
...
options/
Status | ||||
---|---|---|---|---|
|
...
after_resync_target
...
문자열
...
스크립트
...
Status | ||||
---|---|---|---|---|
|
...
동기화 후 타겟에서 실행 할 스크립트
...
scripts/after_resync_target/
Status | ||
---|---|---|
|
...
before_resync_target
...
문자열
...
스크립트
...
Status | ||||
---|---|---|---|---|
|
...
동기화 전 타겟에서 실행 할 스크립트
...
scripts/before_resync_target/
Status | ||
---|---|---|
|
...
before_resync_source
...
문자열
...
스크립트
...
Status | ||||
---|---|---|---|---|
|
...
동기화 전 소스에서 실행 할 스크립트
...
scripts/before_resync_source/
Status | ||
---|---|---|
|
...
out_of_sync
...
문자열
...
스크립트
...
Status | ||||
---|---|---|---|---|
|
...
동기화 또는 정합성 검증에서 OOS 발생 시 실행 할 스크립트
...
scripts/out_of_sync/
Status | ||
---|---|---|
|
...
local_io_error
...
문자열
...
스크립트
...
Status | ||||
---|---|---|---|---|
|
...
IO 오류 발생 시 실행 할 스크립트
...
scripts/local_io_error/
Status | ||
---|---|---|
|
userdata
사용자 속성. 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
...
|