Configuration Files

본 문서는 노드 설정시 변경할 수 있는 항목에 대해 설명합니다. Klaytn 노드 패키지는 기본값을 제공하며 별도의 환경설정은 거의 필요하지 않습니다. 실행 중인 노드의 설정을 변경했다면 해당 노드를 재시작해야 변경 사항이 반영됩니다.

SCN 환경설정 파일 위치

• 서비스체인 컨센서스 노드 환경설정을 위한 kscnd.conf

이 환경설정 파일은 conf 디렉토리에 있습니다. 해당 디렉토리의 위치는 아카이브 배포 (tar.gz)인지 또는 패키지 배포 (RPM)인지에 따라 기본 설정이 다릅니다.

• 아카이브 배포의 경우 환경설정 디렉토리의 위치가 $INSTALL_PATH/kscn-linux-amd64/conf/으로 기본 설정되어 있습니다.

• 패키지 배포의 경우 환경설정 디렉토리의 위치가 /etc/kscnd/conf/으로 기본 설정되어 있습니다.

환경설정 파일 형식

다음은 SCN의 설정 파일 샘플로 블록체인 데이터를 기본 설정 위치에 저장하게 되어 있습니다. 이때 기본으로 설정된 블록체인 데이터 저장 위치는 아카이브 배포의 경우 ~/kscnd_home, 패키지 배포의 경우 /var/kscnd/data입니다.

# Configuration file for the kcnd

NETWORK=
# if you specify NETWORK_ID, a private network is created.
NETWORK_ID=
PORT=32323
SERVER_TYPE="fasthttp"
SYNCMODE="full"
VERBOSITY=3
MAXCONNECTIONS=100
# LDBCACHESIZE=10240
REWARDBASE="0x0"

...

DATA_DIR=
LOG_DIR=$DATA_DIR/logs

SCN에 권장되는 txpool 크기는 다음과 같습니다.

TXPOOL_EXEC_SLOTS_ALL=16384
TXPOOL_NONEXEC_SLOTS_ALL=16384
TXPOOL_EXEC_SLOTS_ACCOUNT=16384
TXPOOL_NONEXEC_SLOTS_ACCOUNT=16384

속성

다음은 설정 파일에서 설정할 수 있는 속성입니다. SCN, SPN, SEN 설정 파일의 속성은 동일합니다.

Name	Description
NETWORK	노드가 참여할 네트워크의 이름입니다. NETWORK_ID가 정의되지 않은 경우에 사용합니다. ("cypress", "baobab")
NETWORK_ID	Klaytn 네트워크 ID입니다. 로컬 프라이빗 네트워크를 만드는 경우, 프라이빗 네트워크의 ID를 정의합니다. 다음은 사전에 구성된 네트워크에 미리 지정된 ID들입니다. 8217 : Cypress (메인넷) 1000 : 테스트넷 1001 : Baobab 테스트넷
PORT	P2P 포트 (Default: "32323")
SERVER_TYPE	JSON RPC 서버 유형 ("http", "fasthttp")
SYNCMODE	블록체인 동기화 모드 ("fast", "full")
VERBOSITY	로그 상세 레벨. (0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail)
MAXCONNECTIONS	최대로 가능한 물리적 연결 수 단일 채널 피어는 MAXCONNECTIONS 만큼의 피어와 연결할 수 있습니다. 다중 채널 피어는 MAXCONNECTIONS/2 만큼의 피어와 연결할 수 있습니다. 0으로 설정하면 네트워크 연결이 비활성화됩니다. (Default: 10)
LDBCACHESIZE	LevelDB의 메모리 내 캐시 크기 (MiB). (Default : 768)
REWARDBASE	블록 합의 보상을 받을 계정 주소. 이 속성은 CN에만 적용됩니다.
TXPOOL_EXEC_SLOTS_ALL	모든 계정에 대해 실행 가능한 트랜잭션 슬롯의 최대 개수 (Default: 4096)
TXPOOL_NONEXEC_SLOTS_ALL	모든 계정에 대해 실행 불가능한 트랜잭션 슬롯의 최대 개수 (Default: 1024)
TXPOOL_EXEC_SLOTS_ACCOUNT	계정당 보장된 실행 가능한 트랜잭션 슬롯의 개수 (Default: 16)
TXPOOL_NONEXEC_SLOTS_ACCOUNT	계정당 보장된 실행 가능한 트랜잭션 슬롯의 최대 개수 (Default: 64)
TXPOOL_LIFE_TIME	실행 불가능한 트랜잭션이 대기하는 최대 시간 (기본값 : SEN은 30m, SCN/SPN은 5m)
RPC_ENABLE	1로 설정하면 HTTP-RPC 서버를 활성화합니다.
RPC_API	쉼표로 구분된 API 목록으로 HTTP-RPC 인터페이스를 통해 제공됩니다. (admin, debug, klay, miner, net, personal, rpc, txpool, web3)
RPC_PORT	HTTP-RPC 서버 수신 포트 (Default: "8551")
RPC_ADDR	HTTP-RPC 서버 수신 인터페이스 (Default: "localhost")
RPC_CORSDOMAIN	쉼표로 구분된, (브라우저에서 시행된) cross-origin 요청을 수락할 도메인 목록입니다.
RPC_VHOSTS	쉼표로 구분된, (서버에서 시행된) 요청을 수락할 가상 호스트 이름의 목록입니다. '*' 와일드 카드를 허용합니다. (Default: {"localhost"})
WS_ENABLE	1로 설정하면 WS-RPC 서버를 활성화합니다.
WS_API	WS-RPC 인터페이스를 통해 제공되는 API (admin, debug, klay, miner, net, personal, rpc, txpool, web3)
WS_ADDR	WS-RPC 서버 수신 인터페이스
WS_PORT	WS-RPC 서버 수신 포트 (Default : "8552")
WS_ORIGINS	웹 소켓 요청을 수락할 Origin (Default: "localhost")
SC_MAIN_BRIDGE	1로 설정하면 Main bridge 서비스를 활성화합니다. 서비스체인 환경설정에 사용됩니다.
SC_MAIN_BRIDGE_PORT	Main bridge 수신 포트 (Default : "50505")
SC_MAIN_BRIDGE_INDEXING	1로 설정하면 하위 체인 데이터에 빠르게 접근할 수 있도록 하위 체인 트랜잭션의 해시를 저장합니다.
METRICS	1로 설정하면 지표 수집 및 보고를 할 수 있습니다.
PROMETHEUS	1로 설정하면 Prometheus Exporter를 활성화합니다.
DB_NO_PARALLEL_WRITE	1로 설정하면 퍼시스턴트 데이터베이스에 블록 데이터의 병렬 쓰기가 비활성화됩니다.
MULTICHANNEL	1로 설정하면 블록 전파를 위한 전용 채널이 생성됩니다.
SUBPORT	MULTICHANNEL 옵션이 활성화되었을 때 보조 수신 포트 번호입니다. (Default : "32324")
NO_DISCOVER	1로 설정되면 discovery 옵션을 비활성화합니다.
BOOTNODES	쉼표로 구분된, 부트스트랩 노드의 KNI 주소
ADDITIONAL	추가적인 command-line 옵션 (예: --txpool.nolocals)이 있는 경우 사용합니다.
DATA_DIR	Klaytn 블록체인 데이터 폴더 경로
LOG_DIR	로그 폴더 경로