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