WebSphere Application Server 提供了一個名為 wsadmin 的命令行管理工具,可以使用它以交互方式或通過使用Jacl 腳本或者Jython腳本來運行管理命令。 這種腳本非圖形的備用方法,可以用來配置和管理 WebSphere? Application Server。WebSphere Application Server wsadmin 工具提供運行腳本的能力。wsadmin 工具支持整個范圍的產(chǎn)品管理活動。 wsadmin 工具支持兩種腳本語言:Jacl 和 Jython。當您使用腳本時,有五個對象可用:
要使用腳本執(zhí)行任務(wù),您必須首先執(zhí)行以下步驟:
運行 wsadmin 工具. 此主題描述如何啟動交互式 wsadmin 會話和調(diào)用 wsadmin 命令的其它方法??梢允褂媒换ナ?wsadmin 會話輸入 wsadmin 命令來管理 WebSphere Application Server 的實例。 腳本編制對象 命令行管理客戶機提供了四個可以在腳本中使用的對象:AdminApp、AdminControl、AdminConfig 和 Help。此主題提供關(guān)于其中每個對象的信息。 wsadmin 的 Java 屬性 wsadmin 使用的 Java 屬性存儲在 wsadmin.properties 文件中。此主題描述這些屬性。 運行 wsadmin 工具 此主題描述如何啟動與停止交互式 wsadmin 會話和調(diào)用 wsadmin 命令的其它方法。 交互式會話是個外殼程序環(huán)境,在此環(huán)境中可以運行 wsadmin 命令和腳本。 啟動 wsadmin 停止 wsadmin 也可以運行單一命令或腳本文件而不啟動交互式會話,或在交互式會話啟動之前運行概要文件中的命令??梢哉{(diào)用 wsadmin 命令的其它方法如下: 單獨運行 wsadmin 命令 運行腳本中的 wsadmin 命令 運行概要文件中的 wsadmin 命令 啟動 wsadmin 要啟動交互式 wsadmin 會話,執(zhí)行以下步驟: 1.在 Windows 命令行上使用 cd 命令進入產(chǎn)品安裝根目錄的 bin 目錄: cd websphere\appserver\bin 2.在 cmd提示符下輸入以下命令: wsadmin -instance instance 其中 instance 是要管理的實例的名稱。 在退出交互式會話之前,運行以下命令來保存配置更改: wsadmin> $AdminConfig save 如果不運行此命令,當退出交互式會話時,wsadmin 將廢棄更改。 停止 wsadmin 要退出 wsadmin,在 wsadmin 提示符下輸入以下命令: wsadmin> exit/quit 單獨運行 wsadmin 命令 要單獨運行命令,當運行 wsadmin 命令時指定 -c 選項。 wsadmin -instance instance -c '$AdminApp list' WASX7209I: Connected to process "server" on node node using SOAP connector; The type of process is: UnManagedProcess adminconsole DefaultApplication ivtApp 在此示例中,instance 是 WebSphere Application Server 實例的名稱,server 是應(yīng)用程序服務(wù)器的名稱,node 是 iSeries 主機服務(wù)器的名稱: 當運行帶有 -c 參數(shù)的命令時,將自動保存配置更改。不需要運行 $AdminConfig save 命令。 運行腳本中的 wsadmin 命令 在運行腳本之后,wsadmin 返回至 Qshell 提示符。 要運行腳本中的命令,當運行 wsadmin 命令時指定 -f 選項: wsadmin -instance instance -f 'script.jacl' WASX7209I: Connected to process "server" on node node using SOAP connector; The type of process is: UnManagedProcess adminconsole DefaultApplication ivtApp 在此示例中,instance 是 WebSphere Application Server 實例的名稱,server 是應(yīng)用程序服務(wù)器的名稱,node 是實例運行所在節(jié)點的名稱,script.jacl 是包含這些命令的 Jacl 腳本的全限定路徑: set apps [$AdminApp list] puts $apps 如果運行對應(yīng)用程序服務(wù)器的配置進行更改的腳本文件,必須在腳本的末尾包括 $AdminConfig save 命令。如果不包括此命令,wsadmin 不會保存更改。 運行概要文件中的 wsadmin 命令 wsadmin 工具在運行概要文件中的命令后啟動一個交互式會話。 要運行概要文件中的命令,當運行 wsadmin 命令時指定 -profile 選項: wsadmin -instance instance -profile 'profile.jacl' WASX7209I: Connected to process "server" on node node using SOAP connector; The type of process is: UnManagedProcess Applications currently installed: adminconsole DefaultApplication ivtApp WASX7029I: For help, enter: "$Help help" wsadmin> 在此示例中,instance 是 WebSphere Application Server 實例的名稱,server 是應(yīng)用程序服務(wù)器的名稱,node 是實例運行所在節(jié)點的名稱,profile.jacl 是包含這些命令的概要文件的全限定路徑: set apps [$AdminApp list] puts "Applications currently installed:\n$apps" 語法和參數(shù) 此頁面描述 wsadmin 命令的語法和參數(shù)。 語法 wsadmin -instance instance [ -c 'command' | -f scriptfile ] [ -lang lang ] [ -p propertiesfile ] [ -profile scriptfile ] [ -conntype SOAP | RMI | JMS | NONE [ -host host ] [ -port port] ] [ -wsadmin_classpath classpath ] [ -help ] [ -? ] [ script_parameters ] 參數(shù) ·-instance 如果要使用非缺省實例,則需要此參數(shù)。如果未對此參數(shù)指定值,wsadmin 使用缺省實例。 ·-c 此可選參數(shù)指定要運行的單一命令。如果指定此參數(shù),wsadmin 運行輸入的命令,然后將控制權(quán)返回到 Qshell 提示符。要運行多個命令,可以對要運行的每個命令指定 -c 參數(shù)。將按列示命令的次序運行命令。 ·-f 此可選參數(shù)指定腳本源和要運行的腳本。如果指定此參數(shù),wsadmin 運行指定的腳本,然后返回到 Qshell 提示符。 ·-lang 因為 Jacl 是唯一支持的腳本語言,所以不需要指定此參數(shù)。 ·-p 此可選參數(shù)指定要裝入的屬性文件。在裝入用 -p 指定的任何文件之前,將裝入兩個屬性文件。 1.第一個文件是以下目錄中的 wsadmin. 屬性文件: §WebSphere Application Serve : /QIBM/UserData/WebAS5/Base/instance/properties/wsadmin.properties §WebSphere Application Server Network Deployment: /QIBM/UserData/WebAS5/ND/instance/properties/wsadmin.properties 其中 instance 為 WebSphere Application Server 實例的名稱。 2.第二個文件是 /home/QEJBSVR/wsadmin.properties。此文件未隨 WebSphere Application Server 一起交付。 可以多次指定 -p 參數(shù)。如果這樣做,將按指定的次序調(diào)用屬性文件。 ·-profile 此可選參數(shù)指定概要文件腳本。概要文件腳本在其它命令或腳本之前運行。如果指定 -c,概要文件在單一命令之前運行。如果指定-f,概要文件在腳本之前運行。如果不指定 -c 或 -f,wsadmin 運行概要文件中的命令,然后啟動交互式 wsadmin會話??梢灾付ǘ鄠€ -profile 參數(shù)。如果這樣做,將按指定的次序調(diào)用概要文件腳本。 ·-conntype 此可選參數(shù)指定用于連接至要管理的應(yīng)用程序服務(wù)器的連接類型。conntype 參數(shù)的有效值為 SOAP、RMI、JMS 和NONE。缺省值為 SOAP。(JMS 在 WebSphere Application Server的當前版本中是不受支持的連接類型。)-conntype 參數(shù)確定哪個端口(如果有的話)用于連接至服務(wù)器。如果將 conntype 參數(shù)指定為NONE ,則只有 $AdminApp 命令可用。 ·-host 此可選參數(shù)指定運行您想管理的應(yīng)用程序服務(wù)器的系統(tǒng)的主機名。如果不指定此參數(shù),則主機名缺省為 localhost。 ·-port 如果指定 -conntype 參數(shù),則可以指定用于連接至遠程應(yīng)用程序服務(wù)器的端口號。例如,如果使用 SOAP連接,則為要管理的應(yīng)用程序服務(wù)器指定 SOAP 端口。如果不指定此參數(shù),則腳本使用在實例的 wsadmin. 屬性文件中對com.ibm.ws.scripting.port 屬性指定的值(如果該屬性存在)。如果屬性在為 wsadmin腳本顯式或隱式指定的任何屬性文件中不存在,將發(fā)生錯誤。當創(chuàng)建實例時,將用實例的 SOAP 和 RMI 連接器端口更新 wsadmin.屬性文件。對于缺省 WebSphere Application Server 實例,這些端口為 8880(對于 SOAP)和 2809(對于RMI)。對于缺省 WebSphere Application Server Network Deployment 實例,這些端口為8879(對于 SOAP)和 9809(對于 RMI)。 ·-wsadmin_classpath 此可選參數(shù)使附加類可用于腳本編制進程。值 classpath 指定包含要 wsadmin訪問的類的類路徑。指定的類路徑將添加至腳本編制進程的類裝入器中。也可以在 wsadmin.properties 文件中用com.ibm.ws.scripting.classpath 屬性指定此選項。-wsadmin_classpath 參數(shù)覆蓋在wsadmin.properties 中指定的任何值。 ·-help 或 -? 提供語法幫助的可選自變量。 ·script_parameters 如果指定 -f 參數(shù)以運行腳本,則可以在 wsadmin 命令中包括該腳本的參數(shù)。 示例 下列示例演示了正確的語法。在這些示例中,mymachine 為包含 SOAP 或 RMI 連接器的服務(wù)器運行所在的主機的名稱。在 wsadmin. 屬性文件中通過 com.ibm.ws.scripting.port 指定端口。 ·與本地主機上的缺省 WebSphere Application Server 實例的 SOAP 連接 wsadmin ·與本地主機上的 WebSphere Application Server 實例 test 的 SOAP 連接 wsadmin -instance test ·使用端口 8880 與 as400 主機的 SOAP 連接 wsadmin -conntype SOAP -host as400 -port 8880 ·使用端口 2809 與 as400 主機的 RMI 連接 wsadmin -conntype RMI -host as400 -port 2809 腳本編制對象 有四個對象可以在腳本中使用: · AdminControl · AdminConfig · AdminApp · Help AdminControl 對象 可以使用 AdminControl 對象來對在 WebSphere Application Server 中運行的對象調(diào)用操作命令。 可用于 AdminControl 的方法示例包括:getAttribute、setAttribute 和 invoke。很多AdminControl 方法有多個特征符,以便可以使用通過“Java管理擴展”(JMX)指定的參數(shù)或使用字符串表示參數(shù)來以原始方式調(diào)用它們。 注意:大多數(shù)用戶應(yīng)該使用字符串特征符。 除了操作命令外,AdminControl 對象還支持某些用于跟蹤、再連接服務(wù)器和轉(zhuǎn)換類型的實用程序方法。有關(guān)更多信息,參見用于腳本管理的 AdminControl 對象。 AdminConfig 對象 使用 AdminConfig 對象來調(diào)用配置命令并創(chuàng)建或更改 WebSphere Application Server 配置的元素。 AdminConfig 對象的方法示例包括:create、remove、list、show 和 modify。有關(guān)更多信息,參見用于腳本管理的 AdminConfig 對象。 AdminApp 對象 使用 AdminApp 對象來安裝、修改和管理應(yīng)用程序。 AdminApp 對象與 WebSphere Application Server管理和配置服務(wù)進行交互以便執(zhí)行應(yīng)用程序查詢和更改。它包括安裝和卸載應(yīng)用程序、移動模塊、列示模塊和導(dǎo)出等等。AdminApp 對象與AdminConfig 和 AdminControl 對象不同,因為要使用 AdminConfig 和AdminContro,必須將腳本編制進程連接至服務(wù)器??梢杂帽镜胤绞秸{(diào)用大多數(shù) AdminApp功能,這意味著客戶機不與服務(wù)器通信就能完成功能。有關(guān)更多的信息,參見用于腳本管理的 AdminApp 對象。 Help 對象 Help 對象提供一般幫助和有關(guān)正在運行的 MBean 的動態(tài)聯(lián)機信息。 可以使用 Help 對象來幫助編寫和運行具有 AdminControl對象的腳本。某些方法包括:attributes、operations、AdminConfig 和AdminControl。有關(guān)更多的信息,參見用于腳本管理的 Help 對象。 wsadmin 的 Java 屬性 wsadmin 編制腳本客戶機使用以下所示的 Java 屬性。這些屬性在 wsadmin.properties 文件中指定,此文件位于以下目錄: ·WebSphere Application Server:/QIBM/UserData/WebAS5/Base/instance/properties ·WebSphere Application Server Network Deployment:/QIBM/ProdData/WebAS5/ND/instance/properties 其中 instance 是實例的名稱。 注意:這些屬性中的某些屬性有兩個缺省值。 ·iSeries 缺省值 當創(chuàng)建實例時,將在 wsadmin.properties 文件中設(shè)置此值。此文件中指定的值覆蓋 wsadmin 工具缺省值。 ·wsadmin 工具缺省值 這些值已在工具中硬編碼。如果未指定其它值,則工具使用這些缺省值。 以下是包含在 wsadmin.properties 文件中的 Java 屬性: ·com.ibm.ws.scripting.connectionType 此值確定要使用的連接類型??赡苤禐?SOAP(簡單對象訪問協(xié)議)、RMI(遠程方法調(diào)用)或 NONE。iSeries 缺省值為 SOAP。 ·com.ibm.ws.scripting.port 此屬性指定連接器使用的端口。缺省值為實例的 SOAP 端口。 ·com.ibm.ws.scipting.host 腳本編制進程嘗試連接的主機。缺省值為 localhost。 ·com.ibm.ws.scripting.defaultLang 此屬性指定當執(zhí)行腳本時要使用的語言。Jacl 是唯一受支持的語言。如果指定 -f 參數(shù),則 wsadmin檢查文件擴展名是否映射至已知值。例如,如果文件名是 test.jacl,則它將語言設(shè)置為 JACL。如果未指定 -f參數(shù)或文件類型是未知的,則 wsadmin 會生成錯誤。 iSeries 缺省值:jacl。 工具缺省值:無 ·com.ibm.ws.scripting.traceFile 此屬性指定一個文件,腳本編制進程將把跟蹤和記錄信息寫入該文件。 iSeries 缺省值:以下目錄中的 wsadmin.traceout 文件: § WebSphere Application Server: /QIBM/UserData/WebAS5/Base/instance/logs/wsadmin.traceout § WebSphere Application Server Network Deployment: /QIBM/UserData/WebAS5/ND/instance/logs/wsadmin.traceout 其中 instance 是實例的名稱。 工具缺省值:將跟蹤輸出打印至屏幕。 ·com.ibm.ws.scripting.validationOutput 此屬性指定將驗證報告定向至何處。如果多個用戶同時使用 wsadmin 管理某個實例,建議在用戶屬性文件中指定不同的 validationOutput 屬性。 iSeries 缺省值:以下目錄中的 wsadmin.valout 文件: § WebSphere Application Server: /QIBM/UserData/WebAS5/Base/instance/logs/wsadmin.valout § WebSphere Application Server Network Deployment: /QIBM/UserData/WebAS5/ND/instance/logs/wsadmin.valout 其中 instance 是實例的名稱。 工具缺省值:當前目錄中的 wsadmin.valout ·com.ibm.ws.scripting.traceString 此屬性用于打開對腳本編制進程的跟蹤。例如,使用 com.ibm.ws.scripting.*=all=enabled 來打開對腳本編制代碼的所有跟蹤。缺省值為不使用跟蹤。 ·com.ibm.ws.scripting.profiles 概要文件屬性是 wsadmin 在運行用戶命令、腳本或交互式外殼程序之前運行的概要文件的列表。 iSeries 缺省值包括 /QIBM/ProdData/WebAS5/Base/bin/securityProcs.jacl 和/QIBM/ProdData/WebAS5/Base/bin/LTPA_LDAPSecurityProcs.jacl。這些概要文件腳本使得配置安全性很容易。 工具缺省值:無 ·com.ibm.ws.scripting.emitWarningForCustomSecurityPolicy 此屬性指定當找到定制許可時是否發(fā)出消息 WASX7207W??赡苤禐?TRUE 和 FALSE。 iSeries 缺省值:無 工具缺省值:TRUE ·com.ibm.ws.scripting.tempdir 此屬性指定當安裝應(yīng)用程序時要用于臨時文件的目錄。 iSeries 缺省值:無 工具缺省值:Java 系統(tǒng)屬性 java.io.tempdir 的值 ·com.ibm.ws.scripting.validationLevel 此屬性指定當從腳本編制界面進行配置更改時要使用的驗證級別??赡苤禐?NONE、LOW、MEDIUM、HIGH 和 HIGHEST。 iSeries 缺省值:無 工具缺省值:HIGHEST ·com.ibm.ws.scripting.crossDocumentValidationEnabled 此屬性指定當更改一個文檔時驗證機制是否檢查其它文檔。可能值為 TRUE 和 FALSE。 iSeries 缺省值:無 工具缺省值:TRUE ·com.ibm.ws.scripting.classpath 此類路徑屬性將附加到用于搜索類和資源的路徑列表中。對于 iSeries 或 wsadmin 工具無缺省值。 |
|
來自: calfer > 《學(xué)習(xí)》