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입니다.
SCN에 권장되는 txpool 크기는 다음과 같습니다.
속성
다음은 설정 파일에서 설정할 수 있는 속성입니다. 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 | 로그 폴더 경로 |
Last updated