Ceph M版本命令整理

bench
--io-type < read | write | readwrite | rw> [--io-size size-in-B/K/M/G/T] [--io-threads num-ios-in-flight] [--io-total size-in-B/K/M/G/T] [--io-pattern seq | rand] [--rw-mix-read read proportion in readwrite] image-spec

    生成一系列IO和IO吞吐量以及延遲的圖表，如果沒有指定的單位（B/K/M），則假--io-size和--io-total為B，默認的數值分別為：--io-size 4096, --io-threads 16, --io-total 1G, --io-pattern seq, --rw-mix-read 50

children snap-spec

     列出該快照的克隆卷，這個操作會檢查所有的pool，之后會輸出結果pool-name/image-name.

     但是需要這個image的format是2. 

clone
[–object-size size-in-B/K/M] [–stripe-unit size-in-B/K/M –stripe-count num] [–image-feature feature-name] [–image-shared] parent-snap-spec child-image-spec

     創建一個父快照的克隆卷，除非另外指定，否則object大小與父image和父快照的大小是相同的，--stripe-unit和     --stripe-count參數是可選的，但是必須同時使用。

     父快照的狀態需要是被保護的（protected）。

config global get config-entity key

     獲取覆蓋全局的配置。

config global list [--format plain|json|xml] [--pretty-format] config-entity

     列出覆蓋全局的配置。

config global set config-entity key value

     設置覆蓋全局的配置。

config global remove config-entity key

     刪除覆蓋全局的配置。

config image get image-spec key

     獲取覆蓋image級別的配置。

config image list [--format plain|json|xml] [--pretty-format] image-spec

     列出覆蓋image界別的配置。

config image set image-spec key value

     設置覆蓋image級別的設置。

config image remove image-spec key

     刪除覆蓋image級別的配置。

config pool get pool-name key

     獲取覆蓋pool級別的配置。

config pool set pool-name key value

     設置覆蓋pool級別的配置。

config pool remove pool-name key

     刪除覆蓋pool級別的配置。

cp (src-image-spec|sec-snap-spec) dest-image-spec

     將原image的內容復制到目標image中，目標imgae具有和源image相同的大小、對象大小和image format。

create
 (-s | --size size-in-M/G/T) [–image-format format-id] [–object-size size-in-B/K/M] [--stripe-unit size-in-B/K/M –stripe-count num] [--thick-provision] [--no-progress] [--image-feature feature-name]… [--image-shared] image-spec

     將會創建一個新的rbd image，需要在創建的同時指定image的大小。--stripe-unit and --stripe-count 是可選的，但是必須同時使用

deep cp (src-image-spec | src-snap-spec) dest-image-spec

     將源image的內容深度復制到新創建的目標image中，目標image將會和源image有相同的大小、對象大小、format和快照

device list [-t | --device-type device-type] [--format plain | json | xml] --pretty-format

     顯示通過rbd內核模塊（默認）映射的rbd image或其他支持的設備。

device map 
[-t | --device-type device-type] [--read-only] [–exclusive] [-o | --options device-options] image-spec| snap-spec

指定的rbd image通過內核模式映射到一個塊設備上或其他支持的設備上（linux上的nbd或FreeBSD傷的ggate）。

     選項參數是一個逗號分隔的設備類型特定選項列表（opt1,opt2=val,…）。

device unmap
 [-t | –device-type device-type] [-o | --options device-options] image-spec | snap-spec | device-path

     取消通過內核模塊(默認)或支持的其他設備上映射的rbd image。

     選項參數是一個逗號分隔的設備類型特定 選項列表（opt1,opt2=val,…）。

diff [--from-snap snap-name] [–whole-object] image-spec | snap-spec

    列出這個image從指定的快照創建時或從創建后已經更改的字節區段列表，輸出行包括起始偏移量（以字節為單位），區域長度（以字節為單位）和“0”或“data”，以顯示該區域是已知的0還是可能包含其他的數據。

du [-p | --pool pool-name] [image-spec | snap-spec]

       該命令將會計算指定的存儲池中所有image和相關快照的實際磁盤使用情況，還可以用于單個image和快照。

       如果RBD image的fast-diff特性沒有啟用，這個操作將會查詢每個存在該image對象的OSD。

export [--export-format format (1 or 2)] (image-spec | snap-spec) [dest-path]

     導出image到指定的路徑中（用于標準輸出），--export-format目前接受“1”或者“2”，format 2不僅允許到處image的內容，還允許導出快照的其他屬性，比如image_order，features。

export-diff [--from-snap snap-name] [–whole-object] (image-spec | snap-spec) dest-path

    導出image中的增量部分到指定的路徑下（用于標準輸出

），如果指定了初始快照，則只更改快照以后的增量，原本包含了image中任何包含數據的區域。使用標準的--snap選項或@snap語法指定快照。Image diff format 包含了元數據，image的大小改變以及開始和結束的快照，它有效的表示了image的廢棄或“0”區域。

feature disable image-spec feature-name…

     禁用指定image上的指定特性，可以指定多個特性。

feature enable image-spec feature-name

     啟用指定image上的指定特性，可以指定多個特性。

flatten image-spec

     如果image是克隆的，從父快照復制了所有的共享塊，使子image獨立于父快照，該命令可以截斷父快照和子image之間的聯系，如果父快照沒有進一步的依賴克隆，則可以是unprotected并刪除它。

     這個命令需要image的format 是2.

group create group-spec

     創建一個image組。

group image add group-spec image-spec

     添加一個image到一個組中。

group image list group-spec

     列出這個組中的所有image。

group image remove group-spec image-spec

    將一個image從組中刪除。

group ls [-p|--pool pool-name]

     列出一個存儲池中的image組。

group rename src-group-spec dest-group-spec

     重命名一個image組。注意：不支持跨存儲池重命名。

group rm group-spec

     刪除一個image組。

group snap create group-snap-spec

     為一個組創建快照。

group snap list group-spec

     列出組的所有快照。

group snap rm goup-snap-spec

     刪除組的快照。

group snap rename group-snap-spec snap-name

    重命名一個組的快照。

group snap rollback group-snap-spec

     將image組回滾到快照位置。

image-meta get image-spec key

     獲取元數據鍵。

image-meta list image-spec

     顯示image中的元數據，第一列是鍵，第二列是值。

image-meta remove image-spec key

     刪除原數據的鍵值。

image-meta set image-spec key value

     設置原數據的鍵值，設置的鍵值可以使用image-meta list列出。

import
 [–export-format format (1 or 2)] [–image-format format-id] [–object-size size-in-B/K/M] [–stripe-unit size-in-B/K/M –stripe-count num] [–image-feature feature-name]… [–image-shared] src-path [image-spec]

     創建一個新的image并將指定位置的數據（用于標準輸入）導入到該image中，如果可能，導入操作將嘗試創建稀疏rbd image。對于從標準輸入的導入，稀疏單元是目標image的數據塊大小（對象大小）。

     --stripe-unit和—stripe-count 是可選項，但是必須同時使用。

     --export-format的可以是“1”或者“2”，但是format 2不僅允許導入image的內容，還可以導入快照的其他屬性，例如image_order、feature。

import-diff src-path image-spec

     導入image的增量差異并將其應用于當前image。如果diff基于快照產生的，則在繼續之前驗證快照已經存在。如果有一個結束快照，我們將在應用更改之前驗證它不存在，并在完成更改后創建快照。

info image-spec|snap-spec

     將列出指定的image的信息（如大小，對象大小等），如果這個image是克隆卷，也會顯示其父對象信息；如果指定了一個快照則會顯示它是否是protected狀態。

journal client disconnect journal-spec

     標記imgae客戶端為斷開連接。

journal export [--verbose] [--no-error] src-journal-spec path-name

     導出image日志到指定路徑下（用于標準輸出），在做危險操作之前可以備份image的日志。

     注意：如果日志嚴重損壞，這個命令可能不生效。

journal import [--verbose] [--no-error] path-name dest-journal-spec

     從指定的路徑導入image的日志（用于標準輸入）。

journal info  journal-spec

     顯示image的日志信息。

journal inspect [--verbose] journal-spec

     檢查和報告image日志的結構誤差。

journal reset journal-spec

     重置image的日志。

journal status journal-spec

     查看image日志的狀態。

lock add [--shared lock-tag] image-spec lock-id

     鎖定一個image，lock-id是為了方便用戶而設置的任意名稱。默認情況下這是一個獨占鎖，這意味著如果在該image已經鎖定的情況下再次執行該操作將會失敗。參數--shared可以使這個image被多次鎖定。

注意：添加鎖之外不會影響任何操作，鎖不能保護image不被刪除。

lock ls imgae-spec

列出image上的鎖，第一列是與鎖刪除命令一起使用的鎖庫。 

lock rm image-spec lock-id locker

  釋放image上的鎖，lock-id和locker可以通過查看lock ls的輸出獲得。

ls [-l | –long] [pool-name]

     可以rbd image所有的rbd_directory對象。使用-l可以列出快照，并使用長格式輸出還會顯示包含大小、父image（如果是克隆）、format等。

merge-diff first-diff-path second-diff-path merged-diff-path

     把兩個連續的增量差異合并為單個差異。前一個差異的結束快照必須與后一個差異的起始快照相同。前一個差異可以是標準輸入，合并后的差異可以是標準輸出，這樣就可以合并多個差異文件，像這樣：“rbd merge-diff first second - | rbd merge-diff - third result”，注意，當前次命令僅支持stripe_count== 1這樣的源增量差異。

migration abort image-spec

     取消image的遷移操作。此步驟可能在準備遷移成功或失敗后執行，并將image返回初始（遷移前）狀態，對目標image所有的修改都將丟失。 

migration commit image-spec

     提交image遷移。這一步是在準備遷移成功和遷移步驟后刪除源image數據后執行的

migration execute image-spec

     執行image的遷移操作。這個步驟是在遷移工作準備成功并將image數據復制到目標image后執行的。

migration prepare [–order order] [–object-size object-size] [–image-feature image-feature] [–image-shared] [–stripe-unit stripe-unit] [–stripe-count stripe-count] [–data-pool data-pool] src-image-spec [dest-image-spec]

    準備image遷移。這個遷移image的第一步，即更改image位置、format或者其他不能動態更改的參數。目標可以與源匹配，在這種情況下，可以省略dest-image-spec。在此步驟之后，源image被設置為目標image的父image，并且根據目標image規范該image可以在copy-on-write模式下訪問。

mirror image demote image-spec

     將主image降級為非主iamge。

mirror image disable [–force] image-spec

    為image禁用RBD mirror。如果mirror是以image pool的模式設置的，則可以現實禁用池中的每個image的mirror。

mirror image enable image-spec

為image啟用RBD mirror。如果mirror是以image pool的模式配置的，則可以顯示為啟用池中的每個image的mirror。

mirror image promote [--force] image-spec

為RBD image將非主image升級為主image。

mirror image resync image-spec

強制對RBDimage的主image進行重新同步。

mirror image status image-spec

 顯示image的mirror狀態。

mirror pool demote [pool-name]

將RBD image的pool降級為非主要pool

mirror pool disable [pool-name]

默認是池的情況下禁用RBD mirror，以這種方式禁用存儲池的mirror時，對于已明確啟用的mirror的任何image（存儲池內）也將禁用mirror。

mirror pool enable [pool-name] mode

默認時存儲池的情況下啟用RBD mirror。Mirror模式可以是存儲池或者是image，如果在存儲池模式下配置，則會啟用存儲池中具有啟用日志功能的所有image。如果在mirror模式下配置，則需要在每image上啟用mirror（通過mirror image enabl命令）。

mirror pool info [pool-name]

顯示有關存儲池mirror配置的信息。它包括mirror模式，對等UUID，遠程集群名稱和遠程客戶端名稱

mirror pool peer add [pool-name] remote-cluster-spec

將mirror對等體添加到存儲池中。Remot-cluster-spec是[遠程客戶端名稱@]遠程集群名稱。

默認的遠程客戶端名稱是“client.admin”。

需要啟用mirror模式。 

mirror pool peer remove [pool-name] uuid

從存儲池中刪除mirror對等體，對等UUID可以通過mirror pool info命令獲得。 

mirror pool peer set [pool-name] uuid key value

更新mirror對等設置。密鑰可以是客戶端或集群，該值對應于遠程客戶端名稱或遠程集群名稱。

mirror pool promote [--force] [pool-name]

將存儲池中的每個非主image提升為主iamge，每個啟用mirror的image都將在存儲池中升級。 

mirror pool status [--verbose] [pool-name]

顯示存儲池中所有的image mirror的狀態，使用 –verbose還會為存儲池中的每個image mirror顯示輸出另外的詳細狀態信息。

mv src-image-spec dest-image-spec

     命名一個image，注意，不支持跨池重命名。

object-map check imag-spec | snap-spec

     驗證對象映射是否正確

object-map rebuild imag-spec | snap-spec

     為指定的image重建無效的對象映射。可以為指定的iamge快照以重建快照的無效對象映射。

pool init [pool-name] [--force]

初始化存儲池以供RBD使用。新創建的存儲池必須在使用前初始化。 

resize (-s | –size size-in-M/G/T) [–allow-shrink] image-spec

     調整rbd image的大小，還需要指定--size參數，--all-shrink選項可以減小大小。

rm image-spec

     刪除rbd image（包含所有的數據塊），如果這個image有快照則無法刪除。

snap create snap-spec

     創建一個新快照，需要指定快照名稱參數。 

snap limit clear image-spec

     刪除以前對image允許創建的快照數量的限制。

snap ls image-spec

     顯示指定的image的快照。

snap protect snap-spec

     保護快照不被刪除，以便可以對其進行克隆。在科隆生成之前必須保護快照，保護意味著存在以來克隆的子節點來引用此快照，如果快照是不被保護的rbd clone命令將會失敗。

snap purge image-spec

     刪除image中所有不受保護的快照。

snap rename src-snap-spec dest-snap-spec

     重命名一個快照，注意，不支持跨池重命名。

snap rm [--force] snap-spec

     刪除指定的快照。

snap rollback snap-spec

     將image內容會滾到快照階段，這將遍歷整個塊陣列并將數據頭內容更新為快照版本。

snap unprotect snap-spec

     刪除快照保護（撤銷快照保護），如果克隆的子項仍然存在，則snap unprotect將失敗（請注意，克隆可能存在于與富快照不同的存儲池中。）

     需要image的format 是2.

status image-spec

     顯示image的狀態，包括哪些客戶端正在使用/打開。

trash ls [pool-name]

     列出延遲刪除的所有條目。

trash mv image-spec

     列出垃圾桶中的所有條目。

trash mv image-spec

     將image移動到垃圾桶中，image即使是克隆正在使用的image可以克移動到垃圾桶后再刪除。

trash purge [pool-name]

     刪除垃圾桶中所有過期的image。

trash restore image-id

     從垃圾桶中恢復某個image。

trash rm image-id

     從垃圾桶中刪除image，如果image掩飾刪除時間尚未到期，除非強制刪除，否則無法將其刪除，但是無法主動刪除正在使用中的克隆或快照。

watch image-spec

     查看image上的活動事件。

***轉載請注明出處***