xsadmin 实用程序引用

可通过两种不同方法向 xsadmin 实用程序传递参数:通过命令行参数或通过属性文件。

xsadmin 参数

对于 WebSphere® eXtreme Scale Client V7.1 修订包 1 或更高版本,可对 xsadmin 实用程序定义属性文件。通过创建属性文件,可保存一些常用参数,例如,用户名。下表包含了可添加至属性文件的属性。如果同时在属性文件和等价命令行参数中指定一个属性,那么命令行参数值将覆盖属性文件值。

表 1. xsadmin 实用程序的参数
命令行参数 属性文件中的等价属性名 描述和有效值
-bp 不适用

指示侦听器端口。

缺省值:2809

-ch 不适用

指示目录服务器的 JMX 主机名。

缺省值:localhost

-clear 不适用

清除指定映射。

允许以下过滤器: -fm

-containers 不适用 对于每个数据网格和映射集,请显示容器服务器的列表。

允许以下过滤器:-fnp

-continuous 不适用 如果希望得到连续的映射大小结果来监视数据网格,请指定此标志。带 -mapsizes 参数运行此命令时,映射大小每 20 秒显示一次。
-coregroups 不适用 显示目录服务器的所有核心组。此参数用于高级诊断。
-dismissLink <catalog_service_domain> 不适用

此命令行参数对 WebSphere DataPower® XC10 Appliance 配置不适用。

-dmgr 不适用

此命令行参数对 WebSphere DataPower XC10 Appliance 配置不适用。

-empties 不适用 如果希望在输出中显示空容器,请指定此标志。
-establishLink <foreign_domain_name> <host1:port1,host2:port2...> 不适用

此命令行参数对 WebSphere DataPower XC10 Appliance 配置不适用。

-fc 不适用 仅对此容器进行过滤。
如果您要过滤 WebSphere Application Server Network Deployment 环境中的容器服务器,请使用以下格式:
<cell_name>/<node_name>/<serverName_containerSuffix>

与以下参数一起使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec

-fh 不适用 仅对此主机进行过滤。

与以下参数一起使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec-routetable

-fm 不适用 仅对此映射进行过滤。

与以下参数一起使用:-clear-mapsizes

-fnp 不适用 过滤没有主 Shard 的服务器。

与以下参数一起使用:-containers

-fp 不适用 仅对此分区进行过滤。

与以下参数一起使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec-routetable

-fs 不适用 仅对此服务器进行过滤。
如果您要过滤 WebSphere Application Server Network Deployment 环境中的应用程序服务器,请使用以下格式:
<cell_name>/<node_name>/<server_name>

与以下参数一起使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec

-fst 不适用 仅对此 Shard 类型进行过滤。仅对主 Shard 指定 P,仅对异步副本 Shard 指定 A,仅对同步副本 Shard 指定 S。

与以下参数一起使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec

-fz 不适用 仅对此区域进行过滤。

与以下参数一起使用:-mapsizes-teardown-revisions-getTraceSpec-setTraceSpec-getStatsSpec-setStatsSpec-routetable

-force 不适用 强制执行命令中的操作,禁用任何抢先提示。此参数在运行成批命令时很有用。
-g 不适用 指定 ObjectGrid 名称。
-getstatsspec 不适用 显示当前统计信息规范。可使用 -setstatsspec 参数设置统计信息规范。

允许以下过滤器: -fst -fc -fz -fs -fh -fp

-getTraceSpec 不适用 显示当前跟踪规范。可使用 -settracespec 参数来设置跟踪规范。

允许以下过滤器: -fst -fc -fz -fs -fh -fp

-h 不适用 显示 xsadmin 实用程序的帮助,其中包括参数列表。
-hosts 不适用 显示配置中的所有主机。
-jmxUrl XSADMIN_JMX_URL 按以下格式指定 JMX API 连接器服务器的地址:service:jmx:protocol:sapprotocolsap 变量定义如下:
protocol
指定连接至连接器服务器时要使用的传输协议。
sap
指定找到连接器服务器的地址。
有关 JMX 服务 URL 的格式的更多信息,请参阅类 JMXServiceURL (Java 2 Platform SE 5.0)。
-l 不适用 显示所有已知数据网格和映射集。
-m 不适用 指定映射集的名称。
-mapsizes 不适用 显示目录服务器上的每个映射的大小以验证键分布在 Shard 上是否统一。

允许以下过滤器: -fm -fst -fc -fz -fs -fh -fp

-mbeanservers 不适用 显示所有 MBean Server 端点的列表。
-overridequorum 不适用

此命令行参数对 WebSphere DataPower XC10 Appliance 配置不适用。

-password XSADMIN_PASSWORD 指定用于登录 xsadmin 实用程序的密码。如果希望保持密码安全,请不要在属性文件中指定该密码。
-p 不适用

此命令行参数对 WebSphere DataPower XC10 Appliance 配置不适用。

  不适用 显示您的配置的已配置放置和运行时放置。可将输出作用域设置为数据网格和映射集的组合,或者,对于整个配置:
  • 整个配置:
    -placementStatus
  • 对于特定数据网格:
    -placementStatus -g my_grid
  • 对于特定映射集:
    -placementStatus -m my_mapset
  • 对于特定数据网格和映射集:
    -placementStatus  -g my_grid 
    -m my_mapset
-primaries 不适用 显示主 Shard 的列表。
-profile 不适用 指定 xsadmin 实用程序的属性文件的标准路径。
-quorumstatus 不适用

此命令行参数对 WebSphere DataPower XC10 Appliance 配置不适用。

-releaseShard <container_server_name> <objectgrid_name> <map_set_name> <partition_name> 不适用 -reserveShard 参数结合使用。 保留并放置 shard 之后,必须调用 -releaseShard 参数。. -releaseShard 参数调用 ContainerMBean.release() 方法。
-reserved 不适用 -containers 参数一起使用,以仅显示已使用 -reserveShard 参数保留的 shard。
-reserveShard <container_server_name> <objectgrid_name> <map_set_name> <partition_name> 不适用 将主 shard 移动到指定容器服务器。ContainerMBean.reserve() 方法由此参数调用。

-resumeBalancing <objectgrid_name> <map_set_name>

不适用 尝试均衡请求。允许以后在指定 ObjectGrid 和映射集上进行重新均衡尝试。
-revisions 不适用 显示目录服务域的修订标识,包括:每个数据网格、分区号、分区类型(主分区或副本分区)、目录服务域、生存期标识以及每个特定 Shard 的数据修订版数。您可以使用此参数来确定是否捕获了异步副本或已链接的域。此参数调用 ObjectGridMBean.getKnownRevisions() 方法。

允许以下过滤器: -fst -fc -fz -fs -fh -fp

-routetable 不适用 从客户机服务器角度显示数据网格的当前状态。路由表是 ObjectGrid 客户机服务器用来与数据网格进行通信的信息。当您尝试确定连接问题或 TargetNotAvailable 异常时,请将路由表用作诊断辅助。

必需的参数:在独立的环境中,如果您没有对引导程序侦听器端口和目录服务器主机的 JMX 端口使用缺省值,那么必须与此参数一起指定 -bp-p 参数。

允许以下过滤器:-fz -fh -fp

-settracespec <trace_string> 不适用

此命令行参数对 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>

不适用 将指定容器服务器中的指定副本 shard 与其主 shard 进行交换。通过运行此命令,您可以根据需要手动均衡主 shard。
-setstatsspec <stats_spec> 不适用 启用统计信息收集。此参数调用 DynamicServerMBean.setStatsSpecDynamicServerMBean.getStatsSpec 方法。

允许以下过滤器: -fm -fst -fc -fz -fs -fh -fp

-suspendBalancing <objectgrid_name> <map_set_name>

不适用 阻止以后均衡指定 ObjectGrid 实例和映射集的尝试。
-ssl 不适用 指示已启用安全套接字层 (SSL)。
-teardown 不适用

允许以下过滤器: -fst -fc -fz -fs -fh -fp

用于提供服务器列表的格式:
server_name_1,server_name_2 ...
要在区域中停止所有服务器,请添加 -fz 参数:
–fz <zone_name>
要在主机上停止所有服务器,请添加 -fh 参数:
–fh <host_name>

此命令行参数对 WebSphere DataPower XC10 Appliance 配置不适用。

  不适用 强制运行 Shard 放置,忽略部署 XML 文件中已配置的 numInitialContainers 值。当您在服务器上执行维护时,即使 numInitialContainers 值低于已配置值,也可使用此参数来允许 shard 放置继续运行。
-trustPass XSADMIN_TRUST_PASS 指定所指定信任库的密码。
-trustPath XSADMIN_TRUST_PATH 指定信任库文件的路径。

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

-trustType XSADMIN_TRUST_TYPE 指定信任库的类型。

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

-unassigned 不适用 显示不能放置在数据网格上的 Shard 的列表。放置服务具有阻止放置的约束时,不能放置 Shard。
-username XSADMIN_USERNAME 指定用于登录 xsadmin 实用程序的用户名。
-v 不适用 启用详细命令行操作。如果您在使用环境变量和/或属性文件来指定某些命令行参数,并且希望查看它们的值,请使用此标志。
-xml 不适用 打印来自 PlacementServiceMBean.listObjectGridPlacement() 方法的未经过滤的输出。其他 xsadmin 参数会过滤此方法的输出,并将数据组织为更可用的格式。