chsystem

使用 chsystem 指令,來修改現有叢集系統(系統)的屬性。在建立系統之後,隨時可以輸入這個指令。與這個指令相關聯的所有參數都是選用的。 不過,在這個指令中,您必須指定一或多個參數。

語法

讀取語法圖表略過語法圖表
>>- chsystem -- --+------------------------+-- ----------------->
                  '- -name -- system_name -'      

>--+-----------------------------------+-- -- ------------------>
   '- -rcbuffersize -- new_size_in_MB -'         

>--+----------------------+-- ---------------------------------->
   '- -alias -- id_alias -'      

>--+--------------------------------------+-- ------------------>
   '- -icatip -- icat_console_ip_address -'      

>--+---------------------------------+-- ----------------------->
   '- -invemailinterval -- interval -'      

>--+--------------------------------------+-- ------------------>
   '- -gmlinktolerance -- link_tolerance -'      

>--+-------------------------------------+-- ------------------->
   '- -gmmaxhostdelay -- max_host_delay -'      

>--+-----------------------------------+-- --------------------->
   '- -icatip -- ipv4_icat_ip_address -'      

>--+-------------------------------------+-- ------------------->
   '- -icatip_6 -- ipv6_icat_ip_address -'      

>--+---------------------------------+-- ----------------------->
   '- -ntpip -- ipv4_ntp_ip_address -'      

>--+-----------------------------------+-- --------------------->
   '- -ntpip_6 -- ipv6_ntp_ip_address -'      

>--+---------------------------------+-- ----------------------->
   '- -isnsip -- sns_server_address -'      

>--+----------------------------------------+-- ---------------->
   '- -isnsip_6 -- ipv6_sns_server_address -'      

>--+----------------------------------------------------+-- ---->
   '- -relationshipbandwidthlimit -- bandwidth_in_mBps -'      

>--+-------------------------+-- ------------------------------->
   '- -infocenterurl -- url -'      

>--+----------------------------------------------------------+-->
   '- -iscsiauthmethod--+-none------------------------------+-'   
                        '-chap-- -chapsecret-- chap_secret -'     

>--+--------------------------------------------------------+--->
   '- -rcauthmethod --+-none------------------------------+-'   
                      '-chap-- -chapsecret-- chap_secret -'     

>--+-----------------------------+-- --------------------------->
   +- -chapsecret-- chap_secret -+      
   '- -nochapsecret--------------'      

>--+------------------------------------------+-- -- ----------->
   '- -iscsiusername----用於雙向鑑別的 iscsi 使用者名稱---'         

>--+-----------------------------+-- -- ------------------------>
   '- -cacheprefetch --+- on --+-'         
                       '- off -'           

>--+-------------------------------+-- ------------------------->
   '- -localfcportmask --port_mask-'      

>--+---------------------------------+-- -- -- ----------------->
   '- -partnerfcportmask --port_mask-'            

>--+--------------------------------------------+-- ------------>
   '- -vdiskprotectiontime -- value_in_minutes -'      

>--+--------------------------------------+-- ------------------>
   '- -vdiskprotectionenabled --+- yes -+-'      
                                '- no --'        

>--+-------------------+-- ------------------------------------->
   '- -odx --+- on --+-'      
             '- off -'        

>--+------------------------------------+-- -------------------->
   '- -easytieracceleration --+- on --+-'      
                              '- off -'        

>--+--------------------------------------------+-- ------------>
   '- -maxreplicationdelay -- value_in_seconds -'      

>--+------------------------------------------------------+----->
   '- -partnershipexclusionthreshold -- value_in_seconds -'   

>-- -- --+-------------------------------+---------------------->
         '- -ibmcustomer -- customer_id -'   

>--+---------------------------------+-------------------------->
   '- -ibmcomponent -- component_id -'   

>--+-----------------------------+-- --------------------------->
   '- -ibmcountry -- country_id -'      

>--+--------------------------------+-- ------------------------>
   '- -enhancedcallhome --+- on --+-'      
                          '- off -'        

>--+------------------------------+-- -------------------------->
   '- -censorcallhome --+- on --+-'      
                        '- off -'        

>--+---------------------+-------------------------------------><
   '- -unmap --+- on --+-'   
               '- off -'     

參數

-name system_name
(選用)指定系統的新名稱。
重要: 每個節點的「網際網路小型電腦系統介面 (iSCSI) 完整名稱 (IQN)」,都是利用系統和節點名稱來產生的。如果您是使用 iSCSI 通訊協定,則變更任一名稱也會變更系統中所有節點的 IQN,而且可能需要重新配置所有 iSCSI 連接的主機。
-rcbuffersize new_size_in_MB
(選用)以 MB 為單位來指定要在每一個節點上用於 Metro Mirror 和 Global Mirror 通訊的記憶體數量,從 48 到 512 MB。預設值是 48 MB。
重要: 請只在您的支援團隊指示時,才調整這項設定。

系統中的所有節點都必須處於線上,且至少有 8 GB 或 8192 MB 的記憶體,以變更這項設定。

記住:
  • 在變更這項設定之前,您必須先停止與這個系統的所有夥伴關係。
  • 這個參數只能在本端系統上運作,如果變更,將會干擾鏡映作業。
-alias id_alias
(選用)指定替代名稱,這個名稱不會變更系統的基本 ID,但確實會影響每一個 vdiskhostmap(現有及新建的)之 VDisk_UID。會針對其 ID 符合別名的系統建立這些物件。因此,變更系統別名會導致失去主機系統的存取,直到每一個主機掃描到系統所呈現的磁區。
-invemailinterval interval
(選用)指定庫存電子郵件傳送給所指定之電子郵件收件者的間隔。間隔範圍是 015。間隔是以天來測量。 將這個值設為 0 時會關閉庫存電子郵件通知功能。
-gmlinktolerance link_tolerance
(選用)指定 Global Mirror 作業容許不適當跨系統鏈結的時間長度(秒)。此參數接受 2086400 秒的值,每一級 10 秒。預設值是 300 秒。您可以對這個參數輸入 0 值,以停用鏈結容錯。
-gmmaxhostdelay max_host_delay
(選用)指定延遲上限(毫秒),到達此上限時 Global Mirror 鏈結容錯計時器就會開始倒數。這個臨界值決定 Global Mirror 作業,對 Global Mirror 來源磁區回應時間所增加的其他影響。您可以使用這個參數從預設值 5 毫秒增加臨界值。
-icatip icat_console_ip_address
(選用)指定系統所使用的系統新 IPv4 位址。這個 IP 位址的格式必須是包含埠的帶點十進位表示法;例如 255.255.255.255:8080。如果您指定這個參數,它將會改寫任何現有的 -icatip_6 位址。
-icatip_6 icat_console_ipv6_address
(選用)指定系統新的 IPv6 位址。如果您指定這個參數,它將會改寫任何現有的 -icatip 位址。IPv6 位址格式必須是:
  • 八組以冒號隔開的四個十六進位數字;例如:
    [1234:1234:abcd:0123:0000:0000:7689:6576]:23
  • 八組以冒號隔開的十六進位數字,並省略前導零;例如:
    [1234:1234:abcd:123:0:0:7689:6576]:23
  • 抑制一或多個連續全部為 0 的群組;例如:
    [1234:1234:abcd:123::7689:6576]:23
-ntpip ipv4_ntp_ip_address
(選用)指定「網路時間通訊協定 (NTP)」伺服器的 IPv4 位址。配置 NTP 伺服器位址,會導致系統使用該 NTP 伺服器作為其時間來源。指定 -ntpip 參數(位址為零),可使用另一個時間來源:
chsystem -ntpip 0.0.0.0
-ntpip_6 ipv6_ntp_ip_address
註: 在您指定 -ntpip_6 之前,必須為系統設定 IPv6 字首和閘道。
(選用)指定 NTP 伺服器的 IPv6 位址。 配置 NTP 伺服器位址,會導致系統立即開始使用該 NTP 伺服器作為其時間來源。如果要選擇另一個時間來源,請指定 -ntpip_6 參數(位址為零),如下所示:
chsystem -ntpip_6 0::0
-isnsip sns_server_address
(選用)指定 iSCSI 儲存體名稱服務 (SNS) 的 IPv4 位址。指定 -isnsip 參數(位址為零),可選取另一個 IPv4 iSCSI SNS 伺服器:
chsystem -isnsip 0.0.0.0
-isnsip_6 ipv6_sns_server_address
(選用)指定 iSCSI SNS 的 IPv6 位址。指定 -isnsip_6 參數(位址為零),可選取另一個已配置的 IPv6 iSCSI SNS 伺服器:
chsystem -isnsip_6 0::0
-relationshipbandwidthlimit bandwidth_in_mBps
(選用)以每秒百萬位元組 (MBps) 指定新的背景複製頻寬,值為 11000。預設值為 25 MBps。
重要: 對於透過 IP 鏈結而建立的夥伴關係(有壓縮),此參數指定將壓縮套用至該資料之後的聚集頻寬。此參數請勿設定為高於實體鏈結頻寬乘以壓縮因數(審慎地無條件捨去)。
這個參數會在系統層面操作,且會定義任何關係可以採用的背景複製頻寬上限。定義於夥伴關係的現有背景複製頻寬設定,會嘗試以夥伴關係速率和磁區速率的較低者繼續運作。
註: 如果未建立可承擔的較高頻寬,請勿將這個值設為高於預設值。
-infocenterurl url
指定偏好的線上文件 URL 來置換 GUI 所用的 URL。因為這項資訊是由網際網路瀏覽器所解譯,因此指定的資訊可能包含主機名稱或 IP 位址。
記住: 在 GUI 喜好設定視窗中檢視目前配置的 URL。這個視窗也可協助將此值重設為預設值。
-iscsiauthmethod none | chap -chapsecretchap_secret
(選用)為系統的 iSCSI 通訊設定鑑別方法:
  • chap 表示開啟「網際網路小型電腦系統介面 (iSCSI)」鑑別。
    記住: 當系統已設定「盤查信號交換驗證通訊協定 (CHAP)」秘密金鑰時,這會開啟 iSCSI 夥伴關係鑑別。
  • none 表示關閉 iSCSI 夥伴關係鑑別。
-rcauthmethod none | chap -chapsecretchap_secret
(選用)針對作為原生 IP 夥伴關係的遠端副本夥伴關係要求,開啟或關閉鑑別。此外:
  • chap 表示開啟遠端副本鑑別。
    記住: 當系統已設定「盤查信號交換驗證通訊協定 (CHAP)」秘密金鑰時,這個動作會開啟遠端副本夥伴關係要求的鑑別。
  • none 表示關閉遠端副本夥伴關係鑑別。
-chapsecretchap_secret
(選用)設定在鑑別使用 iSCSI 的系統時,將會使用的 CHAP 密碼。如果指定 iscsiauthmethod chap 參數,則這個參數是必要的。指定的 CHAP 密碼不能以空格開頭或結尾。
-nochapsecret
(選用)清除任何先前對 iSCSI 鑑別設定的 CHAP 密碼。指定 chapsecret 時,不能同時指定 nochapsecret 參數。
-iscsiusername
(選用)指定整個 SVC 系統的使用者名稱,用於 iSCSI 主機連接登入的雙向鑑別。如果指定這個參數,這個值會作為 iSCSI 主機連接登入時用於雙向鑑別的「使用者名稱」。如果未指定使用者名稱,則雙向 CHAP 鑑別的使用者名稱為 NULL。
-cacheprefetch on | off
(選用)指出啟用或停用整個系統的快取預先提取功能。請只在遵循產品支援資訊的指示時,才調整此項目。
-localfcportmask port_mask
(選用)指出只用於本端系統節點對節點通訊的「光纖通道 (FC)」輸入/輸出 (I/O) 埠遮罩。「光纖通道」埠遮罩不會影響主機或儲存體系統傳輸。埠遮罩是 64 二進位位元,由 0 和 1 的組合所組成,0 表示對應的 FC I/O 埠無法使用,1 表示可以使用。遮罩會套用到本端系統的所有節點。對於本端系統節點對節點通訊,必須至少選取兩個埠。 遮罩必須在本端系統的每一個節點之間產生至少 2 個 FC 連線,而且是只使用選取的埠和這些埠可見的 FC 區域。有效的遮罩值範圍是從 0011(僅啟用埠 1 和 2)到 1111111111111111111111111111111111111111111111111111111111111111(已啟用所有的埠)。例如,遮罩為 111111101101,表示啟用埠 1、3、4、6、7、8、9、10、11 和 12。
記住: 部分遮罩(少於 64 個字元)是零延伸的,表示不會啟用任何未指定的埠。
請指定 lsportfc 指令來顯示 FC I/O 埠 ID。
-partnerfcportmask port_mask
(選用)指出只用於夥伴系統對系統通訊的 FC I/O 埠遮罩。「光纖通道」埠遮罩不會影響主機或儲存體系統傳輸。埠遮罩是 64 二進位位元,由 0 和 1 的組合所組成,0 表示對應的 FC I/O 埠無法使用,1 表示可以使用。遮罩會套用到本端系統的所有節點。有效的遮罩值範圍可從 0000(未啟用任何埠)到 1111111111111111111111111111111111111111111111111111111111111111(啟用所有的埠)。例如,遮罩為 111111101101,表示啟用埠 1、3、4、6、7、8、9、10、11 和 12。
記住: 部分遮罩(少於 64 個字元)是零延伸的,表示不會啟用任何未指定的埠。
請指定 lsportfc 指令來顯示 FC I/O 埠 ID。
-vdiskprotectiontime value_in_minutes
(選用)設定磁區保護時間(分鐘)。
-vdiskprotectionenabled yes | no
(選用)啟用或停用磁區保護。值為 yesno
-odx on | off
(選用)啟用或停用卸載資料傳送 (ODX)。值為 onoff
-easytieracceleration on | off
(選用)啟用 Easy Tier® 和儲存區平衡加速。值為 onoff
-maxreplicationdelay value_in_seconds
(選用)設定抄寫延遲上限(秒)。值必須是 0360 之間的數字。
-partnershipexclusionthreshold value_in_seconds
(選用)設定遠端系統 I/O 作業的逾時值(秒)。這個值必須是 30315(預設值)之間的數字。
-ibmcustomer customer_id
(選用)指定軟體授權自動新增至授權資料庫時所指派的客戶編號。值必須是包含 7-10 位數的數字(或空白)。
-ibmcomponent component_id
(選用)指定用於授權和 Call Home 系統的元件 ID。值是空白或 SANVCNSW1
-ibmcountry country_id
(選用)指定用於授權和 Call Home 系統的國家 ID。值是空白或 3 位數的數字。
-enhancedcallhome on | off
(選用)指定 Call Home 功能會將加強型報告傳送到支援中心。有效值為 yesno

加強型報告包含作業資料和事件相關資料,以及庫存報告中包含的特定配置資訊。此功能會向支援中心警示有硬體故障,以及可能有嚴重的配置或環境問題。支援中心可以使用配置資訊,以根據您實際的配置,自動產生最佳作法或建議。

-censorcallhome on | off
(選用)指定從加強的 Call Home 資料中刪除機密資料。值為 yesno
-unmap on | off
(選用)指定系統管理者是否啟用「小型電腦系統介面 (SCSI)」取消對映特性。值為 on(預設值)或 off

說明

這個指令會修改系統的特定特性。您可以發出單一指令來變更多個特性。

使用 -ntpip-ntpip_6 參數,可讓系統使用 NTP 伺服器作為外部時間來源。系統會根據 NTP 伺服器的時間值來調整配置節點的系統時鐘。 其他節點的時鐘會根據配置節點的時鐘來更新。在 NTP 模式下,會停用 setsystemtime 指令。

所有指令參數都是選用的,不過,您必須至少指定一個參數。

使用 chsystemip 指令,可修改系統 IP 位址和服務 IP 位址。

記住: 設定系統的 CHAP 秘密金鑰,並不會開啟 iSCSI 主機或遠端副本夥伴關係的鑑別。發出 -iscsiauthmethod-rciauthmethod,可關閉鑑別。

呼叫範例

chsystem -ntpip 9.20.165.16

結果輸出:

No feedback

呼叫範例:設定外部 NTP 伺服器

chsystem -ntpip 123.234.123.234 

結果輸出:

No feedback

呼叫範例:變更偏好 infocenterurl

chsystem -infocenterurl http://miscserver.company.com/ibm/infocenter

結果輸出:

No feedback

呼叫範例:變更本端埠遮罩值

如果要將本端遮罩設為 62 個 0 和兩個 1,指出 ID 為 1 和 2 的 FC I/O 埠都能夠進行本端節點通訊:

chsystem -localfcportmask 11

結果輸出:

No feedback

呼叫範例:變更夥伴埠遮罩值

如果要將夥伴遮罩設為 63 個 0 和一個 1,指出 ID 為 2 的 FC I/O 埠能夠進行遠端節點通訊:

svctask chsystem -partnerfcportmask 0010

結果輸出:

No feedback

呼叫範例:設定系統拓蹼

chsystem -topology standard

結果輸出:

No feedback

呼叫範例:設定遠端副本鑑別

chsystem -chapsecret ABCB1234 -iscsiauthmethod none -rcauthmethod chap

結果輸出:

No feedback

呼叫範例:關閉磁區保護

chsystem -vdiskprotectionenabled no

結果輸出:

No feedback

呼叫範例:開啟磁區保護並設定保護時間為 60 分鐘

chsystem -vdiskprotectionenabled yes -vdiskprotectiontime 60

結果輸出:

No feedback

呼叫範例:開啟 Easy Tier 加速

chsystem -easytieracceleration on

結果輸出:

No feedback

呼叫範例:開啟 ODX

chsystem -odx on

結果輸出:

No feedback

呼叫範例:設定抄寫延遲上限

chsystem -maxreplicationdelay 100

結果輸出:

No feedback

呼叫範例:設定夥伴關係排除臨界值

chsystem -partnershipexclusionthreshold 120

結果輸出:

No feedback

呼叫範例:指定 IBM 客戶 ID、元件 ID 和國家 ID

chsystem -ibmcustomer 1928374 -ibmcomponent SANVCNSW1 -ibmcountry 001

結果輸出:

No feedback

關閉加強型 Call Home 的呼叫範例

chsystem -enhancedcallhome off

結果輸出:

No feedback

開啟審查 Call Home 的呼叫範例

chsystem -censorcallhome on 

結果輸出:

No feedback