rippled 서버가 시작되지 않음

이 페이지에서는 rippled 서버가 시작되지 않는 가능한 이유와 해결 방법에 대해 설명합니다.

이 지침은 지원되는 플랫폼에 rippled를 설치했다고 가정합니다.

파일 설명자 제한

일부 Linux 버전에서는 rippled를 실행하려고 할 때 다음과 같은 오류 메시지가 표시될 수 있습니다:

WARNING: There are only 1024 file descriptors (soft limit) available, which
limit the number of simultaneous connections.

이는 시스템에 단일 프로세스가 열 수 있는 파일 수에 대한 보안 제한이 있지만 rippled에 대해 이 제한이 너무 낮게 설정되어 있기 때문에 발생합니다. 이 문제를 해결하려면 루트 액세스 권한이 필요합니다. 다음 단계에 따라 rippled하여 열 수 있는 파일 수를 늘릴 수 있습니다:

1. etc/security/limits.conf 파일의 끝에 다음 줄을 추가합니다:

*                soft    nofile          65536
*                hard    nofile          65536

2. 열 수 있는 파일 수에 대한 하드 제한이 이제 65536개인지 확인합니다:

ulimit -Hn

명령은 65536을 출력해야 합니다.

3. rippled를 다시 시작해보세요.

systemctl start rippled

4. 그래도 rippled가 시작되지 않으면 /etc/sysctl.conf를 열고 다음 커널 수준 설정을 추가하세요:

fs.file-max = 65536

etc/opt/ripple/rippled.cfg를 열지 못했을 경우

시작 시 다음과 같은 오류와 함께 rippled가 충돌하는 경우, rippled는는 구성 파일을 읽을 수 없다는 뜻입니다:

Loading: "/etc/opt/ripple/rippled.cfg"
Failed to open '"/etc/opt/ripple/rippled.cfg"'.
Terminating thread rippled: main: unhandled St13runtime_error 'Can not create "/var/opt/ripple"'
Aborted (core dumped)

가능한 해결 방법:

• 구성 파일이 존재하고(기본 위치는 /etc/opt/ripple/rippled.cfg) rippled 프로세스를 실행하는 사용자(일반적으로 rippled)에게 해당 파일에 대한 읽기 권한이 있는지 확인합니다.

• HOME/.config/ripple/rippled.cfg에서 rippled된 사용자가 읽을 수 있는 구성 파일을 만듭니다(여기서 $HOME은 rippled된 사용자의 홈 디렉터리를 가리킴).

Tip:

rippled 저장소에는 RPM 설치 시 기본 구성으로 제공되는 예제 rippled.cfg 파일이 포함되어 있습니다. 파일이 없는 경우 여기에서 복사할 수 있습니다.

• --conf 커맨드라인 옵션을 사용하여 원하는 구성 파일의 경로를 지정합니다.

유효성 검증인 파일을 열지 못함

시작 시 다음과 같은 오류와 함께 rippled이 충돌하는 경우 기본 구성 파일을 읽을 수 있지만 해당 구성 파일에 별도의 유효성 검증인 구성 파일(일반적으로 validators.txt라는 이름)이 지정되어 있어 rippled가 읽을 수 없다는 의미입니다.

Loading: "/home/rippled/.config/ripple/rippled.cfg"
Terminating thread rippled: main: unhandled St13runtime_error 'The file specified in [validators_file] does not exist: /home/rippled/.config/ripple/validators.txt'
Aborted (core dumped)

가능한 해결 방법:

• [validators.txt] 파일이 존재하고 rippled 사용자에게 해당 파일을 읽을 수 있는 권한이 있는지 확인합니다.

Tip:

rippled 저장소에는 RPM 설치 시 기본 구성으로 제공되는 예제 validators.txt 파일이 포함되어 있습니다. 파일이 없는 경우 여기에서 복사할 수 있습니다.

• rippled.cfg 파일을 편집하고 유효성 검증인 파일(또는 이와 동등한 파일)의 올바른 경로를 갖도록 [validators_file] 설정을 수정합니다. 파일 이름 앞뒤에 여분의 공백이 있는지 확인하세요.

• rippled.cfg 파일을 편집하고 [validators_file] 설정을 제거합니다. 유효성 검증인 설정을 rippled.cfg 파일에 직접 추가합니다. 예를 들어:

[validator_list_sites]
https://vl.ripple.com

[validator_list_keys]
ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734

데이터베이스 경로를 만들 수 없음

rippled 시작 시 다음과 같은 오류와 함께 rippled가 충돌하는 경우 서버에 구성 파일에서 [database_path]에 대한 쓰기 권한이 없다는 의미입니다.

Loading: "/home/rippled/.config/ripple/rippled.cfg"
Terminating thread rippled: main: unhandled St13runtime_error 'Can not create "/var/lib/rippled/db"'
Aborted (core dumped)

구성 파일(/home/rippled/.config/ripple/rippled.cfg)과 데이터베이스 경로(/var/lib/rippled/db)의 경로는 시스템에 따라 다를 수 있습니다.

가능한 해결 방법:

• 오류 메시지에 표시된 데이터베이스 경로에 대한 쓰기 권한이 있는 다른 사용자로 rippled를 실행합니다.

• rippled.cfg 파일을 편집하고 [database_path] 설정을 변경하여 rippled된 사용자에게 쓰기 권한이 있는 경로를 사용하도록 합니다.

• rippled된 사용자에게 구성된 데이터베이스 경로에 대한 쓰기 권한을 부여합니다.

상태 DB 오류

rippled된 서버의 상태 데이터베이스가 손상된 경우 다음과 같은 오류가 발생할 수 있습니다. 예기치 않게 종료된 경우 또는 구성 파일에서 경로 및 [database_path] 설정을 변경하지 않고 데이터베이스 유형을 RocksDB에서 NuDB로 변경한 경우 발생할 수 있습니다.

2018-Aug-21 23:06:38.675117810 SHAMapStore:ERR state db error:
  writableDbExists false archiveDbExists false
  writableDb '/var/lib/rippled/db/rocksdb/rippledb.11a9' archiveDb '/var/lib/rippled/db/rocksdb/rippledb.2d73'

To resume operation, make backups of and remove the files matching /var/lib/rippled/db/state* and contents of the directory /var/lib/rippled/db/rocksdb

Terminating thread rippled: main: unhandled St13runtime_error 'state db error'

이 문제를 해결하는 가장 쉬운 방법은 데이터베이스를 완전히 삭제하는 것입니다. 대신 다른 곳에 백업하는 것이 좋습니다. 예를 들어:

mv /var/lib/rippled/db /var/lib/rippled/db-bak

또는 데이터베이스가 필요하지 않다고 확신하는 경우:

rm -r /var/lib/rippled/db

Tip:

개별 서버는 XRP Ledger 네트워크의 다른 서버에서 ledger 기록을 다시 다운로드할 수 있기 때문에 일반적으로 rippled 데이터베이스는 삭제하는 것이 안전합니다.

또는 구성 파일에서 데이터베이스 경로를 변경할 수도 있습니다. 예를 들어:

[node_db]
type=NuDB
path=/var/lib/rippled/custom_nudb_path

[database_path]
/var/lib/rippled/custom_sqlite_db_path

온라인 삭제가 ledger 내역보다 적음

다음과 같은 오류 메시지는 rippled.cfg 파일에 [ledger_history] 및 online_delete에 대해 모순되는 값이 있음을 나타냅니다.

Terminating thread rippled: main: unhandled St13runtime_error 'online_delete must not be less than ledger_history (currently 3000)

[ledger_history] 설정은 서버가 다시 채우려고 하는 기록 ledger의 수를 나타냅니다. online_delete 필드([node_db] 구절에 있음)는 이전 기록을 삭제할 때 보관할 기록 ledger의 수를 나타냅니다. online_delete 값은 서버가 다운로드하려고 하는 기록 ledger를 삭제하지 않도록 [ledger_history]보다 크거나 같아야 합니다.

이 문제를 해결하려면 rippled.cfg 파일을 편집하여 [ledger_history] 또는 online_delete 옵션을 변경하거나 제거하세요. ([ledger_history]를 생략하면 기본값인 256개의 ledger 버전이 사용됩니다. online_delete 필드를 지정하는 경우 256보다 커야 합니다. online_delete 필드를 생략하면 이전 ledger 버전의 자동 삭제가 비활성화됩니다).

잘못된 node_size 값

다음과 같은 오류는 rippled.cfg 파일에 node_size 설정 값이 잘못되었음을 나타냅니다:

Terminating thread rippled: main: unhandled N5beast14BadLexicalCastE 'std::bad_cast'

node_size 필드에 유효한 매개변수는 작은, 작은, 중간, 큰 또는 큰입니다. 자세한 내용은 노드 크기를 참조하세요.

샤드 경로 누락

다음과 같은 오류는 rippled.cfg에 불완전한 히스토리 샤딩 구성이 있음을 나타냅니다:

Terminating thread rippled: main: unhandled St13runtime_error 'shard path missing'

구성에 [shard_db] 구절이 포함된 경우, rippled가 샤드 저장소에 대한 데이터를 쓸 수 있는 디렉터리를 가리키는 경로 필드가 포함되어야 합니다. 이 오류는 경로 필드가 누락되었거나 잘못된 위치에 있다는 것을 의미합니다. 구성 파일에 여분의 공백이나 오타가 있는지 확인하고 샤드 구성 예제와 비교하세요.

지원되지 않는 샤드 저장소 유형: RocksDB

RocksDB는 더 이상 기록 샤딩을 위한 백엔드로 지원되지 않습니다. RocksDB 샤드 저장소를 정의하는 기존 구성이 있는 경우 서버가 시작되지 않습니다.

이 경우 로그 시작 명령 직후 프로세스가 종료되고 출력 로그의 앞부분에 다음과 같은 메시지가 표시됩니다:

ShardStore:ERR Unsupported shard store type: RocksDB

이 문제를 해결하려면 다음 중 하나를 수행한 다음 서버를 다시 시작합니다:

• 대신 NuDB를 사용하도록 샤드 저장소를 변경합니다.

• 기록 샤딩을 비활성화합니다.