mkvdev 指令

用途

將虛擬裝置新增至系統。

語法

如果要建立虛擬目標裝置,請執行下列動作:

mkvdev [ -f ] {-vdev TargetDevice | -dplc TDPhysicalLocationCode } { -vadapter VirtualServerAdapter | -aplc VSAPhysicalLocationCode} [ -dev DeviceName ]

若要為檔案支持的虛擬光學裝置建立虛擬目標裝置,請執行下列動作:

mkvdev -fbo { -vadapter VirtualServerAdapter | -aplc VSAPhysicalLocationCode } [-dev DeviceName]

當備份裝置是 Peer-to-Peer Remote Copy (PPRC) 配對的一部分時,若要建立虛擬目標裝置,請執行下列動作:

mkvdev [ -f ] {-vdev TargetDevice | -dplc TDPhysicalLocationCode } { -vadapter VirtualServerAdapter | -aplc VSAPhysicalLocationCode} { -attr 鏡映= true} [ -dev DeviceName ]

如果要建立共用乙太網路配接卡,請執行下列動作:

mkvdev [-sea] TargetDevice -vadapter VirtualEthernet配接卡... -default DefaultVirtualEthernetAdapter -defaultid SEADefaultPVID [ -attr Attribute = Value [ Attribute = Value... ]] [ -migrate [ -auto]]

附註: 共用乙太網路配接卡屬性 ha_modectl_chan必須一起指定。 如果只指定一個屬性,指令會失敗。 這些屬性用來在失效接手配置中建立共用乙太網路配接卡。

如果要建立鏈結聚集配接卡,請執行下列動作:

mkvdev -lnagg TargetAdapter... [ -attr 屬性 = 值 [ 屬性 = 值... ]] [ -migrate -auto [ -interface TargetInterface ]]

如果要建立 VLAN 乙太網路配接卡,請執行下列動作:

mkvdev -vlan TargetAdapter -tagid TagID

說明

mkvdev 指令會建立虛擬裝置。 除非指定 -dev DeviceName 旗標,在此情況下 DeviceName 會變成裝置名稱,否則會自動產生並指派虛擬裝置的名稱。

如果備份裝置是 PPRC 配對的一部分,請將鏡映屬性設為 TRUE ,以建立虛擬目標裝置。 這容許將 PPRC 次要裝置匯出至用戶端分割區。

如果指定 -lnagg 旗標,則會建立鏈結聚集或 IEEE 802.3 鏈結聚集 (自動鏈結聚集) 裝置。 若要建立 IEEE 802.3 鏈結聚集,請將 mode 屬性設為 8023ad。 如果指定 -sea 旗標,則會建立共用乙太網路配接卡。 TargetDevice 可能是鏈結聚集配接卡 (請注意, VirtualEthernet配接卡 可能不是鏈結聚集配接卡)。 預設虛擬乙太網路配接卡 DefaultVirtualEthernetAdapter也必須併入為其中一個虛擬乙太網路配接卡 VirtualEthernet配接卡

-fbo 旗標可用來建立虛擬目標裝置,以將 VirtualServer配接卡 對映至由檔案支持的虛擬光學裝置。 在虛擬媒體載入裝置之前,無法使用虛擬光學裝置。 如需詳細資料,請參閱 loadopt 指令。

-vlan 旗標用於建立 VLAN 裝置,而 -vdev 旗標用於建立將 VirtualServer配接卡 對映至 TargetDevice的虛擬目標裝置。

如果 -vdev-dplc 旗標指定的備份裝置已在使用中,則除非同時指定 -f 旗標,否則會傳回錯誤。 此外,指定的備份裝置不能是指派給共用記憶體儲存區的實體或邏輯磁區 (由共用記憶體分割區用作分頁空間裝置)。

mkvdev 指令也會配置虛擬光學 及磁帶 裝置,其中 -vdev-dplc 旗標會指定實體光學 或磁帶 裝置,而 -vadapter-aplc 旗標會指定虛擬 SCSI 配接卡。 如果指定的光學 或磁帶 裝置已指派給虛擬 SCSI 配接卡,則除非同時指定 -f 旗標,否則會傳回錯誤。 如果指定 -f 旗標,則在將光學 或磁帶 裝置重新指派給新的虛擬 SCSI 配接卡之前,會將它從指派給它的虛擬 SCSI 配接卡中移除。

如果新增其他磁碟機的 max_transfer_size 低於現行設定,且將它設為虛擬目標裝置 (處理 mkvdev) ,則在 VIOS 重新開機並將 max_transfer_size 重新建立為新設定之前,用戶端無法辨識此裝置。 因為無法動態變更 max_transfer_size ,所以 mkvdev 指令會檢查所新增裝置的現行 max_transfer_size 。 如果較低,則會公佈一則訊息,指出必須先重新啟動 VIOS ,然後用戶端才能看到此裝置。

永久記憶體 Express (NVMe) 類型的磁碟無法直接指派給伺服器 SCSI 配接卡。 指派 NVMe 磁碟的唯一受支援方法是在 NVMe 磁碟上建立邏輯磁區,然後將邏輯磁區指派給伺服器 SCSI 配接卡。

注意: 為了保護「配置資料庫」, mkvdev 指令不可岔斷。 在執行完成之前停止此指令可能會導致資料庫毀損。

旗標

旗標名稱 說明
-aplc VSAPhysicalLocation程式碼 使用實體位置碼來指定虛擬 SCSI 配接卡
-attr 屬性 = 值 指定要使用的裝置屬性值配對,而非預設值。 Attribute = Value 變數可用來為一個 -attr 旗標指定一個屬性值配對或多個屬性值配對。 如果搭配使用 -attr 旗標與多個屬性值配對,則配對清單必須以引號括住配對之間的空格。 例如,輸入 -attr Attribute = Value 時,每個旗標會列出一個屬性值配對,而輸入 -attr 'Attribute1=Value1 Attribute2=Value2' 會列出多個屬性值配對。
-auto 使用 -migrate 選項建立共用乙太網路配接卡時,移轉及還原乙太網路介面。
-default DefaultVirtualEthernetAdapter 用於非 VLAN 標籤封包的預設虛擬配接卡。 此旗標對映至共用乙太網路配接卡裝置屬性 pvid_adapter。
-defaultid SEADefaultPVID SEADefaultPVID 是用於無標籤訊框的 VID。 所有未標記的封包都會獲指派 SEADefaultPVID 值。 當埠接收標籤式訊框時,會使用標籤。 否則,如果框架未加上標籤,則 PVID 中包含的值會被視為標籤。 此旗標對映至共用乙太網路配接卡裝置屬性 pvid。
-dev DeviceName 透過使用 -dev 旗標,您可以指定要用來識別裝置的名稱。 如果您不使用 -dev 旗標,則會自動產生並指派名稱。 並非所有裝置都支援使用者提供的名稱。
-dplc TDPhysicalLocation程式碼 使用實體位置碼來指定實體裝置
-f 強制指定作為備份裝置的實體磁區,即使它已與虛擬 SCSI 配接卡相關聯也一樣。 如果指定的備份裝置是光學裝置,在將光學裝置重新指派給新的虛擬 SCSI 配接卡之前, -f 會強制從指派給它的虛擬 SCSI 配接卡中移除該光學裝置。

-f 旗標也可以用來強制 mkvdev 指令在失敗時繼續運作,因為該裝置正用作叢集裝置。 在強制 mkvdev 指令繼續運作之前,您必須知道磁碟可見的每一部主機及其使用方式。

-fbo 建立虛擬光學裝置。
-lnagg TargetAdapter... 建立鏈結聚集裝置。
-migrate 將設定從實體配接卡介面移轉至共用乙太網路配接卡介面。
-sea TargetDevice 建立將 VirtualEthernet配接卡 對映至配接卡 TargetDevice的共用乙太網路配接卡。 TargetDevice 可以是實體配接卡或鏈結聚集配接卡。
-tagid TagID 指定 VLAN 標籤 ID。
-vadapter VirtualEthernet配接卡VirtualServer配接卡 指定新裝置所對映的虛擬伺服器配接卡或虛擬乙太網路配接卡。 如果指定多個虛擬乙太網路配接卡,請以逗點區隔配接卡名稱,且不含空格。
-vdev TargetDevice 建立對映至實體/邏輯裝置 TargetDevice 及虛擬伺服器配接卡 VirtualServer配接卡的虛擬裝置。 TargetDevice 可以是實體磁區、邏輯磁區、 磁帶、 USB HD 或光學裝置。 指派給磁區群組的實體磁區無法用作目標裝置。
-vlan TargetAdapter 建立虛擬區域網路裝置。
附註: 建立共用乙太網路配接卡時, -auto-migrate 選項不支援移轉 IPv6 無狀態配置。

結束狀態

回覆碼 說明
13 指定的實體或邏輯磁區無效。
21 裝置已在使用中。 使用 -f 旗標來強制指派。
22 邏輯磁區不能多次指派為備份裝置。

範例

  1. 若要建立虛擬目標裝置,將邏輯磁區 lv20 對映為 vhost0 虛擬伺服器配接卡所管理用戶端分割區的虛擬磁碟,請鍵入下列指令:
    mkvdev -vdev lv20 -vadapter vhost0

    系統會顯示下列訊息:

    vtscsi0 available
  2. 若要建立虛擬目標裝置,將實體磁區 hdisk6 對映為 vhost2 虛擬伺服器配接卡所提供用戶端分割區的虛擬磁碟,請鍵入下列指令:
    mkvdev -vdev hdisk6 -vadapter vhost2

    系統會顯示下列訊息:

    vtscsi1 available
  3. 若要建立虛擬目標裝置,以將實體磁帶機 rmt0 對映為 vhost2 虛擬伺服器配接卡所提供之用戶端分割區的虛擬磁帶機,請鍵入下列指令:
    mkvdev -vdev rmt0 -vadapter vhost2

    系統會顯示下列訊息:

    vttape0 available
  4. 若要建立共用乙太網路配接卡,將實體乙太網路配接卡 ent4 對映為虛擬乙太網路配接卡 (由虛擬乙太網路配接卡 ent6提供服務的用戶端分割區) , ent7ent9, 使用 ent6 作為預設配接卡,並使用 8 作為預設 ID ,鍵入下列指令:
    mkvdev -sea ent4 -vadapter ent6 ent7 ent9 -default ent6 -defaultid 8

    系統會顯示下列訊息:

    ent10 available
  5. 若要使用控制通道配接卡 ent5在失效接手配置中建立共用乙太網路配接卡,請建立共用乙太網路配接卡,如範例 4 所示。 但使用 -attr指定其他屬性 ha_modectl_chan 。 例如:
    mkvdev -sea ent4 -vadapter ent6 -default ent6 -defaultid 1 -attr ha_mode=auto ctl_chan=ent5
  6. 若要使用主要配接卡 ent4ent5 和備份配接卡 ent6來建立自動鏈結聚集,請鍵入下列指令:
    mkvdev -lnagg ent4 ent5 -attr backup_adapter=ent6 mode=8023ad

    系統會顯示下列訊息:

    ent10 available
  7. 若要建立虛擬目標裝置,以對映實體磁區 hdisk6(PPRC 配對的一部分,作為 vhost2 虛擬伺服器配接卡所提供用戶端分割區的虛擬磁碟) ,請鍵入下列指令:
    mkvdev -vdev hdisk6 -vadapter vhost2 -attr mirrored=true
  8. 若要在建立共用乙太網路配接卡時移轉及還原乙太網路介面,請如下所示鍵入指令:
    mkvdev -sea ent4 -vadapter ent6 -default ent6 -defaultid 1 -attr ha_mode=auto 
    ctl_chan=ent5 -migrate -auto