使用 wsadmin Scripting 之 AdminTask 物件的 JobManagerNode 指令群組 (已淘汰)

您可以利用 wsadmin 工具，利用 Jython Scripting 語言來管理工作管理程式設定。 請使用 JobManagerNode 群組中的指令和參數，向工作管理程式登錄不包含管理代理程式的目標。

已淘汰特性: 工作管理程式已淘汰。 使用 Urban Code Deploy 來安裝產品、部署應用程式，以及管理遠端主機，而不是工作管理程式。 若要管理 WebSphere® Application Server 安裝，您也可以使用擺動設定檔。 請參閱 在產品安裝之間交換設定檔。

請使用指令名稱中具有 Target 的指令: cleanupTarget、 queryTargets、 getTargetProperties、 modifyTargetProperties及 getTargetKeys。 這些指令會取代在指令名稱中具有 ManagedNode 的已淘汰指令。

已淘汰的特性: JobManagerNode 指令群組中的指令名稱中含有 ManagedNode ，且在 WebSphere Application Server 8.0 版中已淘汰的指令包括 cleanupManagedNode、 queryManagedNodes、 getManagedNodeProperties、 modifyManagedNodeProperties和 getManagedNodeKeys。 請改用指令名稱中具有 Target 的指令。
請使用下列指令來管理及查詢受管理節點、目標和資源配置:

cleanupManagedNode (已淘汰)

cleanupManagedNode 指令會清除受管理節點的登錄資訊。 從工作管理程式移除節點時，如果系統失敗，請使用這個指令來明確清除工作管理程式上的登錄資訊。 指令不會移除節點的工作歷程。 進行中的工作會繼續執行，但不會啟動節點的新工作。

目標物件

無。

必要參數

-managedNodeName
指定相關節點的名稱。 （字串，必要）

回覆值

指令會傳回系統已清除之工作管理程式的 UUID。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.cleanupManagedNode('-managedNodeName Node1')
  • 使用 Jython 清單：
    AdminTask.cleanupManagedNode(['-managedNodeName', 'Node1'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.cleanupManagedNode('-interactive')

cleanupTarget

cleanupTarget 指令會清除目標的登錄資訊。 從工作管理程式移除目標時，如果系統失敗，請使用這個指令來明確清除工作管理程式上的登錄資訊。 指令不會移除目標的工作歷程。 進行中的工作繼續執行，但不會針對目標啟動新工作。

目標物件

無。

必要參數

-targetName
指定屬意目標的名稱。 （字串，必要）

回覆值

指令會傳回系統已清除之工作管理程式的 UUID。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.cleanupTarget('-targetName Target1')
  • 使用 Jython 清單：
    AdminTask.cleanupTarget(['-targetName', 'Target1'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.cleanupTarget('-interactive')

getContexts

getContexts 指令會顯示管理模型中的所有環境定義，包括節點和伺服器。

目標物件

無。

必要參數

無。

回覆值

指令會傳回所有環境定義路徑的清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getContexts()
  • 使用 Jython 清單：
    AdminTask.getContexts()

互動模式用法範例

  • 使用 Jython：
    AdminTask.getContexts('-interactive')

getManagedNodeKeys (已淘汰)

getManagedNodeKeys 指令會顯示用來查詢受管理節點的索引鍵，包括 name、 alias及 uuid 索引鍵。

目標物件

無。

選用參數

-managedNodeName
指定相關節點的名稱。 （字串，選用）

回覆值

指令會傳回金鑰清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getManagedNodeKeys('-managedNodeName Node1')
  • 使用 Jython 清單：
    AdminTask.getManagedNodeKeys(['-managedNodeName', 'Node1'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.getManagedNodeKeys('-interactive')

getTargetKeys

getTargetKeys 指令會顯示用來查詢目標的索引鍵，包括 name、 alias及 uuid 索引鍵。

目標物件

無。

選用參數

-targetName
指定屬意目標的名稱。 （字串，選用）

回覆值

指令會傳回金鑰清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getTargetKeys('-targetName Target1')
  • 使用 Jython 清單：
    AdminTask.getTargetKeys(['-targetName', 'Target1'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.getTargetKeys('-interactive')

getManagedNodeProperties (已淘汰)

getManagedNodeProperties 指令會顯示一或多個受管理或未受管理節點的內容。

目標物件

無。

選用參數

-managedNodeNameList
指定感興趣節點的名稱清單。 (字串 [] ，選用)

回覆值

這個指令會傳回以 -managedNodeNameList 參數指定之每一個節點的內容清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getManagedNodeProperties('-managedNodeNameList "[Node1 Node2]"')
  • 使用 Jython 清單：
    AdminTask.getManagedNodeProperties(['-managedNodeNameList', '[Node1 Node2]'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.getManagedNodeProperties('-interactive')

getTargetProperties

getTargetProperties 指令會顯示一或多個目標的內容。

目標物件

無。

選用參數

-targetNameList
指定感興趣目標的名稱清單。 (字串 [] ，選用)

回覆值

這個指令會傳回以 -targetNameList 參數指定之每一個目標的內容清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getTargetProperties('-targetNameList "[Target1 Target2]"')
  • 使用 Jython 清單：
    AdminTask.getTargetProperties(['-targetNameList', '[Target1 Target2]'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.getTargetProperties('-interactive')

getManagedResourceProperties

getManagedResourceProperties 指令會顯示一或多個受管理資源的內容。 受管理資源是節點環境定義或伺服器環境定義內的實例。 例如，在伺服器環境定義內，您可以具有受管理資源 server1、 server2或 server3。

目標物件

無。

必要參數

-resourceIdList
指定感興趣資源的唯一 ID 清單。 （字串，選用）

回覆值

此指令會傳回每一個受管理資源的內容清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getManagedResourceProperties('-resourceIdList AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
/nodes/myNode/servers/server1')
  • 使用 Jython 清單：
    AdminTask.getManagedResourceProperties('-resourceIdList', 'AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
/nodes/myNode/servers/server1')

互動模式用法範例

  • 使用 Jython：
    AdminTask.getManagedResourceProperties('-interactive')

getManagedResourcePropertyKeys

getManagedResourcePropertyKeys 指令會顯示特定類型受管理資源的內容索引鍵。

目標物件

無。

必要參數

-resourceType
指定您屬意之受管理資源的類型。 （字串，必要）

回覆值

指令會傳回特定資源類型的受管理資源索引鍵清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getManagedResourcePropertyKeys('-resourceType server')
  • 使用 Jython 清單：
    AdminTask.getManagedResourcePropertyKeys('-resourceType', 'server')

互動模式用法範例

  • 使用 Jython：
    AdminTask.getManagedResourcePropertyKeys('-interactive')

getManagedResourceTypes

getManagedResourceTypes 指令會顯示每一個受管理資源類型。

目標物件

無。

必要參數

無。

回覆值

指令會傳回受管理資源類型的清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.getManagedResourceTypes()
  • 使用 Jython 清單：
    AdminTask.getManagedResourceTypes()

互動模式用法範例

  • 使用 Jython：
    AdminTask.getManagedResourceTypes('-interactive')

modifyManagedNodeProperties (已淘汰)

modifyManagedNodeProperties 指令會取代受管理節點配置中的內容。 如果受管理節點有管理代理程式，指令只會修改 alias 內容。 如果受管理節點沒有管理代理程式，這個指令會取代所有內容。

目標物件

無。

必要參數

-managedNodeName
指定相關節點的名稱。 （字串，必要）
-managedNodeProps
指定要針對相關節點修改的名稱/值內容配對。 (內容，必要)

選用參數

-replace
指定是否取代現有的內容。 指定 true 以取代現有內容。 指定 false 以合併內容。 預設值為 false。 （Boolean，選用）

回覆值

指令不傳回輸出。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.modifyManagedNodeProperties('-managedNodeName Node1 -managedNodeProps "[alias myNewAlias]"')
  • 使用 Jython 清單：
    AdminTask.modifyManagedNodeProperties('-managedNodeName', 'Node1', '-managedNodeProps', '[alias myNewAlias]')

互動模式用法範例

  • 使用 Jython：
    AdminTask.modifyManagedNodeProperties('-interactive')

modifyTargetProperties

modifyTargetProperties 指令會取代目標配置中的內容。 如果目標有管理代理程式，指令只會修改 alias 內容。 如果目標沒有管理代理程式，指令會取代所有內容。

目標物件

無。

必要參數

-targetName
指定屬意目標的名稱。 （字串，必要）
-targetProps
指定要針對相關目標修改的名稱/值內容配對。 (內容，必要)

選用參數

-replace
指定是否取代現有的內容。 指定 true 以取代現有內容。 指定 false 以合併內容。 預設值為 false。 （Boolean，選用）

回覆值

指令不傳回輸出。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.modifyTargetProperties('-targetName Target1 -targetProps "[alias myNewAlias]"')
  • 使用 Jython 清單：
    AdminTask.modifyTargetProperties('-targetName', 'Target1', '-targetProps', '[alias myNewAlias]')

互動模式用法範例

  • 使用 Jython：
    AdminTask.modifyTargetProperties('-interactive')

queryManagedNodes (已淘汰)

queryManagedNodes 指令會根據查詢表示式來搜尋受管理節點。 如果您未指定查詢表示式，則指令會傳回所有受管理節點。

目標物件

無。

必要參數

-maxReturn
指定要傳回的受管理節點數目上限。 （整數，必要）

選用參數

-query
指定由一或多個以空格區隔的查詢表示式所組成的查詢。 如果您未指定此參數，則指令會傳回所有受管理節點。 （字串，選用）
根據下列準則建構查詢:
  • 每一個查詢表示式都由 key、 operator和 value 元素組成。
  • 支援下列運算子:
    表 1. queryManagedNodes -query 運算子 。 在查詢中使用運算子。
    字元 價值
    = 等於。 使用 = NULL來指定值是空值。
    != 不等於。 使用 != NULL 指定該值不是空值
    > 大於
    < 小於
    >= 大於或等於
    <= 小於或等於
  • 您可以指定一個值或多個值 (以逗點區隔)。
  • 您可以使用型樣相符來指定值。
-validate
指定是否驗證搜尋查詢。 （Boolean，選用）

回覆值

指令會傳回找到的相符查詢數目。 其次，指令會傳回符合搜尋查詢準則的受管理節點清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.queryManagedNodes('-maxReturn 20 -query "managedNodeName=Node1" -validate true')
  • 使用 Jython 清單：
    AdminTask.queryManagedNodes(['-maxReturn', '20', '-query', 'managedNodeName=Node1', '-validate', 'true'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.queryManagedNodes('-interactive')

queryTargets

queryTargets 指令會根據查詢表示式來搜尋目標。 如果您沒有指定查詢表示式，指令會傳回所有目標。

目標物件

無。

必要參數

-maxReturn
指定要傳回的目標數目上限。 （整數，必要）

選用參數

-query
指定由一或多個以空格區隔的查詢表示式所組成的查詢。 如果您沒有指定這個參數，指令會傳回所有目標。 （字串，選用）
根據下列準則建構查詢:
  • 每一個查詢表示式都由 key、 operator和 value 元素組成。
  • 支援下列運算子:
    表 2. queryTargets -query 運算子 。 在查詢中使用運算子。
    字元 價值
    = 等於。 使用 = NULL來指定值是空值。
    != 不等於。 使用 != NULL 指定該值不是空值
    > 大於
    < 小於
    >= 大於或等於
    <= 小於或等於
  • 您可以指定一個值或多個值 (以逗點區隔)。
  • 您可以使用型樣相符來指定值。
-validate
指定是否驗證搜尋查詢。 （Boolean，選用）

回覆值

指令會傳回找到的相符查詢數目。 其次，指令會傳回符合搜尋查詢準則的目標清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.queryTargets('-maxReturn 20 -query "targetName=target1" -validate true')
  • 使用 Jython 清單：
    AdminTask.queryTargets(['-maxReturn', '20', '-query', 'targetName=target1', '-validate', 'true'])

互動模式用法範例

  • 使用 Jython：
    AdminTask.queryTargets('-interactive')

queryManagedResources

queryManagedResources 指令會根據查詢表示式來查詢特定受管理節點的受管理資源。

目標物件

無。

必要參數

-maxReturn
指定要傳回的受管理資源數目上限。 （整數，必要）

選用參數

-query
指定由一或多個以空格區隔的查詢表示式所組成的查詢。 如果您未指定此參數，則指令會傳回所有受管理節點。 （字串，選用）
根據下列準則建構查詢:
  • 每一個查詢表示式都由 key、 operator和 value 元素組成。
  • 支援下列運算子:
    表 3. queryManagedResources -query 運算子 。 在查詢中使用運算子。
    字元 價值
    = 等於。 使用 = NULL來指定值是空值。
    != 不等於。 使用 != NULL 指定該值不是空值
    > 大於
    < 小於
    >= 大於或等於
    <= 小於或等於
  • 您可以指定一個值或多個值 (以逗點區隔)。
  • 您可以使用型樣相符來指定值。
-validate
指定是否驗證搜尋查詢。 （Boolean，選用）

回覆值

指令會傳回找到的相符查詢數目。 其次，指令會傳回符合搜尋查詢準則之受管理節點的 UUID 清單。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.queryManagedResources('-maxReturn 20 -query "alias=managedNode1"')
  • 使用 Jython 清單：
    AdminTask.queryManagedResources('-maxReturn', '20', '-query', '"alias=managedNode1"')

互動模式用法範例

  • 使用 Jython：
    AdminTask.queryManagedResources('-interactive')

registerHost

registerHost 指令會定義工作管理程式的遠端主機目標。 使用 registerHost 指令來執行下列動作:

  • 向工作管理程式登錄遠端主機目標。 不同於目標是 WebSphere Application Server 設定檔，並在部署管理程式或管理代理程式上使用 registerWithJobManager 指令登錄，遠端主機目標不需要安裝任何 WebSphere Application Server 產品。 除了作業系統，這部主機沒有其他軟體需求。
  • 收集遠端主機的庫存。 順利完成 registerHost 指令時，可以使用受管理資源及工作類型的相關資訊。

您可以使用與使用 registerWithJobManager登錄的遠端主機目標相同的遠端主機目標，但遠端主機目標可用的工作類型不同。

目標物件

無。

必要參數

-host
指定要向工作管理程式登錄的遠端電腦名稱。 （字串，必要）
-hostProps
指定主機的內容。 您可以定義任何想要的內容。 表格中定義的內容會影響指令的行為。 （字串，必要）
表 4. registerHost -hostProps 定義的內容 。 您可以為 registerHost 指令指定一個以上已定義的內容，或為指令指定未定義的內容。
內容名稱 內容說明
osType 作業系統類型。 指定 osType 可讓指令更快完成。 這個選用內容決定與主機連接的方法。 有效值如下：
  • aix
  • 赫普
  • os400
  • linux
  • solaris
  • windows
  • os390
username 有權登入主機的使用者。 這個內容是必要的。
密碼 給定使用者名稱的密碼。 必須指定 password 或 privateKeyFile 的值。 如果主機不需要密碼，您可以指定空字串值 ""。
privateKeyFile 私密金鑰檔的路徑。 如果您未指定密碼的值，則必須指定 privateKeyFile 的值。
通行詞組 (passphrase) privateKeyFile 的通行詞組 (必要的話)。
saveSecurity 指定是否與主機一起儲存安全內容 (username、password、privateKeyFile、passphrase) ，並作為工作提交的預設值。 如果提供值 true給此內容，則安全內容會與主機一起儲存，並用於向此主機提交後續工作。

選用參數

-imDataLocations
請輸入 Installation Manager 資料位置的完整路徑。 您可以輸入以分號區隔的多個路徑。 如果在您的目標上有非預設的 Installation Manager 資料位置，這個內容很有用。 例如，如果您在安裝 Installation Manager時指定資料位置， CIM 的庫存工作可能找不到非預設資料位置。 因此，在登錄主機時，您可能需要指定其他資料位置。 如果指定無效的資料位置，則不會儲存它。 如果庫存工作可以偵測到指定的資料位置，則不會儲存它。 您也可以使用尋找資料位置工作來搜尋系統上的資料位置。 尋找資料位置工作會自動更新這個內容。 例如：
AdminTask.registerHost('[-host hostname -hostProps [ [imDataLocations datalocation1; datalocation2] 
[password ****] [saveSecurity true] [username username] ]]')
您可以使用 registerHost 指令來指定 Liberty 變數的路徑; 例如:
AdminTask.registerHost('-host hostname -hostProps [ [username admin][password password][saveSecurity true]
 [WLP_WORKING_DIR C:/working][WLP_SHARED_DIR C:/shared][WLP_ADDITIONAL_DIRS C:/addl] ]')

回覆值

指令會傳回遠端主機的庫存。

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.registerHost('-host myHost.acme.com -hostProps [ [osType linux][username root]
 [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true] ]')
  • 使用 Jython 清單：
    AdminTask.registerHost('-host', 'myHost.acme.com', '-hostProps', '[ [osType linux] [username root]
 [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true]' ]')

互動模式用法範例

  • 使用 Jython：
    AdminTask.registerHost('-interactive')

unregisterHost

unregisterHost 指令會從工作管理程式移除遠端主機。 使用 unregisterHost 指令，從工作管理程式取消登錄遠端主機目標。 取消登錄主機之後，工作管理程式無法在目標上執行工作。

目標物件

無。

必要參數

-host
指定要從工作管理程式取消登錄的遠端電腦名稱。 （字串，必要）

選用參數

無

回覆值

無

批次模式用法範例

  • 使用 Jython 字串：
    AdminTask.unregisterHost('-host myHost.acme.com')
  • 使用 Jython 清單：
    AdminTask.unregisterHost('-host', 'myHost.acme.com')

互動模式用法範例

  • 使用 Jython：
    AdminTask.unregisterHost('-interactive')