型錄服務網域管理作業

您可以使用 Jacl 或 Jython Scripting 語言,來管理 WebSphere® Application Server 配置中的目錄服務網域。使用 WebSphere DataPower® XC10 Appliance,您可以定義目錄服務網域,以與執行於軟體驅動裝置上的目錄伺服器建立連線。只有動態快取資料網格才需要建立此配置。

需求

必須已將 WebSphere eXtreme Scale 用戶端安裝在 WebSphere Application Server 環境中。

列出所有管理作業

若要取得與型錄服務網域相關之所有管理作業的清單,請使用 wsadmin 執行下列指令:
wsadmin>$AdminTask help XSDomainManagement 

指令

型錄服務網域的管理作業包括下列指令:

createXSDomain

createXSDomain 指令會登錄新的型錄服務網域。
表 1. createXSDomain 指令引數
引數 說明
-name(必要) 用來指定您要建立之型錄服務網域的名稱。
-default 用來指定型錄服務網域是否為 Cell 的預設網域。預設值為 true。 (布林:設為 truefalse
-properties 用來指定型錄服務網域的自訂內容。
表 2. defineDomainServers 步驟引數
引數 說明
name_of_endpoint 用來指定型錄服務端點的名稱。
  • 針對現有應用程式伺服器:端點的名稱必須採用下列格式:cell_name\node_name\server_name
  • 針對遠端伺服器:用來指定遠端伺服器的主機名稱。您可以對多個端點使用相同的主機名稱,但每一個端點的用戶端埠值必須是唯一的。
custom_properties 用來指定型錄服務網域端點的自訂內容。如果不具有任何自訂內容,請將一組雙引號 ("") 用於此引數。
endpoint_ports
用來指定型錄服務網域端點的埠號。必須採用下列順序來指定埠:<用戶端埠>,<接聽器埠>
用戶端埠
指定用於在型錄服務網域內的型錄伺服器之間進行通訊的埠。針對只在 WebSphere Application Server 處理程序中執行的型錄伺服器,這個值是必要的,並可以設為未在其他服務使用的任何埠。
接聽器埠
指定用於與用戶端進行通訊的埠。 對於遠端端點,這個值是必要的,且必須與啟動型錄服務時所使用的值相符。接聽器埠供用戶端和儲存器用來與型錄服務進行通訊。
針對 WebSphere DataPower XC10 Appliance 遠端端點:請將值 2809 用於軟體驅動裝置遠端端點。

回覆值

批次模式用法範例

批次模式要求輸入正確的指令格式。請考量使用互動模式,以確保正確地處理您輸入的值。使用批次模式時,必須使用特定的內容陣列來定義 -defineDomainServers 步驟引數。此內容陣列的格式為:name_of_endpoint custom_properties endpoint_portsendpoint_ports 值是一個埠清單,必須採用下列順序進行指定:<用戶端埠>,<接聽器埠>

互動模式用法範例
  • 使用 Jacl:
    $AdminTask createXSDomain {-interactive}
  • 使用 Jython 字串:
    AdminTask.createXSDomain ('[-interactive]')

deleteXSDomain

deleteXSDomain 指令會刪除型錄服務網域。

必要參數:
-name
用來指定要刪除之型錄服務網域的名稱。

回覆值

批次模式用法範例
  • 使用 Jacl:
    $AdminTask deleteXSDomain {-name TestDomain }
  • 使用 Jython 字串:
    AdminTask.deleteXSDomain('[-name TestDomain ]')
互動模式用法範例
  • 使用 Jacl:
    $AdminTask deleteXSDomain {-interactive}
  • 使用 Jython 字串:
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

getDefaultXSDomain 指令會傳回 Cell 的預設型錄服務網域。

必要參數:

回覆值:預設型錄服務網域的名稱。

批次模式用法範例
  • 使用 Jacl:
    $AdminTask getDefaultXSDomain
  • 使用 Jython 字串:
    AdminTask.getDefaultXSDomain
互動模式用法範例
  • 使用 Jacl:
    $AdminTask getDefaultXSDomain {-interactive}
  • 使用 Jython 字串:
    AdminTask.getDefaultXSDomain ('[-interactive]')

listXSDomains

listXSDomains 指令會傳回現有型錄服務網域的清單。

必要參數:

回覆值:Cell 中所有型錄服務網域的清單。

批次模式用法範例
  • 使用 Jacl:
    $AdminTask listXSDomains
  • 使用 Jython 字串:
    AdminTask.listXSDomains
互動模式用法範例
  • 使用 Jacl:
    $AdminTask listXSDomains {-interactive}
  • 使用 Jython 字串:
    AdminTask.listXSDomains ('[-interactive]')

modifyXSDomain

modifyXSDomain 指令會修改現有型錄服務網域。

批次模式要求輸入正確的指令格式。請考量使用互動模式,以確保正確地處理您輸入的值。使用批次模式時,必須使用特定的內容陣列來定義 -modifyEndpoints-addEndpoints-removeEndpoints 步驟引數。此內容陣列的格式為:name_of_endpoint host_name custom_properties endpoint_portsendpoint_ports 值是一個埠清單,必須採用下列順序進行指定:<用戶端埠>,<接聽器埠>

表 3. modifyXSDomain 指令引數
引數 說明
-name(必要) 用來指定您要編輯之型錄服務網域的名稱。
-default 如果設為 true,將指定所選型錄服務網域即是 Cell 的預設網域。 (布林)
-properties 用來指定型錄服務網域的自訂內容。
表 4. modifyEndpoints 步驟引數
引數 說明
name_of_endpoint 用來指定型錄服務端點的名稱。
  • 針對現有應用程式伺服器:端點的名稱必須採用下列格式:cell_name\node_name\server_name
  • 針對遠端伺服器:用來指定遠端伺服器的主機名稱。您可以對多個端點使用相同的主機名稱,但每一個端點的接聽器埠值必須是唯一的。如果要配置軟體驅動裝置,則此值必須是完整的網域名稱。
endpoint_ports
用來指定型錄服務網域端點的埠號。必須採用下列順序來指定端點:<用戶端埠>,<接聽器埠>
用戶端埠
指定用於在型錄服務網域內的型錄伺服器之間進行通訊的埠。針對只在 WebSphere Application Server 處理程序中執行的型錄伺服器,這個值是必要的,並可以設為未在其他服務使用的任何埠。
接聽器埠
指定用於與用戶端進行通訊的埠。 對於遠端端點,這個值是必要的,且必須與啟動型錄服務時所使用的值相符。接聽器埠供用戶端和儲存器用來與型錄服務進行通訊。
針對 WebSphere DataPower XC10 Appliance 遠端端點:請將值 2809 用於軟體驅動裝置遠端端點。
表 5. addEndpoints 步驟引數
引數 說明
name_of_endpoint 用來指定型錄服務端點的名稱。
  • 針對現有應用程式伺服器:端點的名稱必須採用下列格式:cell_name\node_name\server_name
  • 針對遠端伺服器:用來指定遠端伺服器的主機名稱。您可以對多個端點使用相同的主機名稱,但每一個端點的接聽器埠值必須是唯一的。如果要配置軟體驅動裝置,則此值必須是完整的網域名稱。
custom_properties 用來指定型錄服務網域端點的自訂內容。如果不具有任何自訂內容,請將一組雙引號 ("") 用於此引數。
endpoint_ports
用來指定型錄服務網域端點的埠號。必須採用下列順序來指定端點:<用戶端埠>,<接聽器埠>
用戶端埠
指定用於在型錄服務網域內的型錄伺服器之間進行通訊的埠。針對只在 WebSphere Application Server 處理程序中執行的型錄伺服器,這個值是必要的,並可以設為未在其他服務使用的任何埠。
接聽器埠
指定用於與用戶端進行通訊的埠。 對於遠端端點,這個值是必要的,且必須與啟動型錄服務時所使用的值相符。接聽器埠供用戶端和儲存器用來與型錄服務進行通訊。
針對 WebSphere DataPower XC10 Appliance 遠端端點:請將值 2809 用於軟體驅動裝置遠端端點。
表 6. removeEndpoints 步驟引數
引數 說明
name_of_endpoint 用來指定要刪除之型錄服務端點的名稱。

回覆值

批次模式用法範例
  • 使用 Jacl:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints 
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • 使用 Jython 字串:
    AdminTask.modifyXSDomain('[-name TestDomain  
    -default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]] 
    -addEndpoints [[xhost3.ibm.com "" ,2809]] 
    -removeEndpoints [[xhost2.ibm.com]]]')
互動模式用法範例
  • 使用 Jacl:
    $AdminTask modifyXSDomain {-interactive}
  • 使用 Jython 字串:
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

testXSDomainConnection 指令會測試與型錄服務網域的連線。

必要參數:
-name
用來指定要測試與其連線的型錄服務網域名稱。
選用參數
-timeout
用來指定等待連線的時間上限,以秒為單位。

回覆值:如果可以建立連線,則傳回 true,否則會傳回連線錯誤資訊。

批次模式用法範例
  • 使用 Jacl:
    $Admintask testXSDomainConnection
  • 使用 Jython 字串:
    AdminTask.testXSDomainConnection
互動模式用法範例
  • 使用 Jacl:
    $AdminTask testXSDomainConnection {-interactive}
  • 使用 Jython 字串:
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

testXSServerConnection 指令會測試與型錄伺服器的連線。此指令適用於獨立式伺服器以及隸屬於型錄服務網域的伺服器。

必要參數:
host
用來指定型錄伺服器所在的主機。
listenerPort
用來指定型錄伺服器的接聽器埠。
選用參數
timeout
用來指定等待與型錄伺服器之連線的時間上限,以秒為單位。

回覆值

批次模式用法範例
  • 使用 Jacl:
    $Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
  • 使用 Jython 字串:
    AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
互動模式用法範例
  • 使用 Jacl:
    $AdminTask testXSServerConnection {-interactive}
  • 使用 Jython 字串:
    AdminTask.testXSServerConnection ('[-interactive]')