modifySIBus 指令
請利用 modifySIBus 指令來修改服務整合匯流排的內容。
如果要執行這個指令,請使用 wsadmin Scripting 用戶端的 AdminTask 物件。
從 Qshell 執行 wsadmin Scripting 用戶端。
服務整合匯流排指令有指令行說明:
- 如需 Jython 中可用的服務整合匯流排指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('SIBAdminCommands')
- 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('command_name')
使用指令之後,請利用下列指令,儲存對主要配置所做的變更:
AdminConfig.save()
用途
這個指令會修改服務整合匯流排的內容。
目標物件
一輛巴士
必要參數
- -bus 匯流排名稱
- 用來識別服務整合匯流排的名稱。 您可以使用 listSIBuses 指令來列出現有匯流排的名稱。
條件式參數
無。
選用參數
- -description 文字
- 匯流排的選用說明(基於管理用途)。
- -secure TRUE | FALSE
- 此版本已淘汰此參數。
- -mediationsAuthAlias 名稱
- 用來授權調解存取匯流排之鑑別別名的名稱。
- -securityGroupCacheTimeout timeout_value
- 將快取安全群組的時間長度(分鐘)。 timeout_value 可以在 0 到 99999的範圍內。 預設值為 120。
增加逾時值會減少使用者登錄負載,可以改進效能,但對於使用者群組成員資格的變更,系統的回應性比較差。 若要將群組快取調整為最佳設定,您需要平衡回應性與登錄負載的需求。 例如,如果系統必須快速回應使用者群組成員資格中的變更,請指定逾時 15 分鐘。 如果系統回應頻率較低 (例如為了回應夜間變更) ,請指定逾時 1440 分鐘 (24 小時)。 如果設定為 0,則快取中的項目不會逾時,因此會保留到下次重新啟動伺服器為止。
變更這個值會立即生效,只會影響已變更配置之匯流排的群組快取。
- -protocol 通訊協定
- 這個匯流排中的傳訊引擎之間進行通訊所用的傳輸鏈。
- -discardOnDelete TRUE | FALSE
- 如果可以捨棄已刪除訊息點上的訊息,請將此選項設為 TRUE 。 如果已刪除訊息點上的訊息應該保留在系統異常狀況目的地,請將此選項設為 FALSE 。
- -busSecurity TRUE | FALSE
- 將此選項設為 TRUE ,以施行匯流排的授權原則,這也需要啟用管理安全。 如果您一律要停用匯流排安全,請將此選項設為 FALSE 。 如果已停用管理安全,則匯流排不安全。
- -permittedChains ALL | SSL_ENABLED | LISTED
- 設定三個選項之一,以施行匯流排的傳輸原則。
- 全部
- 容許使用所有已定義的傳輸通道鏈。
- ssl_enabled
- 將已定義傳輸通道鏈的使用限制為 SSL 所保護的那些傳輸通道鏈。
- 已列出
- 將使用已定義的傳輸通道鏈限制為受保護傳輸的清單。
- -bootstrapPolicy SIBSERVICE_ENABLED | MEMBERS_AND_NOMINATED | MEMBERS_ONLY
- 設定三個選項之一,以施行匯流排成員原則。
- SIBSERVICE_ENABLED
- Cell 中已啟用 SIB 服務的任何伺服器都可以處理引導要求。
- MEMBERS_AND_NOMINATED
- 只有匯流排成員或指定的引導伺服器可以處理引導要求。
- 僅成員
- 只有匯流排成員可以處理引導要求。
- -useServerIdForMediations TRUE | FALSE
- 如果您要使用匯流排的單一伺服器身分來執行調解,請將此選項設為 TRUE 。 這個選項可讓您在多個安全網域之間執行調解,而不需要指定每一個網域的調解鑑別別名。 在廣域網域上,您可以利用伺服器身分來執行調解。 如果您要使用調解鑑別別名來執行調解,請將此選項設為 FALSE 。
- -auditAllowed TRUE | FALSE
- 將此選項設為 TRUE ,以啟用匯流排的安全審核。 將此選項設為 FALSE 以停用匯流排的安全審核。 預設值為 true。 您必須具有「審核管理者」專用權才能使用此參數。
範例
AdminTask.modifySIBus('[-bus bus1 -description [A new description of the bus]]')
'bus1(cells/cell01/buses/bus1|sib-bus.xml)'