最終更新:
編集

コマンドラインの使い方

rippledの実行可能ファイルは、通常はXRP Ledgerを処理するデーモンとして実行されますが、他のモードでも実行できます。このページでは、コマンドラインから実行する場合にrippledに渡すことができるすべてのオプションを説明します。

使用できるモード

  • デーモンモード - デフォルトです。XRP Ledgerに接続して、トランザクションを処理し、レジャーデータベースを構築します。
  • スタンドアロンモード - -aまたは--standaloneオプションを使用します。他のサーバには接続できない以外は、デーモンモードと同様です。このモードは、トランザクション処理やその他の機能のテストに使用できます。
  • クライアントモード - APIメソッドの名前を指定して、別のrippledサーバにJSON-RPCクライアントとして接続し、その後終了します。実行可能ファイルがすでに別のプロセスで実行中である場合に、このモードを使用してサーバのステータスとレジャーデータを確認できます。
  • その他の使用法 - 以下の各コマンドを実行すると、rippled実行可能ファイルが何らかの情報を出力し、その後終了します。
    • ヘルプ - 使用法の説明を出力するには、-hまたは--helpを使用します。
    • 単体テスト - 単体テストを実行し、結果の概要を出力するには、-uまたは--unittestを使用します。rippledが正しくコンパイルされていることを確認する場合に便利です。
    • バージョンステートメント - rippledのバージョン番号を出力し、その後終了するには、--versionを使用します。

汎用オプション

ほとんどのモードに適用されるオプションは、以下の通りです。

オプション説明
--conf {FILE}デフォルトのロケーションで構成ファイルを検索する代わりに、構成ファイルとして{FILE}を使用します。指定されていない場合、rippledは最初にローカル作業ディレクトリでrippled.cfgファイルがあるかどうかを調べます。Linuxでは、このファイルが見つからない場合rippledは次に$XDG_CONFIG_HOME/ripple/ripple.cfgを確認します。(一般的に$XDG_CONFIG_HOMEの場所は$HOME/.configです。)

詳細レベルのオプション

次の汎用オプションは、標準出力とログファイルに書き込まれる情報の量を制御します。

オプション短縮形説明
--debug廃止予定 トレースレベルのデバッグを有効にします(--verboseのエイリアス)。代わりにlog_levelメソッドを使用してください。
--silent起動中にログを標準出力と標準エラー出力に書き込みません。冗長なログを削減するためにrippledをsystemdユニットとして開始する場合に推奨されます。
--verbose-v廃止予定 トレースレベルデバッグを有効にします。代わりにlog_levelメソッドを使用してください。

デーモンモードのオプション

rippled [OPTIONS]

デーモンモードは、rippledのデフォルトの運用モードです。汎用オプションの他に、以下のいずれかのオプションを指定できます。

オプション説明
--fgデーモンをフォアグラウンドでシングルプロセスとして実行します。このオプションを指定しない場合、rippledは1番目のプロセスがモニターとして実行されている間に、デーモンの2番目のプロセスをフォークします。
--import完全に起動する前に、別のrippledサーバのレジャーストアーからレジャーデータをインポートしてください。構成ファイルに有効な[import_db]スタンザが指定されている必要があります。
--net廃止予定 デバッグのためのオプションです。ネットワークからレジャーを取得できるようになるまで、ローカルレジャーを作成しません。
--nodetoshard完全に起動する前に、すべての完全な履歴シャードをレジャーストアーからシャードストアーにコピーしてください(シャードストアーに設定されている最大ディスク容量まで)。CPUとI/Oを大量に使用します。注意: このコマンドは、データを(移動するのではなく)コピーするため、シャードストアーとレジャーストアーの両方にデータを保存するのに十分なディスク容量が必要です。
--quorum {QUORUM}これはテストネットワークのブートストラップ用のオプションです。検証のための最小定数をオーバーライドするには、{QUORUM}の信頼できるバリデータの同意を必要とします。デフォルトでは、検証のための定数は、信頼できるバリデータの実際の数に基づき、安全な数に自動的に設定されます。一部のバリデータがオンラインではない場合、このオプションにより、標準定数よりも少ない数のバリデータで続行できるようになります。警告: 定数を手動で設定すると、設定した値が小さすぎるためにサーバがネットワークの他の部分から分岐することを防ぐことができない可能性があります。このオプションは、コンセンサスを十分に理解し、標準以外の設定を使用する必要がある場合にのみ使用してください。

次のフィールドは廃止されました: --validateShards削除: rippled 1.7.0

スタンドアロンモードのオプション

rippled --standalone [OPTIONS]
rippled -a [OPTIONS]

スタンドアロンモードで実行します。このモードでは、rippledはネットワークに接続しないか、またはコンセンサスを実行しません。(それ以外の場合、rippledはデーモンモードで実行されます。)

初期レジャーオプション

以下のオプションにより、起動時に最初に読み込むレジャーが判断されます。これらはのオプションは、履歴レジャーのリプレイまたはテストネットワークのブートストラップのためのものです。

オプション説明
--ledger {LEDGER}{LEDGER}(レジャーハッシュまたはレジャーインデックス)により初期レジャーと識別されているレジャーバージョンを読み込みます。指定されたレジャーバージョンは、サーバのレジャーストアーに格納される必要があります。
--ledgerfile {FILE}指定された{FILE}からレジャーバージョンを読み込みます(このファイルには完全なレジャーがJSONフォーマットで格納されている必要があります)。このようなファイルの例については、付属のledger-file.jsonをご覧ください。
--load廃止予定 デバッグのためのオプションです。ディスク上のレジャーストアーから初期レジャーを読み込むだけです。
--replayデバッグのためのオプションです。--ledgerと組み合わせて使用し、レジャーの閉鎖をリプレイします。サーバのレジャーストアーには、当該レジャーとその直前のバージョンのレジャーがすでに格納されている必要があります。サーバでは、前のレジャーをベースとして使用して、指定されたレジャーのすべてのトランザクションが処理されます。その結果、指定されたレジャーが再作成されます。デバッガーを使用して、特定のトランザクションの処理ロジックを分析するためのブレークポイントを追加できます。
--startデバッグのためのオプションです。既知のすべてのAmendment(反対票を投じるようにサーバに設定されているAmendmentを除く)が適用されている新しいジェネシスレジャーを使用して開始します。したがってこれらのAmendmentの機能は、2週間のAmendmentプロセス期間ではなく、2番目のレジャーの開始時から使用可能になります。
--valid廃止予定 デバッグのためのオプションです。ネットワークとの完全同期の前であっても、初期レジャーを有効なネットワークレジャーと見なします。

クライアントモードのオプション

rippled [OPTIONS] -- {COMMAND} {COMMAND_PARAMETERS}

クライアントモードでは、rippled実行可能ファイルが別のrippledサービスのクライアントとして動作します。(サービスは別のプロセスでローカルに実行されている同じ実行可能ファイルである場合や、別のサーバ上のrippledサーバである場合があります。)

クライアントモードで実行するには、いずれかのrippled APIメソッドのコマンドライン構文を指定します。

クライアントモードは、個別のコマンド構文の他に、汎用オプションと以下のオプションに対応します。

オプション説明
--rpcサーバをクライアントモードで実行することを明示的に指定します。必須ではありません。
--rpc_ip {IP_ADDRESS}指定されたIPアドレスのrippledサーバに接続します。オプションでポート番号も指定します。
--rpc_port {PORT}廃止予定 指定されたポートでrippledサーバに接続します。代わりに、--rpc_ipを使用してIPアドレスとともにポートを指定します。

ヒント: 一部の引数では、マイナスの値を指定できます。APIコマンドの引数がオプションとして解釈されないようにするには、コマンド名の前に--引数を渡します。

使用例(使用可能な最も古いレジャーバージョンから最新のレジャーバージョンまでのアカウントトランザクション履歴を取得):

rippled -- account_tx r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 -1 -1

単体テスト

rippled --unittest [OPTIONS]
rippled -u [OPTIONS]

単体テストでは、rippledソースコードに組み込まれているテストを実行し、実行可能ファイルが予期されているとおりに動作することを確認します。単体テストの実行が完了すると、結果の概要が表示され、終了します。単体テストでは、組み込みのデータ型やトランザクション処理ルーチンなどの機能がカバーされます。

単体テストから失敗が報告される場合、一般的に次のいずれかの状況が発生しています。

  • rippledのコンパイル時に問題が発生し、意図したとおりに機能していない
  • rippledのソースコードにバグがある
  • 単体テストにバグがあるか、単体テストが新しい動作に対応して更新されていない

単体テストの実行時には、汎用オプションと以下のいずれかのオプションを指定できます。

オプション短縮形説明
--unittest-ipv6単体テストの実行時にIPv6を使用してローカルサーバに接続します。このオプションが指定されていない場合、単体テストではIPv4が代わりに使用されます。新規: rippled 1.1.0
--unittest-jobs {NUMBER_OF_JOBS}指定された数のプロセスを使用して単体テストを実行します。これにより、マルチコアシステムの単体テストをより短時間で終了できます。{NUMBER_OF_JOBS}には、使用するプロセスの数を示すプラスの整数値を指定します。
--unittest-log--quietが指定されている場合でも、単体テストにてログへの書き込みができるようにします。(それ以外の影響はありません。)
--quiet-q単体テストの実行時に出力される診断メッセージの数が減少します。

特定の単体テスト

rippled --unittest={TEST_OR_PACKAGE_NAME}

デフォルトでは、rippledは「手動」に分類されている単体テスト以外のすべての単体テストを実行します。テストの名前を指定してテストを個別に実行するか、またはパッケージ名を指定してテストのサブセットを実行することができます。

テストはパッケージの階層にまとめられます。パッケージは.文字で区切られ、テストケース名で終わります。

単体テストの出力

rippled --unittest=print

printは、使用可能なテストとそのパッケージのリストを出力する特殊な単体テストです。

手動の単体テスト

完了に時間を要する一部の単体テストは、「手動」に分類されています。このようなテストについては、print単体テストの出力に|M|と表示されます。すべての単体テストまたは単体テストのパッケージを実行するときには、手動テストはデフォルトで実行されません。手動テストを個別に実行するには、テスト名を指定します。例:

$ ./rippled --unittest=ripple.tx.OversizeMeta
ripple.tx.OversizeMeta
Longest suite times:
  60.9s ripple.tx.OversizeMeta
60.9s, 1 suite, 1 case, 9016 tests total, 0 failures

単体テストの引数の指定

特定の手動単体テストでは引数を指定できます。以下のオプションを使用して引数を指定します。

オプション説明
--unittest-arg {ARG}実行される単体テストに引数{ARG}を指定します。引数を受け入れる単体テストはそれぞれ、固有の引数形式を定義しています。