WebSphere Extended Deployment V6.0.x     操作系统:

使用 Script 來管理工作類別

workclassoperations.py Script 可用來管理工作類別。

用法

以下是 Script 的用法。
 用法:wsadmin
	[-lang jython]                            
	[-f workclassoperations.py]                            
	[-odrname odrName]                            
	[-odrnode odrNode]                            
	[-wcname workClassName]                            
	[-appname appName]                            
	[-webmodule webModule]                            
	[-adduri ["uri1?uri2?..."]]                            
	[-type HTTP|SOAP]                            
	[-vhost virtualHost]                            
	[-wctype APP|GSC|ARP|ASP|GRP|GSP]                            
	[-addrule ["priority?expr?actiontype?action"]]                            
	[-deleterule [priority]]                            
	[-deleteuri ["uri1?uri2?..."]]                            
	[-deletewc]                            
	[-listrule]                            
	[-listuri]                           
	[-setdefaultaction ["actiontype?action"]]                 
      	[-modifydefaultaction ["actiontype?action"]]                  
      	[-getdefaultaction]                                               
      	[-both]                                                      

指令行選項

新增或定義所建立工作類別的規則。
使用 -addrule 指令行選項。在相同的指令呼叫中,這個選項不能搭配 -deleterule-listrule-getdefaultaction 選項使用。如果您要一次新增多項規則, 請按照優先順序(號碼由小到大)依序列出。
  • 'priority' 為指派給所要建立之規則的優先順序。Priority 是一個整數值,例如 0、1、2、3 等;0 代表最高優先順序。
  • 問號 (?) 為分隔字元,在這個順序中必須用到它。
  • 'expr' 為規則表示式。如需相關資訊,請參閱工作類別的遞送原則
  • 'actiontype' 為所要採取的動作類型,含有遞送原則的列舉值(可以是 permitpermitstickyrejectredirect)。如果您要建立的是服務原則的工作類別, 則 actiontype 為交易類別的名稱。
  • 'action' 的值取決於 actiontype 而定。比方說,如果 actiontype 為 'redirect',則 action 會是重新導向 URL。例如 redirect?http://www.ibm.com。如果 actiontype 為 reject, 則 action 會是一個拒絕碼。例如 reject?404。若為通用伺服器叢集的工作類別, 則 action 會是通用伺服器叢集的名稱。
指定企業應用程式的名稱
-appname appName 指令行選項用以指定不含 .ear 副檔名的企業應用程式名稱。
提供 URI 型樣集合,以便和企業應用程式的工作類別 Web 模組產生關聯。
-adduri 指令行選項用以提供 URI 型樣集合, 以便和企業應用程式的工作類別 Web 模組產生關聯。各個 URI 型樣間是以問號 (?) 隔開, 且每一個 URI 型樣必須以正斜線 (/) 為開頭。
指出遞送和服務原則要套用的作業
-both 指令行選項用以指出給定工作類別名稱中的遞送和服務原則兩者, 皆應套用 -listrule 或 -getdefaultaction 作業。
刪除特定規則
-deleterule 指令行選項用以將特定規則從使用 -wcname 選項指定的工作類別中刪除。在相同的指令呼叫中, 這個選項不能搭配 -addrule-listrule-getdefaultaction 選項使用。
將 URI 型樣集合從 Web 模組工作類別中刪除
-deleteuri 指令行選項用以提供 URI 型樣集合, 以便從 Web 模組工作類別中刪除。這個選項僅適用於企業應用程式的工作類別。
顯示工作類別之 Web 模組元素中的 URI
-listuri 指令行選項用以顯示工作類別之 Web 模組元素中的 URI。這個選項僅適用於企業應用程式的工作類別。
刪除工作類別
-deletewc 指令行選項用以刪除工作類別。當使用這個選項時, 您也必須指定其值為 ARP(應用程式遞送原則)、ASP(應用程式服務原則)、 GRP(通用遞送原則)或 GSP(通用伺服器原則)的 -wctype 指令行選項。
取得已定義之工作類別中的預設動作類型和動作
-getdefaultaction 指令行選項用以取得已定義在工作類別(以 -wcname 選項來指定) 中的預設 actiontype 和 action。在相同的指令呼叫中, 這個指令行選項不能搭配 -addrule-delete-listrule 選項使用。
顯示定義在工作類別中的規則
-listrule 指令行選項用以顯示定義在工作類別中的規則。在相同的指令呼叫中, 這個選項不能搭配 -addrule-deleterule-getdefaultaction 選項使用。
修改工作類別的預設動作
-modifydefaultaction 用以修改現有工作類別(利用 -wcname 選項來指定, 並且有指定 actiontype 和 action)的預設動作。
指定「隨需應變路由器 (ODR)」Proxy 伺服器的名稱
-odrname odrName 指令行選項用以指定「隨需應變路由器 (ODR)」Proxy 伺服器的名稱。
指定 ODR 節點的名稱
-odrnode odrNode 指令行選項用以指定 ODR 節點的名稱。
指定預設動作
-setdefaultaction 選項搭配指定的 actiontype 和 action 時, 可建立一項採用表示式(以星號 * 表示)的規則, 並將動作類型和動作設為選項所提供的值。
指定要求類型
-type 選項用以指定這項工作類別所要套用的通訊協定。有效值為 HTTP 和 SOAP。如果沒有指定 -type 選項, 則會假設為預設值 HTTP。
指定通用伺服器叢集的虛擬主機名稱
-vhost virtualHost 選項用以指定通用伺服器叢集的虛擬主機名稱。
指定 Web 模組的名稱
-webmodule webModule 選項用以指定不含 .war 副檔名的 Web 模組名稱。
指定工作類別的名稱
使用 -wcname workClassName 選項用以指定工作類別的名稱。工作類別名稱中不容許空格。這個選項恆為必要的。
指定工作類別類型
當建立工作類別時,-wctype 選項會採用常數值 APP(代表企業應用程式)或 GSC(代表通用伺服器叢集), 這是因為會使用預設動作類型 actiontype 來作為遞送和服務原則工作類別間的區分。在區分不明顯的作業中, 則會使用 ARPASPGRPGSP。若有指定 -deletewc 選項, 則有效值為 ARP(刪除「應用程式遞送」工作類別)、ASP(刪除「應用程式服務原則」工作類別)、 GRP(刪除「通用伺服器叢集遞送原則」工作類別), 以及 GSP(刪除「通用伺服器服務原則」工作類別)。由於沒有預設值,您必須指定一值。

示例

以下是一些範例:
my_App 應用程式建立一個名為 my_Work_Class 的遞送原則工作類別。工作類別將套用在其型樣為 my_Web_Module Web 模組中之 /test1/test2/* 的所有 URI 上, 且這個工作類別含有單一規則,而允許 ibm.com 網域所發的要求。預設動作是拒絕其他所有的要求, 並產生錯誤碼 404。
wsadmin -lang jython -f workclassoperations.py -appname my_App -wcname my_Work_Class -type HTTP -wctype APP -webmodule my_Web_Module -adduri "/test1?/test2/*" -addrule "1?clienthost LIKE '%.ibm.com'?permit:my_App" -setdefaultaction "reject?404"
為遞送原則建立一個企業應用程式工作類別。其預設動作是 reject,並產生拒絕碼 404。如果是在 UNIX 基本作業系統上發出此指令, 則應將 ESC 序列 (\%%) 換成 (\%)。
wsadmin -lang jython -f workclassoperations.py -appname A -wcname CustomWorkClass
-type HTTP -wctype APP -webmodule myWebModule -adduri "/test1?/test2/*" -addrule
"1?clienthost=\'localhost\' and serverhost like \'\%%.ibm.com\'?permit" -setdefaultaction
"reject?404"    
為服務原則建立一個企業應用程式工作類別。如果是在 UNIX 基本作業系統上發出此指令, 則應將 ESC 序列 (\%%) 換成 (\%)。
wsadmin -lang jython -f workclassoperations.py -appname A -wcname Custom2WorkClass
-type HTTP -wctype APP -webmodule myWebModule -setdefaultaction "Default_TC"
-adduri "/test1?/test2/*" -addrule "1?clienthost=\'localhost\' and serverhost
like \'\%%.ibm.com\'?Default_TC" 
為遞送原則建立工作類別,並使用預設類型 HTTP。其預設動作類型為 permit, 且動作是要求所送往的通用伺服器叢集名稱。
wsadmin -lang jython -f workclassoperations.py -odrname ODR -ordnode myNode01
-wcname GSCWorkClass  -vhost default_host -wctype GSC -setdefaultaction "permit?myGSC" 
為服務原則建立工作類別,並使用預設類型 HTTP。如果是在 UNIX 基本作業系統上發出此指令, 則應將 ESC 序列 (\%%) 換成 (\%)。
wsadmin -lang jython -f workclassoperations.py -odrname ODR -ordnode myNode01
-wcname GSCWorkClass -vhost default_host -wctype GSC -addrule "1?serverhost=\'localhost\'
and serverhost like \'\%%.ibm.com\'?TransactionClassA" -setdefaultaction "TransactionClassB"
刪除遞送原則之工作類別 CustomWorkClass 中優先順序 1 的規則。
wsadmin -lang jython -f workclassoperations.py -deleterule 1 -wcname CustomWorkClass
 -appname A -wctype ARP"    
針對企業應用程式 A,列出其遞送和服務原則兩者(-both 選項)之工作類別 CustomWorkClass 中的規則。
wsadmin -lang jython -f workclassoperations.py -listrule -wcname CustomWorkClass
-both -appname A -wctype APP"    
針對通用伺服器叢集,列出其遞送和服務原則兩者(-both 選項)之工作類別 CustomWorkClass 中的規則。
wsadmin -lang jython -f workclassoperations.py -listrule -wcname CustomWorkClass
-both -odrname ODR -odrnode theTestNode01 -wctype GSC"    
取得遞送和服務原則兩者(-both 選項)之工作類別 CustomWorkClass 中的預設動作。
wsadmin -lang jython -f workclassoperations.py -getdefaultaction -wcname CustomWorkClass
-both -appname A -wctype APP"     
刪除企業應用程式 A 下的遞送原則工作類別 CustomWorkClass。
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-appname A -wctype ARP"    
刪除企業應用程式 A 版本下的服務原則工作類別 CustomWorkClass。
 wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-appname A -wctype ASP" 
刪除名稱為 myODR 之 ODR 下的服務原則工作類別 CustomWorkClass。
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-odrname myODR -wctype GSP"   
刪除名稱為 myODR 之 ODR 下的遞送原則工作類別 CustomWorkClass。
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-odrname myODR -wctype GRP"    
針對應用程式 A 和 Web 模組 microwebapp,列出工作類別 CustomWorkClass 中的 URI。
wsadmin -lang jython -f workclassoperations.py -listuri -wcname CustomWorkClass
-appname A -webmodule microwebapp"    
針對應用程式 A 和 Web 模組 microwebapp,刪除工作類別 CustomWorkClass 中的 URI。請使用 -wctype ARP 或 ASP, 以作為遞送和服務原則工作類別間的區分。如果沒有使用 -wctype, 則會採用遞送原則工作類別。
wsadmin -lang jython -f workclassoperations.py -deleteuri "/myURI/help.jsp"
-wcname CustomWorkClass -appname A -webmodule microwebapp"    
為遞送原則建立企業應用程式工作類別,並使用額外的兩項規則和預設值。如果是在 UNIX 基本作業系統上發出此指令, 則應將 ESC 序列 (\%%) 換成 (\%)。
wsadmin -lang jython -f workclassoperations.py -appname A -webmodule microwebapp
-wcname Custom2WorkClass -wctype APP -type HTTP -adduri "/test1?/test2/*"
-setdefaultaction "redirect?http://www.ibm.com" -addrule "1?clienthost=\'localhost\'
and serverhost like \'\%%.ibm.com\'?permit?A"  -addrule "2?protocol IN (\'HTTP\',\'HTTPS\')?permitsticky?A" 
針對應用程式 A 和 Web 模組 microwebapp,新增 URI 到現有工作類別 CustomWorkClass 中。
wsadmin -lang jython -f workclassoperations.py -adduri "/myURI/help.jsp" -wcname
CustomWorkClass -appname A -webmodule microwebapp -wctype ARP"  
為遞送原則建立企業應用程式 SOAP 工作類別。其預設動作是 reject,並產生拒絕碼 404。如果是在 UNIX 基本作業系統上發出此指令, 則應將 ESC 序列 (\%%) 換成 (\%)。
wsadmin -lang jython -f workclassoperations.py -appname A -wcname CustomWorkClass -type 
SOAP -wctype APP -webmodule myWebModule -adduri "RemoteTest:addJob?RemoteTest:removeJob" 
-addrule "1?clienthost=\'localhost\' and serverhost like \'\%%.ibm.com\'?permit" 
-setdefaultaction "reject?404"



参考主题    

使用条款 | 反馈

最近更新日期: Aug 14, 2006 2:00:44 PM EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=/com.ibm.websphere.xd.doc/info/odoe_task/rodwcscript.html

© Copyright IBM Corp. 2005, 2006. All Rights Reserved.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)