xscmd 公用程式參考

您可以使用下列指令清單作為使用 xscmd 公用程式時的參考。

一般指令參數

一般格式的 xscmd 公用程式指令如下。選用參數位於方括弧 [ ] 中。
注意:
請勿在 WebSphere® DataPower® XC10 Appliance 環境中使用下列指令:
  • -c releaseShard
  • -c reserveShard
  • -c swapShardWithPrimary
  • -c suspendBalancing
  • -c resumeBalancing
  • -c teardown
  • -c triggerPlacement
  • -c showinfo
用法:xscmd -c <cmdName> | -h <cmdName> | -lc [<cmdGroupName>] | -lcg
             [-cgc <className>] [-ca <support>] [-sp
             <profileName>] [-ks <filePath>] [-ts <filePath>] [-trf
             <filePath>] [-prot <protocol>] [-cxpv <provider>] [-trs
             <traceSpec>] [-al <alias>] [-pwd <password>] [-tsp <password>]
             [-cep <endpoints>] [-ksp <password>] [-arc <integer>] [-tt
             <type>] [-tst <type>] [-ssp <profileName>] [-kst <type>] [-cgp
             <property>] [-user <username>]

選項:
  -al,--alias <alias>                  金鑰儲存庫中的別名。

  -arc,--authRetryCount <integer>        如果認證過期,可以重試的鑑別次數。
                                       如果此值設值為 0,
                                          那麼不會重試鑑別。
                                       

  -c,--command <cmdName>                 指定要執行的指令名稱
                                       

  -ca,--credAuth <support>             設定用戶端認證
                                       鑑別支援 [Never、
                                       Supported 和 Required]。

  -cep,--catalogEndPoints <endpoints>    指定一個以上的目錄服務
                                       端點,格式為
                                       <host>[:<listenerPort>][,<host>[:<liste
                                       nerPort>]]。預設端點:
                                       localhost:2809

  -cgc,--credGenClass <className>        指定可實作 CredentialGenerator 介面之
                                       類別的名稱
                                       。此類別用於取得
                                       用戶端的認證。

  -cgp,--credGenProps <property>         指定 CredentialGenerator
                                       實作類別的
                                       內容。將該內容設為
                                       使用 setProperties(String)
                                       方法的物件。

  -cxpv,--contextProvider <provider>     環境定義提供者。範例:IBMJSSE2、
                                       IBMJSSE 和 IBMJSSEFIPS。

  -h,--help <cmdName>                    呼叫一般指令行說明

  -ks,--keyStore <filePath>              金鑰儲存庫的絕對路徑。範例:
                                                                               /etc/test/security/server.public

  -ksp,--keyStorePassword <password>     指定金鑰儲存庫的密碼。

  -kst,--keyStoreType <type>             金鑰儲存庫類型。範例:JKS、JCEK 和
                                       PKCS12。

  -lc,--listCommands <cmdGroupName>      列出指令群組的所有指令

  -lcg,--listCommandGroups               列出所有指令群組

  -prot,--protocol <protocol>            通訊協定。範例:SSL、SSLv2、
                                       SSLv3、TLS 和 TLSv1。

  -pwd,--password <password>             eXtreme Scale 密碼安全
                                       認證

  -sp,--secProfile <profileName>         指定設定檔名稱。

  -ssp,--saveSecProfile <profileName>    將安全參數值儲存在
                                       安全設定檔中。

  -trf,--traceFile <filePath>            為 xscmd 指令輸出指定
                                       所產生之追蹤檔的
                                       絕對路徑

  -trs,--traceSpec <traceSpec>           為 xscmd 指令輸出指定
                                       追蹤規格

  -ts,--trustStore <filePath>            信任儲存庫的絕對路徑。範例:
                                                                               /etc/test/security/server.public

  -tsp,--trustStorePassword <password>   信任儲存庫密碼

  -tst,--trustStoreType <type>           信任儲存庫類型。範例:JKS、JCEK 和
                                       PKCS12。

  -tt,--transportType <type>             傳輸層安全配置
                                       類型。範例:TCP/IP、
                                       SSL-Supported 和 SSL-Required。

  -user,--username <username>            eXtreme Scale 使用者名稱安全
                                       認證
用法:xscmd -c <cmdName> | -h <cmdName> | -lc [<cmdGroupName>] | -lcg
             [-cgc <className>] [-ca <support>] [-sp <profileName>] [-ks
             <filePath>] [-ts <filePath>] [-trf <filePath>] [-prot <protocol>]
             [-cxpv <provider>] [-trs <traceSpec>] [-al <alias>] [-pwd
             <password>] [-tsp <password>] [-cep <endpoints>] [-ksp <password>]
             [-arc <integer>] [-tt <type>] [-tst <type>] [-ssp <profileName>]
             [-kst <type>] [-cgp <property>] [-user <username>]
選項:
 -al,--alias <alias>                    金鑰儲存庫中的別名。
 -arc,--authRetryCount <integer>        鑑別的重試次數(當
                                        認證過期時)。如果將值
                                        設為 0,則將不再
                                        重試鑑別。
 -c,--command <cmdName>                 指定要執行之指令的
                                        名稱
 -ca,--credAuth <support>               設定用戶端認證鑑別
                                        支援 [Never、Supported 和 Required]。
 -cep,--catalogEndPoints <endpoints>    指定一個以上的目錄服務
                                        端點,格式為
                                        <host>[:<listenerPort>][,<host>[:<listen
                                        erPort>]]。預設端點:
                                        localhost:2809
 -cgc,--credGenClass <className>        指定用來實作 CredentialGenerator
                                        介面之類別的
                                        名稱。此類別用於取得
                                        用戶端的認證。
 -cgp,--credGenProps <property>         指定 CredentialGenerator
                                        實作類別的
                                        內容。將該內容設為
                                        使用 setProperties(String)
                                       方法的物件。
 -cxpv,--contextProvider <provider>     環境定義提供者。範例:IBMJSSE2、
                                        IBMJSSE 和 IBMJSSEFIPS。
 -h,--help <cmdName>                    呼叫一般指令行說明
 -ks,--keyStore <filePath>              金鑰儲存庫的絕對路徑。範例:
                                                                                /etc/test/security/server.public
 -ksp,--keyStorePassword <password>     指定金鑰儲存庫的密碼。
 -kst,--keyStoreType <type>             金鑰儲存庫類型。範例:JKS、JCEK 和
                                        PKCS12。
 -lc,--listCommands <cmdGroupName>      列出指令群組的所有指令
 -lcg,--listCommandGroups               列出所有指令群組
 -prot,--protocol <protocol>            通訊協定。範例:SSL、SSLv2、SSLv3、
                                        TLS 和 TLSv1。
 -pwd,--password <password>             eXtreme Scale 密碼安全
                                        認證
 -sp,--secProfile <profileName>         指定設定檔名稱。
 -ssp,--saveSecProfile <profileName>    將安全參數值儲存在
                                        安全設定檔中。
 -trf,--traceFile <filePath>             為 xscmd 指令輸出指定
                                        所產生之追蹤檔的
                                        絕對路徑
 -trs,--traceSpec <traceSpec>           為 xscmd 指令輸出指定
                                        追蹤規格
 -ts,--trustStore <filePath>            信任儲存庫的絕對路徑。範例:
                                                                                /etc/test/security/server.public
 -tsp,--trustStorePassword <password>   信任儲存庫密碼
 -tst,--trustStoreType <type>           信任儲存庫類型。範例:JKS、JCEK 和
                                        PKCS12。
 -tt,--transportType <type>             傳輸層安全配置
                                        類型。範例:TCP/IP、SSL-Supported 和
                                        SSL-Required。
 -user,--username <username>            eXtreme Scale 使用者名稱安全
                                        認證

所有指令

xscmd 公用程式的完整指令清單如下。如需特定指令的進一步說明及參數,請執行 xscmd -h command_name
指令名稱           說明
------------           -----------
balanceShardTypes      嘗試執行 Shard 重新配送,以便每一個
                       儲存器伺服器內的主要及抄本的比率在
                       一個 Shard 內。

balanceStatus          檢查所指定之 ObjectGrid 和對映集的
                       資料網格平衡狀態。

clearGrid              從資料網格中清除資料。

dismissLink            切斷與所指定之目錄服務網域的連線。

establishLink          使用所指定的目錄服務端點,
                       連接至所指定的目錄服務網域。

findByKey              在對映中尋找相符金鑰。

getCatTraceSpec        擷取此程序所知道之所有目錄伺服器的
                       追蹤規格。

getStatsSpec           擷取統計資料規格。

getTraceSpec           擷取追蹤規格。

listAllJMXAddresses    顯示所有 JMX MBean 伺服器位址。

listCoreGroups         列出所有核心群組。

listHosts              列出所有主機。

listObjectGridNames    列出所有已知 ObjectGrid 實例及對映集。

listProfiles           列出設定檔。

osgiAll                顯示所有可用的 OSGi 服務等級。使用 -sn
                       選項來顯示單一服務。

osgiCheck              檢查所指定的 OSGi 服務等級是否
                       可用

osgiCurrent            顯示目前使用中的所有 OSGi 服務等級。使用
                       -sn 選項來顯示單一服務。

osgiUpdate             將 OSGi 服務更新為指定的等級

overrideQuorum         通知目錄伺服器置換額定。

placementServiceStatus 顯示 ObjectGrid 放置作業狀態。

releaseShard           從指定的儲存器伺服器釋放
                       指定的主要 Shard。

removeProfile          從檔案系統移除設定檔。

reserveShard           在指定的儲存器伺服器上保留
                       指定的主要 Shard。

resumeBalancing        嘗試平衡,並容許將來對所指定的
                       ObjectGrid 實例和對映集進行
                       平衡嘗試。
revisions              顯示所有已知修訂歷程。

routetable             顯示現行遞送表。

setCatTraceSpec        設定此程序所知道之所有目錄伺服器的
                       追蹤規格。

setStatsSpec           設定統計資料規格。

setTraceSpec           追蹤規格,格式為:
                       traceType1=traceLevel1=traceState1[:traceTypeN=traceLev
                       elN=traceStateN]*

showCoreGroupMembers   顯示所有核心群組成員。

showInfo               擷取環境規格,包括
                       已安裝的版本及 JVM 資訊。

showLinkedPrimaries    顯示主要 Shard 以及它們的
                       所有外部或專用鏈結的主要 Shard

showMapSizes           顯示所有對映大小。

showPlacement          列出所有儲存器伺服器及其 Shard。

showProfile            顯示所指定之設定檔的詳細資料。

showQuorumStatus       顯示目錄伺服器額定狀態。

suspendBalancing       防止將來嘗試對 ObjectGrid 實例和對映集
                       執行平衡。

swapShardWithPrimary   將指定儲存器伺服器的指定抄本 Shard
                       與其主要 Shard 進行交換。

teardown               停止目錄伺服器及儲存器伺服器清單。

triggerPlacement       對指定的 ObjectGrid 實例和對映集
                       觸發放置作業。將忽略
                       numInitialContainers 值。
指令名稱           說明
------------           -----------
balanceShardTypes      嘗試執行 Shard 重新配送,以便每一個
                       儲存器伺服器內的主要及抄本的比率在
                       一個 Shard 內。

balanceStatus          檢查所指定之 ObjectGrid 和對映集的
                       網格平衡狀態

clearGrid              從資料網格中清除資料。

dismissLink            切斷與所指定之目錄服務網域的連線。

establishLink          使用所指定的目錄服務端點,
                       連接至所指定的目錄服務網域。

getCatTraceSpec        擷取此程序所知道之所有目錄伺服器的
                       追蹤規格。

getStatsSpec           擷取統計資料規格。

getTraceSpec           擷取追蹤規格。

listAllJMXAddresses    顯示所有 JMX MBean 伺服器位址。

listCoreGroups         列出所有核心群組。

listHosts              列出所有主機。

listObjectGridNames    列出所有已知 ObjectGrid 實例及對映集。

listProfiles           列出設定檔。

osgiAll                顯示所有可用的 OSGi 服務等級。使用 -sn
                       選項來顯示單一服務。

osgiCheck              檢查所指定的 OSGi 服務等級是否
                       可用

osgiCurrent            顯示目前使用中的所有 OSGi 服務等級。使用
                       -sn 選項來顯示單一服務。

osgiUpdate             將 OSGi 服務更新為指定的等級

overrideQuorum         通知目錄伺服器置換額定。

placementServiceStatus 顯示 ObjectGrid 放置作業狀態。

releaseShard           從指定的儲存器伺服器釋放
                       指定的主要 Shard。

removeProfile          從檔案系統移除設定檔。

reserveShard           在指定的儲存器伺服器上保留
                       指定的主要 Shard。

resumeBalancing        嘗試平衡,並容許將來對所指定的
                       ObjectGrid 實例及對映集執行平衡。

revisions              顯示所有已知修訂歷程。

routetable             顯示現行遞送表。

setCatTraceSpec        設定此程序所知道之所有目錄伺服器的
                       追蹤規格。

setStatsSpec           設定統計資料規格。

setTraceSpec           追蹤規格,格式為:
                       traceType1=traceLevel1=traceState1[:traceTypeN=traceLevelN=traceStateN]*

showCoreGroupMembers   顯示所有核心群組成員。

showLinkedPrimaries    顯示主要 Shard 以及它們的
                       所有外部或專用鏈結的主要 Shard

showMapSizes           顯示所有對映大小。

showPlacement          列出所有儲存器伺服器及其 Shard。

showProfile            顯示所指定之設定檔的詳細資料。

showQuorumStatus       顯示目錄伺服器額定狀態。

suspendBalancing       防止將來嘗試對 ObjectGrid 實例和對映集
                       執行平衡。

swapShardWithPrimary   將指定儲存器伺服器的指定抄本 Shard
                       與其主要 Shard 進行交換。

teardown               停止目錄伺服器及儲存器伺服器清單。

triggerPlacement       對指定的 ObjectGrid 實例和對映集
                       觸發放置作業。將忽略
                       numInitialContainers 值。