컨센서스 노드 설치
다운로드
다운로드](../../downloads/downloads.md) 페이지에서 최신 버전의 kcn
을 다운로드할 수 있습니다.
설치
Linux 아카이브 배포
아카이브 파일은 실행 가능한 바이너리와 다음과 같은 구조의 구성 파일로 구성됩니다.
참고: 파일 구조나 파일 이름을 변경하지 마세요. 변경하면 노드가 제대로 작동하지 않을 수 있습니다.
- bin |- kcn |- kcnd- conf |- kcnd.conf
파일명 | 파일 설명 |
---|---|
bin/kcn | CN 실행 파일 |
bin/kcnd | CN 시작/종료 스크립트 파일 |
conf/kcnd.conf | CN 구성 파일 |
설치는 다운로드한 패키지의 압축을 풀고 패키지를 설치하려는 위치에 설치하는 것입니다.
$ tar zxf kcn-vX.X.X-linux-amd64.tar.gz
또는,
$ tar zxf kcn-baobab-vX.X.X-linux-amd64.tar.gz
참고: 압축되지 않은 디렉터리 kcn-linux-amd64/bin
경로를 환경 변수 $PATH
에 추가하여 kcn
및 kcnd
를 전역적으로 실행할 것을 권장합니다. 예를 들어
$ export PATH=$PATH:~/downloaded/path/kcn-linux-amd64/bin
다른 섹션에서는 경로가 변수에 추가되었다고 가정합니다.
RPM 배포 (RHEL/CentOS/Fedora)
다운로드한 RPM 파일을 다음 yum
명령으로 설치할 수 있습니다.
$ yum install kcnd-vX.X.X.el7.x86_64.rpm
또는,
$ yum install kcnd-baobab-vX.X.X.el7.x86_64.rpm
카이아 Yum 리포지토리에서 설치
또는 카이아 Yum 저장소에서 kcnd
를 설치하여 실행할 수 있습니다:
$ sudo curl -o /etc/yum.repos.d/kaia.repo https://packages.kaia.io/config/rhel/7/kaia.repo && sudo yum install kcnd
설치된 위치
설치된 파일은 다음과 같은 위치에 있습니다.
파 일명 | 위치 |
---|---|
kcn | /usr/bin/kcn |
kcnd.conf | /etc/kcnd/conf/kcnd.conf |
구성
CN 설정은 데이터 디렉터리를 생성하고 설정 파일 kcnd.conf
에서 몇 가지 값을 설정하는 것입니다.
- CN 데이터 디렉터리를 만듭니다.
- 노드 키 설치
kcnd.conf
로 CN을 설정합니다.
CN 데이터 디렉터리 생성
카이아 블록체인 데이터의 크기가 항상 증가한다는 사실을 고려하면 충분히 큰 스토리지를 사용하는 것을 권장합니다. 원하는 경로에 디렉터리를 생성해야 할 수도 있습니다.
$ mkdir -p /var/kcnd/data
노드 키 설치
CN을 작동하려면 nodekey
가 필요합니다. 노드키가 없는 경우 KCN 바이너리가 새로 생성합니다. 노드키가 있는 경우 CN 데이터 디렉터리에 노드키를 넣어야 합니다. 노드키를 생성하는 방법은 '설치에 앞서' 섹션에 설명되어 있습니다. 다음 명령줄은 CN 데이터 디렉터리에 nodekey
를 복사합니다.
$ cp nodekey /var/kcnd/data
구성 파일 업데이트
구성 파일 위치:
- 아카이브 배포의 경우, 설정 디렉터리 위치는 기본적으로
$INSTALL_PATH/kcn-linux-amd64/conf/
입니다. - 패키지 배포의 경우, 설정 디렉터리의 기본 위치는
/etc/kcnd/conf/
입니다.
데이터 디렉터리 추가
구성 파일 kcnd.conf
에서 데이터 디렉터리 환경 변수 $DATA_DIR
을 업데이트해야 합니다.
...DATA_DIR=/var/kcnd/data...
리워드베이스 설정
CN 운영자는 카이아 네트워크 합의에 참여한 것에 대한 보상으로 KAIA를 받게 됩니다. 따라서 환경설정 파일 kcnd.conf
에 주소를 설정해야 합니다.
새 계정을 만드는 방법은 여러 가지가 있지만, kcn
을 통해서도 기능을 제공합니다. 다음 명령어로 도움말 메시지를 확인할 수 있습니다.
$ kcn account new --help
이 절차를 수행하는 예는 다음과 같습니다. 먼저 보상 KAIA를 받을 새 계정을 만들어야 합니다.
$ kcn account new --datadir ~/kcnd_homeINFO[03/15,09:04:43 +09] [17] Setting connection type nodetype=cn conntype=-0INFO[03/15,09:04:43 +09] [17] Maximum peer count KAIA=25 LES=0 total=25INFO[03/15,09:04:43 +09] [17] SBN is disabled.Your new account is locked with a password. Please give a password. Do not forget this password.Passphrase:Repeat passphrase:Address: {d13f7da0032b1204f77029dc1ecbf4dae2f04241}
그 결과 사용자가 정의한 경로에 관련 키 저장소가 생성됩니다. 다음으로 생성된 주소를 다음과 같이 kcnd.conf
파일에 넣어야 합니다.
...REWARDBASE="d13f7da0032b1204f77029dc1ecbf4dae2f04241"...
생성한 키스토어와 비밀번호는 매우 중요하므로 관리에 주의해야 합니다. 구성 파일 섹션에서 kcnd.conf
에 대한 자세한 내용을 참조하세요.
(Optional) Download Chaindata Snapshot
Synching from the genesis block is time-consuming. You may use Chaindata Snapshot to skip the Full Sync process.
CN 시작하기
CN 시작/중지
다음 systemctl
명령어로 카이아 서비스를 시작/중지할 수 있습니다.
참고: 루트 권한이 필요합니다.
시작
$ systemctl start kcnd.service
중지
$ systemctl stop kcnd.service
상태
$ systemctl status kcnd.service