xsadmin 公用程式參照

您可以使用下列兩個不同的方法,來傳遞引數到 xsadmin 公用程式:使用指令行引數,或使用內容檔。

xsadmin 引數

可使用 WebSphere® eXtreme Scale 用戶端 7.1 版修正程式 1 或更新版本來定義 xsadmin 公用程式的內容檔。利用建立內容檔的方式,可儲存部分常用引數,例如使用者名稱。可以新增至內容檔的內容列出在下列表格中。如果您同時指定內容檔中的內容和相等的指令行引數,則指令行引數值會置換內容檔值。

表 1. xsadmin 公用程式的引數
指令行引數 內容檔中的相等內容名稱 說明和有效值
-bp N/A(無法使用)

指示接聽器埠。

預設值:2809

-ch N/A(無法使用)

用來指出型錄伺服器的 JMX 主機名稱。

預設值:localhost

-clear N/A(無法使用)

清除指定的對映。

容許使用下列過濾器:-fm

-containers N/A(無法使用) 針對每一個資料網格和對映集,會顯示儲存器伺服器的清單。

容許使用下列過濾器:-fnp

-continuous N/A(無法使用) 當您想要連續的對映大小結果以監視資料網格時,請指定此旗標。當您使用 -mapsizes 引數執行此指令時,對映大小每 20 秒顯示一次。
-coregroups N/A(無法使用) 用來顯示目錄伺服器的所有核心群組。此引數用於進階診斷程式。
-dismissLink <catalog_service_domain> N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower® XC10 Appliance 配置。

-dmgr N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。

-empties N/A(無法使用) 當您想要在輸出中顯示空白儲存器,則指定這個旗標。
-establishLink <foreign_domain_name> <host1:port1,host2:port2...> N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。

-fc N/A(無法使用) 只對此儲存器進行過濾。
如果要過濾 WebSphere Application Server Network Deployment 環境中的儲存器伺服器,請使用下列格式:
<cell_name>/<node_name>/<serverName_containerSuffix>

與下列引數搭配使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec

-fh N/A(無法使用) 只對此主機進行過濾。

與下列引數搭配使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec-routetable

-fm N/A(無法使用) 只對此對映進行過濾。

與下列引數搭配使用:-clear-mapsizes

-fnp N/A(無法使用) 過濾沒有主要 Shard 的伺服器。

與下列引數搭配使用:-containers

-fp N/A(無法使用) 只對此分割區進行過濾。

與下列引數搭配使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec-routetable

-fs N/A(無法使用) 只對此伺服器進行過濾。
如果要過濾 WebSphere Application Server Network Deployment 環境中的應用程式伺服器,請使用下列格式:
<cell_name>/<node_name>/<server_name>

與下列引數搭配使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec

-fst N/A(無法使用) 只對此 Shard 類型進行過濾。指定 "P" 為僅限主要的 Shard、"A" 為僅限非同步抄本 Shard,以及 "S" 為僅限同步的抄本 Shard。

與下列引數搭配使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec

-fz N/A(無法使用) 只對此區域進行過濾。

與下列引數搭配使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec-routetable

-force N/A(無法使用) 強制執行在指令中的動作,停用全部的先佔提示。 此引數對執行批次指令很有用。
-g N/A(無法使用) 指定 ObjectGrid 名稱。
-getstatsspec N/A(無法使用) 用來顯示現行統計資料規格。可使用 -setstatsspec 引數來設定統計資料規格。

容許使用下列過濾器:-fst -fc -fz -fs -fh -fp

-getTraceSpec N/A(無法使用) 用來顯示現行追蹤規格。可使用 -settracespec 引數來設定追蹤規格。

容許使用下列過濾器:-fst -fc -fz -fs -fh -fp

-h N/A(無法使用) 用來顯示 xsadmin 公用程式的說明,其包含引數清單。
-hosts N/A(無法使用) 用來顯示配置中的所有主機。
-jmxUrl XSADMIN_JMX_URL 用來以下列格式指定 JMX API 連接器伺服器的位址:service:jmx:protocol:sapprotocolsap 變數定義如下:
通訊協定 (protocol)
指定用來連接到連接器伺服器的傳輸通訊協定。
sap
用來指定找到連接器伺服器的位址。
如需 JMX 服務 URL 格式的相關資訊,請參閱類別 JMXServiceURL (Java 2 Platform SE 5.0)
-l N/A(無法使用) 用來顯示所有已知資料網格和對映集。
-m N/A(無法使用) 用來指定對映集的名稱。
-mapsizes N/A(無法使用) 用來顯示型錄伺服器上的每個對映大小,以驗證 Shard 上的索引鍵分佈是一致的。

容許使用下列過濾器:-fm -fst -fc -fz -fs -fh -fp

-mbeanservers N/A(無法使用) 用來顯示所有 MBean 伺服器端點的清單。
-overridequorum N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。

-password XSADMIN_PASSWORD 用來指定登入 xsadmin 公用程式的密碼。如果要使密碼保持安全,請勿在內容檔中指定密碼。
-p N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。

  N/A(無法使用) 用來顯示配置中的已配置放置和執行時期放置。您可以限定輸出的範圍為資料網格和對映集的組合或整個配置:
  • 整個配置:
    -placementStatus
  • 針對特定的資料網格:
    -placementStatus -g my_grid
  • 針對特定的對映集:
    -placementStatus -m my_mapset
  • 針對特定的資料網格和對映集:
    -placementStatus  -g my_grid 
    -m my_mapset
-primaries N/A(無法使用) 用來顯示主要 Shard 的清單。
-profile N/A(無法使用) 用來指定 xsadmin 公用程式內容檔的完整路徑。
-quorumstatus N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。

-releaseShard <container_server_name> <objectgrid_name> <map_set_name> <partition_name> N/A(無法使用) -reserveShard 引數一起使用。 在保留並放置 Shard 之後,必須呼叫 -releaseShard 引數。. -releaseShard 引數將呼叫 ContainerMBean.release() 方法。
-reserved N/A(無法使用) -containers 引數搭配使用,以僅顯示已利用 -reserveShard 引數保留的 Shard。
-reserveShard <container_server_name> <objectgrid_name> <map_set_name> <partition_name> N/A(無法使用) 將主要 Shard 移至指定的儲存器伺服器。ContainerMBean.reserve() 方法將由此引數呼叫。

-resumeBalancing <objectgrid_name> <map_set_name>

N/A(無法使用) 嘗試平衡要求。容許將來對指定的 Objectgrid 及對映集進行重新平衡嘗試。
-revisions N/A(無法使用) 用來顯示目錄服務網域的修訂 ID,包括:針對每個特定 Shard 的每一個資料網格、分割區號碼、分割區類型 (主要或抄本)、目錄服務網域、生命期限 ID 以及資料修訂次數。您可以使用此引數來判定是捕捉到非同步抄本,還是捕捉到鏈結的網域。此引數呼叫 ObjectGridMBean.getKnownRevisions() 方法。

容許使用下列過濾器:-fst -fc -fz -fs -fh -fp

-routetable N/A(無法使用) 顯示用戶端伺服器視景中資料網格的現行狀態。遞送表格是 ObjectGrid 用戶端伺服器用來與資料網格進行通訊的資訊。當您嘗試識別連線問題或 TargetNotAvailable 異常狀況時,請將遞送表格用作診斷輔助。

必要引數:在獨立式環境中,如果未使用目錄伺服器主機之引導接聽器埠及 JMX 埠的預設值,則必須指定 -bp-p 參數以及此引數。

容許使用下列過濾器:-fz -fh -fp

-settracespec <trace_string> N/A(無法使用)

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。如需在軟體驅動裝置上配置追蹤的相關資訊,請參閱處理 WebSphere DataPower XC10 Appliance 日誌檔

容許使用下列過濾器:-fst -fc -fz -fs -fh -fp

-swapShardWithPrimary <container_server_name> <objectgrid_name> <map_set_name> <partition_name>

N/A(無法使用) 從指定的儲存器伺服器與主要 Shard 交換指定的抄本 Shard。透過執行此指令,您可以在需要時手動平衡主要 Shard。
-setstatsspec <stats_spec> N/A(無法使用) 啟用統計資料收集。此引數呼叫 DynamicServerMBean.setStatsSpecDynamicServerMBean.getStatsSpec 方法。

容許使用下列過濾器:-fm -fst -fc -fz -fs -fh -fp

-suspendBalancing <objectgrid_name> <map_set_name>

N/A(無法使用) 防止將來對指定的 Objectgrid 及對映集進行平衡嘗試。
-ssl N/A(無法使用) 用來指示 Secure Sockets Layer (SSL) 已啟用。
-teardown N/A(無法使用)

容許使用下列過濾器:-fst -fc -fz -fs -fh -fp

用來提供伺服器清單的格式:
server_name_1,server_name_2 ...
要在區域中停止所有伺服器,併入 -fz 引數:
–fz <zone_name>
要在主機上停止所有伺服器,併入 -fh 引數:
–fh <host_name>

這個指令行引數不適用於 WebSphere DataPower XC10 Appliance 配置。

  N/A(無法使用) 強制執行 Shard 放置,忽略在部署 XML 檔中配置的 numInitialContainers 值。當您正在伺服器上執行維護時,可使用此引數以容許繼續執行 Shard 放置,即使 numInitialContainers 值比已配置的值更低。
-trustPass XSADMIN_TRUST_PASS 用來為所指定信任儲存庫指定密碼。
-trustPath XSADMIN_TRUST_PATH 用來指定信任儲存庫檔案的路徑。

範例:etc/test/security/server.public

-trustType XSADMIN_TRUST_TYPE 用來指定信任儲存庫的類型。

有效值:JKS、JCEK、PKCS12 等等。

-unassigned N/A(無法使用) 用來顯示無法放置在資料網格上的 Shard 清單。當放置服務具有防止放置的限制項時,無法放置 Shard。
-username XSADMIN_USERNAME 用來指定登入 xsadmin 公用程式的使用者名稱。
-v N/A(無法使用) 啟用詳細指令行動作。如果正在使用環境變數、內容檔或兩者來指定某些指令行引數,以及想要檢視其值,則使用這個旗標。
-xml N/A(無法使用) 列印 PlacementServiceMBean.listObjectGridPlacement() 方法的未過濾輸出。 其他 xsadmin 引數過濾此方法的輸出,並將資料組織成更易於使用的格式。