第 5 章 ストレージボリュームの設定
5.1. GDEPLOY を使用した GLUSTER ストレージボリュームの設定
5.1.7. 設定ファイル
設定ファイルには、gdeploy の設定を変更するために使用できるさまざまなオプションが含まれていま す。現在サポートされているオプションは以下のとおりです。
[hosts]
[devices]
[disktype]
[diskcount]
[stripesize]
[vgs]
[pools]
[lvs]
[mountpoints]
[Peer]
[clients]
[Volume]
[backend-setup]
[pv]
[vg]
[lv]
[rh-subscription]
[yum]
[shell]
[update-file]
[service]
[script]
[firewalld]
[geo-replication]
オプションは、以下の一覧で簡単に説明します。
hosts
これは、信頼されるストレージプール内のマシンの IP アドレスまたはホスト名が含まれる必須 セクションです。ホスト名または IP アドレスはそれぞれ別の行に記載する必要があります。
例：
[hosts]
10.0.0.1 10.0.0.2 devices
これは汎用セクションであり、[hosts] セクションに一覧表示されている全ホストに適用されま す。ただし、[hostname] や [IP-address] などのホストのセクションがある場合は、[devices]
のような一般的なセクションのデータは無視されます。ホスト固有のデータが優先されます。
これはオプションのセクションです。
例：
[devices]
/dev/sda /dev/sdb
注記 注記
バックエンドの設定を行う際には、このセクションまたはホスト固有のセクショ ンにデバイスを記載する必要があります。
disktype
本セクションでは、バックエンドの設定時に使用されるディスク設定を指定します。gdeploy は、RAID 10、RAID 6、RAID 5、および JBOD 設定をサポートします。これは任意のセクショ ンであり、このフィールドが空のままにすると、JBOD がデフォルト設定になります。この フィールドの有効な値は raid10、raid6、raid5、およびです jbod。
例：
[disktype]
raid6
このセクションでは、設定内のデータディスクの数を指定します。で RAID ディスク種別が指 定されている場合は、このフィールドは必須です [disktype]。[disktype] が JBOD の場合、
[diskcount] の値は無視されます。このパラメーターは、ホスト固有のものです。
例：
[diskcount]
10 stripesize
このセクションでは、stripe_unit のサイズを KB 単位で指定します。
ケース 1: [disktype] が JBOD で、指定の値は無視されます。
ケース 2: [disktype] が RAID 5 または RAID 6 として指定されている場合は必須フィールドで す。
[disktype] RAID 10 のデフォルト値は 256 KB です。Red Hat では、この値の変更は推奨してい ません。他の値を指定すると、以下の警告が表示されます。
"Warning: We recommend a stripe unit size of 256KB for RAID 10"
注記 注記
K、KB、M などのサフィックスを追加しないでください。このパラメーターはホ ストに固有で、hosts セクションに追加できます。
例：
[stripesize]
128 vgs
このセクションは、gdeploy 2.0 で非推奨となりました。gdeploy 2.0 の詳細は
[backend-setup] を参照してください。このセクションでは、[devices] に一覧表示されるデバイスのボ
リュームグループ名を指定します。[vgs] セクションのボリュームグループ数は、[devices] の ボリュームグループと一致している必要があります。ボリュームグループ名がない場合、ボ リュームグループの名前はデフォルトで GLUSTER_vg{1, 2, 3, ...} という名前になります。
例：
[vgs]
CUSTOM_vg1 CUSTOM_vg2 プール
プール
このセクションは、gdeploy 2.0 で非推奨となりました。gdeploy 2.0 の詳細は
[backend-setup] を参照してください。このセクションでは、[vgs] セクションで指定したボリュームグ
ループのプール名を指定します。[pools] セクションに一覧表示されるプールの数は、[vgs] セ クションのボリュームグループ数と一致する必要があります。プール名がないと、プールの名 前は GLUSTER_pool{1, 2, 3, ...} になります。
例：
[pools]
CUSTOM_pool1 CUSTOM_pool2 lvs
このセクションは、gdeploy 2.0 で非推奨となりました。gdeploy 2.0 の詳細は
[backend-setup] を参照してください。本セクションでは、[vgs] で指定したボリュームグループの論理
ボリューム名を説明します。[lvs] セクションに一覧表示される論理ボリュームの数は、[vgs]
に一覧表示されるボリュームグループの数と一致する必要があります。論理ボリューム名がな い場合は、GLUSTER_lv{1, 2, 3, ...} という名前が付けられます。
例：
[lvs]
CUSTOM_lv1 CUSTOM_lv2 マウントポイント マウントポイント
このセクションは、gdeploy 2.0 で非推奨となりました。gdeploy 2.0 の詳細は
[backend-setup] を参照してください。このセクションでは、論理ボリュームのブリックマウントポイン
トを指定します。マウントポイントの数は、[lvs] で指定された論理ボリュームの数と一致する 必要があります。マウントポイントが見つからない場合、マウントポイントの名前は
/gluster/brick{1, 2, 3…} となります。
例：
[mountpoints]
/rhgs/brick1 /rhgs/brick2 peer
本セクションでは、TSP(Trusted Storage Pool management)の設定を指定します。本セクショ
ンは、[hosts] セクションに指定されたすべてのホストをプローブして、信頼できるストレージ
プールを作成するか、信頼できるストレージプールからそれらをすべてデタッチする方法を説 明します。このセクションの唯一のオプションは 'action' の名前で、これは probe または
detach のいずれかの値を持つことができます。
例：
[peer]
action=probe Clients
このセクションでは、作成した gluster ストレージボリュームをマウントするためのクライアン トホストと client_mount_points を指定します。'action' オプションは、実行する必要があるア クションを判断するためにフレームワークに指定されます。オプションは「mount」および
「unmount」です。Client hosts フィールドは必須です。マウントポイントが指定されていない
場合、デフォルトは全ホストの /mnt/gluster になります。
fstype オプションは、gluster ボリュームをマウントする方法を指定します。デフォルトは
glusterfs(FUSE mount)です。ボリュームを NFS としてマウントすることもできます。各クラ イアントは、コンマ区切りで指定する必要がある異なるタイプのボリュームマウントを持つこ とができます。以下のフィールドが含まれます。
* action
* hosts
* fstype
* client_mount_points 例：
[clients]
action=mount hosts=10.0.0.10 fstype=nfs options=vers=3
client_mount_points=/mnt/rhs ボリューム
ボリューム
セクションでは、ボリュームの設定オプションを指定します。このセクションには、以下の フィールドが含まれます。
* action
* volname
* transport
* replica
* replica_count
* disperse
* disperse_count
* redundancy_count
* force action
このオプションは、ボリューム内で実行する必要のあるアクションを指定します。
[create、delete、add-brick、remove-brick] を選択できます。
作成
作成: ボリュームの作成には、この方法が使用されます。
DELETE:削除削除の選択肢を使用する場合は、「volname」以外のオプションは無視されま
す。
add-brick または remove-brick: add-brick または remove-brick が選択されている場合、
（<hostname>:<brick path> の形式で）、カンマ区切りのリストで、追加のオプションをコ ンマ区切りで指定します。remove-brick の場合、state オプションも、ブリックを削除した 後にボリュームの状態を指定するように指定する必要があります。
volname
このオプションは、ボリューム名を指定します。デフォルト名は glustervol です。
注記 注記
ボリューム操作の場合には、「hosts」セクションは省略できます。指定 される volname は <hostname>:<volname> の形式になります。
hostname はクラスター内のいずれかのノードのホスト名 / IP です。
単一ボリュームの作成/完了/設定のみがサポートされます。
transport
このオプションは、トランスポートタイプを指定します。デフォルトは tcp です。オプ ションは tcp または rdma（非推奨）または tcp,rdma です。
レプリカ レプリカ
このオプションは、ボリュームのタイプが replica であるかどうかを指定します。オプショ ンは yes で、no です。'replica' が yes として提供されている場合は、「replica_count」を 指定します。
disperse
このオプションは、ボリュームのタイプが分散されるべきかどうかを指定します。オプ ションは yes で no です。デフォルトは no です。
disperse_count
'disperse' が yes の場合でもこのフィールドは任意です。指定しないと、コマンドラインで
指定されたブリックの数が disperse_count の値として取得されます。
redundancy_count
この値が指定されておらず、「disperse」が yes の場合、デフォルト値が計算され、最適な 設定が生成されます。
force
これは任意のフィールドで、ボリュームの作成中に強制的にボリュームを作成できます。
例：
[volname]
action=create volname=glustervol transport=tcp,rdma replica=yes
replica_count=3 force=yes backend-setup
gdeploy 2.0 で利用できます。本セクションでは、GlusterFS ボリュームで使用するバックエン
ドを設定します。複数の backend-setup を行う必要がある場合は、[backend-setup1]、
[backend-setup2]、... などのセクションに番号を付けることで実行できます。
backend-setup セクションでは、以下の変数がサポートされます。
デバイス：これは gdeploy 1.x の [pvs] セクションに代わるものです。device 変数は、バッ クエンドの設定に使用する raw ディスクを一覧表示します。例：
[backend-setup]
devices=sda,sdb,sdc これは必須フィールドです。
deadign:
論理ボリュームマネージャーは、物理ボリュームの一部を使用してメタデータを保存する ことができ、残りの部分はデータ部分として使用されます。物理ボリュームの作成時に
decign オプションを使用して、論理ボリュームマネージャー(LVM)レイヤーで I/O を調整
します。例：
[backend-setup]
devices=sdb,sdc,sdd,sde dalign=256k
JBOD の場合は、アライメントの 256K を使用します。ハードウェア RAID の場合は、
RAID ストライプユニットのサイズをデータディスクの数で乗算して、アライメント値を取
得する必要があります。RAID 6 設定で 12 ディスクを使用している場合、データディスク数 は 10 になります。一方で、RAID 10 設定で 12 ディスクを使用している場合は、データディ スク数は 6 になります。
以下の例は、ストライプユニットサイズが 128 KiB の RAID 6 設定の 12 ディスクに適してい ます。
[backend-setup]
devices=sdb,sdc,sdd,sde dalign=1280k
以下の例は、ストライプユニットサイズが 256 KiB の RAID 10 設定の 12 ディスクに適して います。
[backend-setup]
devices=sdb,sdc,sdd,sde dalign=1536k
destroyign オプションに以前に設定した物理ボリューム設定を表示するには、pvs -o
+pe_start device コマンドを実行します。例：
# pvs -o +pe_start disk
PV VG Fmt Attr PSize PFree 1st PE /dev/sdb lvm2 a-- 9.09t 9.09t 1.25m
PV セクションに alsign オプションを設定することもできます。
vgs: これはオプションの変数です。この変数は、gdeploy 1.x. vgs 変数の [vgs] セクション に、ボリュームグループの作成時に使用される名前を一覧表示します。VG の名前の数はデ バイス数と一致するか、空白のままにする必要があります。gdeploy は、VG の名前を生成 します。例：
[backend-setup]
devices=sda,sdb,sdc
vgs=custom_vg1,custom_vg2,custom_vg3