可通过两种不同方法向 xsadmin 实用程序传递参数:通过命令行参数或通过属性文件。
对于 WebSphere® eXtreme Scale Client V7.1 修订包 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 环境中的容器服务器,请使用以下格式:
与以下参数一起使用:-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 环境中的应用程序服务器,请使用以下格式:
与以下参数一起使用:-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:sap。protocol 和 sap
变量定义如下:
|
-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 配置不适用。 |
不适用 | 显示您的配置的已配置放置和运行时放置。可将输出作用域设置为数据网格和映射集的组合,或者,对于整个配置:
|
|
-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.setStatsSpec 和 DynamicServerMBean.getStatsSpec 方法。 允许以下过滤器: -fm -fst -fc -fz -fs -fh -fp |
-suspendBalancing <objectgrid_name> <map_set_name> |
不适用 | 阻止以后均衡指定 ObjectGrid 实例和映射集的尝试。 |
-ssl | 不适用 | 指示已启用安全套接字层 (SSL)。 |
-teardown | 不适用 | 允许以下过滤器: -fst -fc -fz -fs -fh -fp
此命令行参数对 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 参数会过滤此方法的输出,并将数据组织为更可用的格式。 |