可以使用以下幾種方法來存取說明：

幾乎 help 子指令 (不要與 --help 選項混淆) 的所有輸出都會開啟一個文字檢視器。這個文字檢視器可讓您向上或向下捲動，更方便地閱讀說明文字。若要離開該文字檢視器，請按 Q 鍵。

提示：在 Bash 和互動式外圍程序中使用 Tab 鍵補齊

crmsh 不僅對互動式外圍程序支援 Tab 鍵補齊，在 Bash 中也能直接全面支援此功能。例如，輸入 crm help config→|，該字即會補齊，就像在互動式外圍程序中一樣。

crm 指令本身的使用方式如下：

除了前面所述的方法之外，crmsh 還支援同步指令執行。使用 -w 選項可以啟動該功能。如果您啟動 crm 時未使用 -w，以後可以將使用者首選的 wait 設定為 yes (options wait yes) 以啟用該功能。如果啟用了此選項，crm 會一直等到轉換完成。每當啟動轉換後，就會顯示一些點來指出進度。同步的指令執行僅適用於 resource start 這樣的指令。

注意：區分管理子指令與組態子指令

crm 工具具有管理功能 (子指令為 resource 和 node)，可用於進行組態設定 (cib、configure)。

以下小節概述了 crm 工具的一些重要方面。

由於您始終都需要在叢集組態中處理資源代辦，因此 crm 工具包含了 ra 指令。使用該指令可以顯示資源代辦的相關資訊並對其進行管理 (如需其他資訊，另請參閱第 4.2.2 節「受支援的資源代辦類別」)：

root # crm ra
crm(live)ra# 

指令 classes 可列出所有類別和提供者：

crm(live)ra# classes
 lsb
 ocf / heartbeat linbit lvm2 ocfs2 pacemaker
 service
 stonith
 systemd
 

若要取得某個類別 (和提供者) 的所有可用資源代辦的綜覽，請使用 list 指令：

crm(live)ra# list ocf
AoEtarget           AudibleAlarm        CTDB                ClusterMon
Delay               Dummy               EvmsSCC             Evmsd
Filesystem          HealthCPU           HealthSMART         ICP
IPaddr              IPaddr2             IPsrcaddr           IPv6addr
LVM                 LinuxSCSI           MailTo              ManageRAID
ManageVE            Pure-FTPd           Raid1               Route
SAPDatabase         SAPInstance         SendArp             ServeRAID
...

若要檢視資源代辦的綜覽，請使用 info：

crm(live)ra# info ocf:drbd:linbit
This resource agent manages a DRBD* resource
as a master/slave resource. DRBD is a shared-nothing replicated storage
device. (ocf:linbit:drbd)

Master/Slave OCF Resource Agent for DRBD

Parameters (* denotes required, [] the default):

drbd_resource* (string): drbd resource name
    The name of the drbd resource from the drbd.conf file.

drbdconf (string, [/etc/drbd.conf]): Path to drbd.conf
    Full path to the drbd.conf file.

Operations' defaults (advisory minimum):

    start         timeout=240
    promote       timeout=90 
    demote        timeout=90 
    notify        timeout=90 
    stop          timeout=100
    monitor_Slave_0 interval=20 timeout=20 start-delay=1m
    monitor_Master_0 interval=10 timeout=20 start-delay=1m

按 Q 鍵可離開檢視器。

提示：直接使用 crm

前面的範例中使用了 crm 指令的內部外圍程序。但是，您不一定要使用該外圍程序。如果將相應的子指令新增至 crm，也可獲得同樣的結果。例如，在外圍程序中輸入 crm ra list ocf 可列出所有 OCF 資源代辦。

組態樣板是可供 crmsh 使用的現成叢集組態。不要將它們與資源樣板 (如第 6.4.2 節「建立資源樣板」 所述) 混淆。資源樣板適用於叢集而非 crm 外圍程序。

組態樣板只需略做調整就能符合特定使用者的需求。當某樣板建立組態時，便會有警告訊息發出提示，您稍後可以在進一步自定時編輯該提示。

以下程序說明如何建立一個簡單但功能齊備的 Apache 組態：

如果您瞭解詳細資料，還可以使指令更簡單。您可以在外圍程序中使用以下指令來彙總上述程序：

root # crm configure template \
   new g-intranet apache params \
   configfile="/etc/apache2/httpd.conf" ip="192.168.1.101"

如果您在內部 crm 外圍程序中，請使用以下指令：

crm(live)configure template# new intranet apache params \
   configfile="/etc/apache2/httpd.conf" ip="192.168.1.101"

但是，之前的指令只是藉由組態樣板建立其組態，而不會套用或提交至 CIB。

非正式組態用於測試不同的組態案例。如果您已建立幾個非正式組態，則可以逐個進行測試以查看變更的效果。

一般程序如下：

在將組態變更載入回叢集之前，建議您先使用 ptest 檢閱變更。ptest 指令可顯示提交變更後將發生之動作的圖表。您需要 graphviz 套件才能顯示圖表。以下範例是一份記錄，新增了監控操作：

root # crm configure
crm(live)configure# show fence-bob 
primitive fence-bob stonith:apcsmart \
        params hostlist="bob"
crm(live)configure# monitor fence-bob 120m:60s
crm(live)configure# show changed
primitive fence-bob stonith:apcsmart \
        params hostlist="bob" \
        op monitor interval="120m" timeout="60s"
crm(live)configure# ptest
crm(live)configure# commit

若要輸出圖形 5.2 「Hawk — 叢集圖表」 所示的叢集圖表，請使用指令 crm configure graph。該指令會在目前所在的視窗中顯示目前的組態，因此需要 X11。

如果您偏好使用可擴充向量圖形 (SVG)，請使用如下指令：

root # crm configure graph dot config.svg svg

系統提供了三種適用於叢集的 RA (資源代辦)，如需背景資訊，請參閱第 4.2.2 節「受支援的資源代辦類別」。若要將新資源新增至叢集，請執行以下步驟：

如果您要建立多個具有相似組態的資源，資源樣板可以簡化此任務。另請參閱第 4.4.3 節「資源樣板和條件約束」 以瞭解一些基本的背景資訊。請勿將它們與第 6.1.4 節「使用組態樣板」 中所述的「normal」樣板相混淆。請使用 rsc_template 指令熟悉相應語法：

root # crm configure rsc_template
usage: rsc_template <name> [<class>:[<provider>:]]<type>
        [params <param>=<value> [<param>=<value>...]]
        [meta <attribute>=<value> [<attribute>=<value>...]]
        [utilization <attribute>=<value> [<attribute>=<value>...]]
        [operations id_spec
            [op op_type [<attribute>=<value>...] ...]]

例如，以下指令會建立一個名為 BigVM 的新資源樣板，該樣板由 ocf:heartbeat:Xen 資源及一些預設值與操作衍生而來：

crm(live)configure# rsc_template BigVM ocf:heartbeat:Xen \
   params allow_mem_management="true" \
   op monitor timeout=60s interval=15s \
   op stop timeout=10m \
   op start timeout=10m

定義新的資源樣板後，您可以在基本資源中使用該樣板，或者在順序、並存或 rsc_ticket 條件約束中參考該樣板。若要參考資源樣板，請使用 @ 符號：

crm(live)configure# primitive MyVM1 @BigVM \
   params xmfile="/etc/xen/shared-vm/MyVM1" name="MyVM1"

新基本資源 MyVM1 將繼承 BigVM 資源樣板的一切。例如，與上面兩個指令具有同等效果的指令為：

crm(live)configure# primitive MyVM1 ocf:heartbeat:Xen \
   params xmfile="/etc/xen/shared-vm/MyVM1" name="MyVM1"
   params allow_mem_management="true" \
   op monitor timeout=60s interval=15s \
   op stop timeout=10m \
   op start timeout=10m

如果您想覆寫某些選項或操作，只需將它們新增到您的 (基本資源) 定義即可。例如，下面的新基本資源 MyVM2 使監控操作的逾時加倍，而其他內容則保留不變。

crm(live)configure# primitive MyVM2 @BigVM \
   params xmfile="/etc/xen/shared-vm/MyVM2" name="MyVM2" \
   op monitor timeout=120s interval=30s    

在條件約束中可以參考資源樣板，來代表所有由該樣板衍生的基本資源。這有助於產生更加簡明、清晰的叢集組態。除了位置條件約束以外，其他所有條件約束中均允許參考資源樣板。並存條件約束不可包含一個以上的樣板參考。

從 crm 角度看，STONITH 裝置只是另一個資源。若要建立 STONITH 資源，請執行下列步驟：

設定所有資源只是工作的一部分。即使叢集瞭解所有必需的資源，可能仍然無法正確地對其進行處理。例如，儘量不要在 DRBD 的從屬節點上掛接檔案系統 (實際上，對 DRBD 執行此操作將會失敗)。定義相關條件約束，讓此類資訊適用於叢集。

如需條件約束的詳細資訊，請參閱第 4.4 節「資源條件約束」。

crm(live)configure# location loc-fs1 fs1 100: alice

crm(live)configure# primitive pingd pingd \
    params name=pingd dampen=5s multiplier=100 host_list="r1 r2"
crm(live)configure# location loc-node_pref internal_www \
    rule 50: #uname eq alice \
    rule pingd: defined pingd

crm(live)configure# primitive vip1 ocf:heartbeat:IPaddr2 params ip=192.168.1.5
crm(live)configure# primitive vip1 ocf:heartbeat:IPaddr2 params ip=192.168.1.6
crm(live)configure# location loc-alice { vip1 vip2 } inf: alice 

crm(live)configure# location  loc-alice /vip.*/ inf: alice

crm(live)configure# colocation nfs_on_filesystem inf: nfs_group filesystem_resource

root # crm configure assist weak-bond RES1 RES2

crm(live)configure# order nfs_after_filesystem mandatory: filesystem_resource nfs_group

若要判斷資源容錯移轉，請使用 meta 屬性 migration-threshold。如果所有節點上的 failcount 都超出了 migration-threshold，資源將一直處於停止狀態。例如：

crm(live)configure# location rsc1-alice rsc1 100: alice

通常情況下，rsc1 偏好在 alice 上執行。如果失敗，則會檢查 migration-threshold 並將其與 failcount 進行比較。若 failcount >= migration-threshold，則將資源移轉至優先設定次佳的節點。

根據 start-failure-is-fatal 選項的值，啟動失敗會將 failcount 設定為 inf。停止失敗將導致圍籬區隔。如果未定義 STONITH，資源將不會移轉。

如需綜覽，請參閱第 4.4.4 節「容錯移轉節點」。

當原始節點恢復連線且位於叢集中時，資源可以錯誤回復至該節點。若不想讓資源錯誤回復至先前執行時所在的節點，或要為資源指定另一個錯誤回復節點，請變更其 resource stickiness 值。您可以在建立資源時或建立之後指定資源粘性。

如需綜覽，請參閱第 4.4.5 節「錯誤回復節點」。

某些資源可能有特定的容量要求，例如最低記憶體容量。如果不符合其要求，這些資源可能無法完全啟動，或者執行時效能會降低。

鑒於此，High Availability Extension 允許您指定以下參數：

如需參數的詳細背景資訊及組態範例，請參閱第 4.4.6 節「依據負載影響放置資源」。

若要設定資源的要求以及節點提供的容量，可以利用使用率屬性。您可以依據自己的偏好命名使用率屬性，依據組態需要定義任意數量的名稱/值對。在某些情況下，有些代辦 (例如 VirtualDomain) 會自行更新使用率。

在以下範例中，假設您已擁有叢集節點和資源的基本組態，現在還想要設定特定節點提供的容量和特定資源需要的容量。

以下範例描述一個由三個同級別節點組成的叢集和 4 台虛擬機器：

crm(live)configure# node alice utilization memory="4000"
crm(live)configure# node bob utilization memory="4000"
crm(live)configure# node charly utilization memory="4000"
crm(live)configure# primitive xenA ocf:heartbeat:Xen \
    utilization memory="3500" meta priority="10"
crm(live)configure# primitive xenB ocf:heartbeat:Xen \
    utilization memory="2000" meta priority="1"
crm(live)configure# primitive xenC ocf:heartbeat:Xen \
    utilization memory="2000" meta priority="1"
crm(live)configure# primitive xenD ocf:heartbeat:Xen \
    utilization memory="1000" meta priority="5"
crm(live)configure# property placement-strategy="minimal"

這三個節點啟動後，會先將 xenA 配置於一個節點上，接著是 xenD。xenB 和 xenC 會配置在一起，或其中一個與 xenD 配置在一起。

如果一個節點失敗，表示可用的總記憶體太少，無法代管全部資源。如此會確保 xenA 及 xenD 都會予以配置。但 xenB 與 xenC 只有其中一個會予以配置，因為它們的優先程度相同，因此結果尚不確定。若要解決這種不確定的狀況，您需要為其中一個設定較高的優先程度。

若要監控資源，可以使用兩種方法：使用 op 關鍵字定義監控操作或使用 monitor 指令。下面的範例設定了一個 Apache 資源，並使用 op 關鍵字每隔 60 秒鐘對其執行一次監控操作：

crm(live)configure# primitive apache apache \
  params ... \
  op monitor interval=60s timeout=30s

下列指令可達到相同目的：

crm(live)configure# primitive apache apache \
   params ...
crm(live)configure# monitor apache 60s:30s

如需綜覽，請參閱第 4.3 節「資源監控」。

叢集其中一個最常見的元素是需要存放在一起的一組資源。請按照順序啟動它們，停止時採用相反順序。若要簡化此組態，您可以使用群組。以下範例將建立兩個基本資源 (一個 IP 位址和一個電子郵件資源)：

若要變更群組成員的順序，請在 configure 子指令中使用 modgroup 指令。使用以下指令可將基本資源 Email 移至 Public-IP 前面。(這只用於示範該功能)：

crm(live)configure# modgroup g-shortcut add p.lsb-exim before p.public-ip

如果您想從群組中移除某個資源 (例如，Email)，請使用以下指令：

crm(live)configure# modgroup g-shortcut remove p.lsb-exim

如需綜覽，請參閱第 4.2.5.1 節「群組」。

複製品最初被認為是啟動 IP 資源的 N 個例項並在整個叢集進行分配以達到負載平衡的一種便利方法。結果表明，複製還有其他多種用途，包括與 DLM 整合、圍籬區隔子系統和 OCFS2。只要資源代辦支援，就可以複製任何資源。

如需所複製之資源的詳細資訊，請參閱第 4.2.5.2 節「複製品」。

若要啟動新的叢集資源，您需要相應的識別碼。請執行下列步驟：

若資源失敗，系統會自動將其重新啟動，但每次失敗都會增加資源的 failcount。如果已對該資源設定 migration-threshold，則一旦失敗次數達到該移轉限定值，就不再允許該節點執行該資源。

執行下列步驟可以移除叢集資源：

雖然資源設定為在發生硬體或軟體失敗事件時自動容錯移轉 (或移轉) 至叢集的其他節點，您也可以使用 Hawk 或指令行將資源手動移至另一個節點。

請使用 migrate 指令來完成這項任務。例如，若要將資源 ipaddress1 移轉至名為 bob 的叢集節點，請使用以下指令：

root # crm resource
crm(live)resource# migrate ipaddress1 bob

使用標記可以一次參考多個資源，而無需在這些資源之間建立任何並存或順序關係。這個功能在把概念上相關的資源分組在一起時將十分實用。例如，如果有多個資源與某個資料庫相關，您可以建立名為 tag-db 的標記，並將與該資料庫相關的所有資源新增至此標記：

root # crm configure tag-db db1 db2 db3

這樣，只需使用一個指令就能啟動所有這些資源：

root # crm resource start tag-db

同樣，您也可以一次性停止所有這些資源：

root # crm resource stop tag-db

您可能不時地需要對個別叢集元件或整個叢集執行測試或維護任務 — 變更叢集組態、更新個別節點的軟體套件，或者將叢集升級到更高的產品版本。

為此，High Availability Extension 提供了針對多個層級的 maintenance 選項：

警告：資料遺失的風險

當服務在叢集控制下執行時，如果您需要執行任何測試或維護任務，請務必遵循以下指南：

1. 在開始之前，請將個別資源、節點或整個叢集設定為維護模式。這有助於避免一些不利的負面影響，例如，資源不按順序啟動、出現叢集節點間 CIB 不同步或資料遺失的風險。

2. 執行維護任務或測試。

3. 完成後，請解除維護模式以開始正常的叢集操作。

如需處於維護模式的資源和叢集會發生之情況的詳細資料，請參閱第 4.7 節「維護模式」。

您可以使用所謂的「程序檔」顯示叢集或節點的健康狀態。程序檔可以執行各種不同的任務，並不局限於顯示狀態。不過，本小節將重點介紹如何獲得健康狀態資訊。

若要獲得 health 指令的所有詳細資料，請使用 describe：

root # crm script describe health

該指令會顯示一則描述和所有參數及其預設值的清單。若要執行程序檔，請使用 run：

root # crm script run health verbose=true

如果您希望只執行整套指令中的一個步驟，可以使用 describe 指令列出步驟類別中的所有可用步驟。

例如，以下指令會執行 health 指令的第一個步驟。輸出會儲存在 health.json 檔案中以供進一步調查：

root # crm script run health \
    step='Collect cluster information' \
    statefile='health.json'

如需程序檔的其他資訊，請參閱 http://crmsh.github.io/scripts/。