htools - クラウド上のオンライン

プログラム：

NAME

htools - Ganeti 用のクラスターの割り当ておよび配置ツール

SYNOPSIS

ハブル クラスターバランサー

hチェック クラスターチェッカー

hスペース クラスター容量の計算

雹 IAllocator プラグイン

hスキャン 後で再利用できるようにクラスターの状態を保存します

ヒント クラスタ情報プリンタ

ローラー
クラスターローリングメンテナンススケジューラ

DESCRIPTION

htools は、インスタンスの割り当て/移動を支援するために設計された一連のツールです。
Ganeti クラスターのバランス調整。 htools は、シンボリックリンクする必要がある汎用バイナリでもあります。
さまざまな機能を実行するために、各ツールの名前の下にハードリンクされています。
あるいは、環境変数 HTOOLS を使用して、目的のロールを設定することもできます。

hbal としてインストールされ、一連のインスタンスの移動を計算し、オプションで順番に実行します。
クラスターのバランスを取るため。

hcheck としてインストールされ、クラスター チェックを実行し、オプションでリバランスをシミュレートします。
利用可能なすべての hbal オプション。

hspace としてインストールされ、クラスターに追加できるインスタンスの数を計算します。
N+1 ステータスを維持しながら。 既存のクラスターまたはシミュレートされたクラスターのモデル上で実行できます。
クラスター。

hail としてインストールされ、IAllocator プラグインとして機能します。つまり、Ganeti が計算に使用します。
新しいインスタンスの割り当てとインスタンスの移動。

hscan としてインストールされ、ローカルまたはリモートのクラスター状態をスキャンし、それをファイルに保存します。
後で他のロールで再利用できます。

hinfo としてインストールされ、現在のクラスターの状態に関する情報を出力します。

hroller としてインストールすると、ノードの再起動が必要なメンテナンスのスケジュールを立てるのに役立ちます。
クラスタ。

COMMON OPTIONS

オプションはすべてのプログラム モードで同じように動作しますが、すべてのプログラム モードがすべてをサポートしているわけではありません。
オプション。 一般的なオプションには次のようなものがあります。

-NS、 --print-nodes
ユーザーが理解できるように設計された形式でノードのステータスを出力します。
ノードの最も重要なパラメータ。 問題のコマンドがクラスターを作成する場合
移行 (例: バランシングまたは割り当て)、通常は最初と最後の両方
ノードのステータスが出力されます。

カンマ区切りのパラメータを渡すことで、リストされた情報をカスタマイズできます。
フィールド名のリストをこのオプションに追加します (フィールド リストは現在文書化されていません)、または
追加のフィールド リストの前にプラスを付けて、デフォルトのフィールド リストを拡張します。
サイン。 デフォルトでは、ノード リストには次の情報が含まれます。

F ノードのステータスを示す文字。「-」はオフラインを意味します
ノード、「*」は N+1 の失敗を意味し、空白は正常なノードを意味します

お名前 ノード名

t_mem ノードメモリの合計

n_mem ノード自体が使用するメモリ

i_mem インスタンスが使用するメモリ

x_mem 使用されていると思われるメモリの量ですが、その理由や原因を特定できません。
どのインスタンスか。 通常、これはハイパーバイザーに何らかのオーバーヘッドがあるか、または
他にも報告ミスがあること

f_mem 空きノードメモリ

r_mem 予約されたノード メモリ。N+1 に必要な空きメモリの量です。
コンプライアンス

t_dsk 合計ディスク

f_dsk フリーディスク

PCPU ノード上の物理 CPU の数

VCPU プライマリ インスタンスに割り当てられた仮想 CPU の数

パーセント プライマリ インスタンスの数

体細胞核移植 セカンダリ インスタンスの数

p_fmem 空きメモリのパーセント

p_fdsk 空きディスクのパーセント

r_cpu 仮想 CPU と物理 CPU の比率

lCPU 動的 CPU 負荷 (情報が利用可能な場合)

メモリ 動的メモリ負荷 (情報が利用可能な場合)

デスク 動的ディスク負荷 (情報が利用可能な場合)

lネット 動的正味負荷 (情報が利用可能な場合)

-t データファイル, --text-data=*データファイル*
バックエンドの仕様: ノードとインスタンスの情報を保持するファイルの名前
(RAPI または LUXI 経由で収集しない場合)。 このバックエンドまたは他のバックエンドのいずれかが、
選択されました。 オプションはマニュアルページに記載されています htoolsとします。

ファイルには、単一の空行で区切られた行ベースのテキスト データが含まれている必要があります。
セクション。 特に、空のセクションは空の文字列で記述されます。
その後に分離の空行が続き、XNUMX つの連続した空行が生成されます。
したがって、空行の数は重要であり、任意に変更することはできません。 の
行自体は列ベースであり、パイプ記号 (|) が区切り文字として機能します。

最初のセクションにはグループ データが含まれており、次の列があります。

・ グループ名

· グループuuid

· 割り当てポリシー

・タグ（カンマ区切り）

· ネットワーク (UUID、カンマ区切り)

XNUMX 番目のセクションにはノード データが含まれており、次の列があります。

· ノード名

· ノードの合計メモリ

· ノードが使用するメモリ

· ノード空きメモリ

· ノード合計ディスク

· ノード空きディスク

· ノードの物理コア

· オフライン/ロール フィールド (オフライン ノードの場合は Y、オンラインの非マスター ノードの場合は N、およびマスターの場合は M
常にオンラインのマスターノード)

· グループUUID

· ノードスピンドル数

· ノードタグ

· 排他的ストレージ値 (アクティブな場合は Y、そうでない場合は N)

· ノードフリースピンドル

· ノードOSが使用する仮想CPU

· ノードが属するノード グループ内の標準ノードの CPU 速度と相対的な CPU 速度
〜へ

XNUMX 番目のセクションには、次のフィールドを持つインスタンス データが含まれています。

· インスタンス名

· インスタンスメモリ

· インスタンスのディスクサイズ

· インスタンス vcpu

· インスタンスのステータス (Ganeti の形式、たとえば実行中または ERROR_down)

· インスタンス auto_balance フラグ (マニュアル ページを参照) gnt インスタンス（8））

· インスタンスプライマリノード

· インスタンスのセカンダリ ノード (存在する場合)

· インスタンスのディスク タイプ (プレーンまたは drbd など)

· インスタンスタグ

· スピンドルはバックエンドパラメータを使用します

· インスタンスによって使用される実際のディスク スピンドル (排他的ストレージが使用されている場合は可能性があります)
非活動中）

XNUMX 番目のセクションにはクラスター タグが含まれており、XNUMX 行に XNUMX つのタグが含まれます (列なし/列なし)。
列処理)。

XNUMX 番目のセクションには、クラスターとノード グループのポリシーが含まれています。
次の形式 (| で区切る):

· 所有者 (クラスターの場合は空、それ以外の場合はグループ名)

· 標準、最小、最大インスタンス仕様。 インスタンスの最小仕様と最大仕様は分離されています
セミコロンで区切って複数回指定可能
(最小;最大;最小;最大...); 各仕様には、分割された次の値が含まれます。
カンマで区切って:

・ メモリー容量

・CPU数

・ディスクサイズ

· ディスク数 - NIC 数

· ディスクテンプレート

・vcpu比

・主軸比

--mond=*はい|いいえ*
指定された場合、プログラムはすべての MonD をクエリして、サポートされているデータからデータを取得します。
ネットワーク上のコレクター。

-- モンドデータ データファイル
MonD のクエリをオーバーライドするために、MonD によって提供されるデータを保持するファイルの名前
ネットワーク経由で。 これは主にデバッグに使用されます。 ファイルは JSON である必要があります
XNUMX つのメンバーを持つ JSON オブジェクトの配列を、各ノードに XNUMX つずつフォーマットして表示します。
ノードという名前の最初のメンバーはノードの名前であり、XNUMX 番目のメンバーは という名前です。
reports はレポート オブジェクトの配列です。 レポートオブジェクトは同じ場所にある必要があります
監視エージェントによって生成された形式。

--無視-dynu
指定した場合、すべての動的使用率情報は、次のようにみなされて無視されます。
0. このオプションは、-U オプションによって渡されるデータよりも優先されます。
(hbal で利用可能)、または --mond および --mond-data オプションを使用した MonD によって利用可能です。

-m
バックエンド仕様: データを直接収集します。 引数として与えられる
RAPI経由で。 引数にコロン (:) が含まれていない場合、引数はコロン (:) に変換されます。
https:// を先頭に追加し、デフォルトの RAPI ポートを追加することで完全に構築された URL、
それ以外の場合は、完全に指定された URL とみなされ、そのまま使用されます。

-L [path]
バックエンドの仕様: マスター デーモンから直接データを収集します。
LUXI (Ganeti 内部プロトコル) 経由で接続されます。 オプションの path 引数は
マスターデーモンがリッスンする UNIX ソケットへのパスとして解釈されます。
それ以外の場合は、Ganeti によって使用されるデフォルトのパス (ビルド時に構成) が使用されます。

-I|--ialloc-src path
バックエンド仕様: iallocator リクエスト (生成されたとおり) からデータを直接ロードします。
iallocator 呼び出しを実行するときに Ganeti によって)。 iallocator リクエストは次から読み取られます。
指定されたパス。

-シミュレート 説明
バックエンド仕様: 実際のデータを使用する代わりに、指定された空のクラスターを構築します。
ノードの説明。 の 説明 パラメータは XNUMX つのカンマ区切りのリストである必要があります
要素を順番に説明します。

· このノード グループの割り当てポリシー (優先, 割り当て可能な or 割り当て不可,
または短い形式 p, a or u)

· クラスター内のノードの数

· ノードのディスク サイズ (デフォルトはメビバイト、単位は使用可能)

· ノードのメモリ サイズ (デフォルトはメビバイト、単位は使用可能)

· ノードの CPU コア数

· ノードのスピンドル数

説明の例は次のようになります。 推奨、20,100、16G、4,2g、XNUMX、XNUMX 20 ノードの説明
各ノードに 100 GB のディスク領域、16 GiB のメモリ、4 つの CPU コアと 2 つの CPU コアがあるクラスター
ディスクスピンドル。 現在、すべてのノードが同じ仕様である必要があることに注意してください。

このオプションは複数回指定でき、新たに使用するたびに新しいノード グループが定義されます。
したがって、異なるノード グループは異なる割り当てポリシーとノードを持つことができます。
カウント/仕様。

-v、 -詳細
出力の冗長性を高めます。 このオプションを使用するたびに、
冗長性 (現在は 5 を超えると意味がありません) をデフォルトの XNUMX から変更します。

-NS、 - 静かな
出力の冗長性を減らします。 このオプションを使用するたびに、
冗長性 (ゼロ未満は意味を持ちません) をデフォルトの XNUMX から変更します。

-V、 - バージョン
プログラムのバージョンを表示して終了します。

単位
一部のオプションでは、単純な数値だけでなく、数値と
ユニット。 デフォルトでは、このような単位を受け入れるオプションはメビバイトを使用します。 小文字の使用
の手紙 m, g と t (またはそれに相当する長いもの ミブ, ジブ, TIB、その場合
関係ありません) 明示的なバイナリ単位を選択できます。 SI システムの単位は次のとおりです。
大文字を使用して選択 M, G と T (またはそれに相当する長いもの MB,
GB, TB、その場合は問題ではありません）。

SI とバイナリ システムの違いの詳細については、次のドキュメントを参照してください。
ユニット（7）マニュアルページ。

ENVIRONMENT

環境変数 HTOOLS は、プログラムの名前変更やシンボリックリンクの代わりに使用できます。
目的の役割に設定するだけで、プログラムの名前は使用されなくなります。

報告 バグ

プロジェクトのWebサイトにバグを報告する（http://code.google.com/p/ganeti/）またはお問い合わせください
Ganetiメーリングリストを使用する開発者（[メール保護]).

onworks.net サービスを使用してオンラインで htools を使用する