구성 파일
이 문서는 노드의 구성 가능한 속성에 대해 설명합니다. 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 kcndNETWORK=# if you specify NETWORK_ID, a private network is created.NETWORK_ID=PORT=32323SERVER_TYPE="fasthttp"SYNCMODE="full"VERBOSITY=3MAXCONNECTIONS=100# LDBCACHESIZE=10240REWARDBASE="0x0"...DATA_DIR=LOG_DIR=$DATA_DIR/logs
SCN에 권장되는 txpool 크기는 다음과 같습니다.
TXPOOL_EXEC_SLOTS_ALL=16384TXPOOL_NONEXEC_SLOTS_ALL=16384TXPOOL_EXEC_SLOTS_ACCOUNT=16384TXPOOL_NONEXEC_SLOTS_ACCOUNT=16384
속성
구성 파일에는 다음과 같은 구성 가능한 속성이 있습니다. SCN, SPN 및 SEN 구성 파일은 동일한 속성을 가집니다.
| 이름 | 설명 |
|---|---|
| NETWORK | 이 노드가 가입할 네트워크 이름입니다. 이 값은 NETWORK_ID가 정의되지 않은 경우에 사용됩니다. ("Cypress", "Baobab") |
| NETWORK_ID | Klaytn 네트워크 ID. 로컬 사설 네트워크를 생성하는 경우 네트워크 ID를 직접 정의해야 합니다. 다음 ID는 미리 구성된 네트워크를 위해 예약되어 있습니다. 8217 : Cypress(메인 네트워크) 1000 : Aspen 테스트 네트워크 1001 : Baobab 테스트 네트워크 |
| PORT | P2P 포트. (기본값: "32323") |
| SERVER_TYPE | JSON RPC 서버 유형. ("http", "fastttp") |
| SYNCMODE | 블록체인 동기화 모드. ("fast", "full") |
| VERBOSITY | 로그 세부정보 (0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail) |
| MAXCONNECTIONS | 최대 물리적 연결 수입니다. 비실행 트랜잭션이 대기할 수 있는 최대 시간입니다. 모든 단일 채널 피어는 MAXCONNECTIONS만큼의 피어를 가질 수 있고, 모든 멀티 채널 피어에는 MAXCONNECTIONS/2만큼의 피어를 가질 수 있습니다. 0으로 설정하면 네트워크 연결이 비활성화됩니다. (기본값: 10) |
| LDBCACHESIZE | LevelDB의 인메모리 캐시 크기(MiB). (기본값: 768) |
| REWARDBASE | 블록 합의 보상을 받을 계정 주소. 이 속성은 CN에만 적용됩니다. |
| TXPOOL_EXEC_SLOTS_ALL | 모든 계정에 대한 최대 실행 트랜잭션 슬롯 수입니다. (기본값: 4096) |
| TXPOOL_NONEXEC_SLOTS_ALL | 모든 계정에 대한 비실행 트랜잭션 슬롯의 최대 개수입니다. (기본값: 1024) |
| TXPOOL_EXEC_SLOTS_ACCOUNT | 계정당 보장되는 실행 가능한 트랜잭션 슬롯 수입니다. (기본값: 16) |
| TXPOOL_NONEXEC_SLOTS_ACCOUNT | 계정당 보장되는 비실행 트랜잭션 슬롯의 최대 개수입니다. (기본값: 64) |
| TXPOOL_LIFE_TIME | 비실행 트랜잭션이 대기할 수 있는 최대 시간입니다. (기본값: SEN의 경우 30m, SCN/SPN의 경우 5m) |
| RPC_ENABLE | 1로 설정된 경우 HTTP-RPC 서버를 활성화합니다. |
| RPC_API | 쉼표로 구분된 HTTP-RPC 인터페이스를 통해 제공되는 API 목록입니다. (admin, debug, klay, miner, net, personal, rpc, txpool, web3) |
| RPC_PORT | HTTP-RPC 서버 수신 포트. (기본값: "8551") |
| RPC_ADDR | HTTP-RPC 서버 수신 인터페이스. (기본값: "localhost") |
| RPC_CORSDOMAIN | 쉼표로 구분된 크로스오리진 요청을 수락할 도메인 목록(브라우저 강제 적용) |
| RPC_VHOSTS | 쉼표로 구분된 요청을 수락할 가상 호스트 이름 목록(서버 적용). '*' 와일드카드를 허용합니다. (기본값: 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 서버 수신 포트. (기본값: "8552") |
| WS_ORIGINS | 웹 소켓 요청을 수락할 원본. (기본값: "localhost") |
| SC_MAIN_BRIDGE | 1로 설정된 경우 메인 브리지 서비스를 활성화합니다. 서비스 체인 구성에 사용됩니다. |
| SC_MAIN_BRIDGE_PORT | 메인 브리지가 이 포트에서 수신 대기합니다. (기본값: "50505") |
| SC_MAIN_BRIDGE_INDEXING | 1로 설정하면 차일드 체인 데이터에 빠르게 액세스할 수 있도록 차일드 체인 트랜잭션의 트랜잭션 해시 저장을 활성화합니다. |
| METRICS | 1로 설정하면 메트릭 수집 및 보고를 활성화합니다. |
| PROMETHEUS | 1로 설정하면 Prometheus 익스포터를 활성화합니다. |
| DB_NO_PARALLEL_WRITE | 1로 설정된 경우 영구 데이터베이스에 대한 블록 데이터의 병렬 쓰기를 비활성화합니다. |
| MULTICHANNEL | 1로 설정된 경우 블록 전파를 위한 전용 채널을 생성합니다. |
| SUBPORT | 멀티채널 옵션이 활성화된 경우 수신 서브 포트 번호입니다. (기본값: "32324") |
| NO_DISCOVER | 검색 옵션이 1로 설정된 경우 검색 옵션을 끕니다. |
| BOOTNODES | 부트스트랩 노드의 쉼표로 구분된 니 주소. |
| ADDITIONAL | 추가 명령줄 옵션 예) --txpool.nolocals |
| DATA_DIR | 클레이튼 블록체인 데이터 폴더 경로. |
| LOG_DIR | 로그 폴더 경로. |