Last updated
Last updated
본 문서는 노드 설정시 변경할 수 있는 항목에 대해 설명합니다. Klaytn 노드 패키지는 기본값을 제공하며 별도의 환경설정은 거의 필요하지 않습니다. 실행 중인 노드의 설정을 변경했다면 해당 노드를 재시작해야 변경 사항이 반영됩니다.
서비스체인 컨센서스 노드 환경설정을 위한 kscnd.conf
이 환경설정 파일은 conf
디렉토리에 있습니다. 해당 디렉토리의 위치는 아카이브 배포 (tar.gz
)인지 또는 패키지 배포 (RPM)인지에 따라 기본 설정이 다릅니다.
아카이브 배포의 경우 환경설정 디렉토리의 위치가 $INSTALL_PATH/kscn-linux-amd64/conf/
으로 기본 설정되어 있습니다.
패키지 배포의 경우 환경설정 디렉토리의 위치가 /etc/kscnd/conf/
으로 기본 설정되어 있습니다.
다음은 SCN의 설정 파일 샘플로 블록체인 데이터를 기본 설정 위치에 저장하게 되어 있습니다. 이때 기본으로 설정된 블록체인 데이터 저장 위치는 아카이브 배포의 경우 ~/kscnd_home
, 패키지 배포의 경우 /var/kscnd/data
입니다.
SCN에 권장되는 txpool 크기는 다음과 같습니다.
다음은 설정 파일에서 설정할 수 있는 속성입니다. SCN, SPN, SEN 설정 파일의 속성은 동일합니다.
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
로그 폴더 경로