Application Server 包含一个称为 asadmin 的命令行管理实用程序。asadmin 实用程序用于启动和停止 Application Server,同时也可用于管理用户、资源和应用程序。
本章包括以下各节:
使用 asadmin 实用程序可以执行 Application Server 的所有管理任务。您可以使用此 asadmin 实用程序来代替管理控制台。
asadmin 实用程序将调用可标识您希望执行的操作或任务的命令。这些命令区分大小写。短选项参数具有单个破折号 (-),而长选项参数具有两个破折号 (--)。选项用于控制实用程序执行命令的方式。选项也区分大小写。大多数选项都需要参数值,但是可在功能 ON 或 OFF 之间切换的布尔选项除外。操作数出现在参数值后面,并且以空格、制表符或双破折号 (--) 分隔。asadmin 实用程序将跟在选项及其值后面的任何内容都视为操作数。
asadmin command [-short_option] [short_option_argument]* [--long_option [long_option_argument]* [operand]*
asadmin create-profiler -u admin --passwordfile password.txt myprofiler
要在 Solaris 平台上访问 Application Server asadmin 实用程序命令的手册页,请将 $AS_INSTALL/man 添加到 MANPATH 环境变量中。
您可以通过调用 --help 选项来获取任何 asadmin 实用程序命令的全部用法信息。如果指定一条命令,则会显示此命令的用法信息。使用不带命令的 --help 选项将显示所有可用命令的列表。
asadmin --help 显示一般帮助
asadmin command --help 显示指定命令的帮助。
本节包括以下主题:
asadmin 实用程序可以用于命令 shell 调用或多命令模式(称为 multimode 命令)。在命令 shell 调用中,从命令 shell 调用 asadmin 实用程序。asadmin 将执行命令,然后退出。在多命令模式中,调用 asadmin 一次后,它将接受多个命令,直至您退出 asadmin 并返回到常规命令 shell 调用。在处于多命令模式时设置的环境变量将用于所有的后续命令,直至您退出 multimode。可以通过从文件或标准输入(管道)传递先前准备好的命令列表来提供命令。此外,您可以从多模式会话中调用 multimode;当您退出第二个多模式环境之后,将返回到原先的多模式环境。
您还可以在交互或非交互模式下运行 asadmin 实用程序。默认情况下,启用交互模式选项。它提示您提供必需的参数。在任何情况下,您都可以在命令 shell 调用中使用交互模式选项。当您在命令提示符下一次运行一条命令时,以及从某个文件中运行时,您可以在 multimode 中使用交互模式选项。在 multimode 中,来自某个输入流的命令以及通过另一个程序调用的命令无法在交互模式下运行。
本地命令可以在不存在管理服务器的情况下执行。但是,用户必须登录到托管域的计算机才能执行命令,并且必须对安装目录和域目录具有访问(权限)。
对于可以在本地或远程执行的命令,如果设置了 --host、--port、--user 和 --passwordfile 选项中的任何一个选项,则无论在环境中还是在命令行中,命令都将以远程模式运行。此外,如果未设置任何本地选项,则无论在命令行中还是在环境中,默认情况下命令都将在本地执行。
远程命令始终通过连接到管理服务器并在其中执行命令来执行。需要使用正在运行的管理服务器。所有远程命令都需要以下通用选项:
表 19–1 远程命令所需的选项
短选项 |
选项 |
定义 |
---|---|---|
-H |
--host |
运行域管理服务器的计算机名。默认值为 localhost。 |
-p |
--port |
用于管理的 HTTP/S 端口。这是为了管理域而应当将浏览器指向的端口。例如,http://localhost:4848。对于 Platform Edition,默认端口号为 4848。 |
-u |
--user |
授权的域管理服务器管理用户名。如果您已经使用 asadmin login 命令通过域验证,则对此特定域执行后续操作时,不需要指定 --user 选项。 |
--passwordfile |
-‐passwordfile 选项指定包含特定格式密码条目的文件的名称。密码条目必须具有 AS_ADMIN_ 前缀,后跟采用大写字母的密码名。 例如,要指定域管理服务器密码,请使用具有以下格式的条目:AS_ADMIN_PASSWORD=password,其中 password 是实际的管理员密码。可以指定的其他密码包括 AS_ADMIN_PASSWORD、AS_ADMIN_USERPASSWORD、AS_ADMIN_ALIASPASSWORD 和 AS_ADMIN_MAPPEDPASSWORD。 所有远程命令都必须通过 -‐passwordfile 或 asadmin login,或在命令提示符下通过交互方式来指定管理密码才能通过域管理服务器验证。asadmin login 命令只能用来指定管理密码。对于必须为远程命令指定的其他密码,请使用 -‐passwordfile 或在命令提示符下输入这些密码。 如果您已使用 asadmin login 命令通过域验证,则对此特定域执行后续操作时,不需要通过 -‐passwordfile 选项指定管理密码。不过,这仅适用于 AS_ADMIN_PASSWORD 选项。您仍需要提供其他密码,例如在个别命令(如 update-file-user)需要时提供 AS_ADMIN_USERPASSWORD。 为了安全起见,指定为环境变量的密码不能通过 asadmin 读取。 |
|
-s |
--secure |
如果设置为 true,则使用 SSL/TLS 与域管理服务器通信。 |
-I |
--interactive |
如果设置为 true(默认值),则仅提示必需的密码和用户选项。 |
-t |
--terse |
指示任何输出数据都必须非常简明,通常在脚本中避免使用用户友好的句子,而支持使用格式完好的数据。默认值为 false。 |
-e |
--echo |
如果设置为 true,将在标准输出中回显命令行语句。默认值为 false。 |
-h |
--help |
显示命令的帮助文本。 |
为了安全起见,可以从文件中为命令设置密码,而不要在命令行输入密码。--passwordfile 选项用于指定包含密码的文件。文件的有效内容为:
AS_ADMIN_PASSWORD=value AS_ADMIN_ADMINPASSWORD=value AS_ADMIN_USERPASSWORD=value AS_ADMIN_MASTERPASSWORD=value |
使用 multimode 命令可以处理 asadmin 命令。命令行界面将提示您输入某个命令,执行此命令,显示此命令的结果,然后提示您输入下一个命令。此外,在此模式下设置的所有 asadmin 选项名称都将用于所有后续命令。您可以设置环境并运行命令,直至通过键入 "exit" 或 "quit" 退出 multimode。您还可以通过从文件或标准输入(管道)传递先前准备好的命令列表来提供命令。您可以从多模式会话中调用 multimode;当您退出第二个多模式环境之后,将返回到原先的多模式环境。
要调用 multimode,请输入 asadmin multimode。
asadmin list、get 和 set 命令串联使用可以为 Application Server 的点式命名分层结构提供导航机制。有两个分层结构:配置和监视,可以对它们运行这些命令。list 命令可为具有只读或可修改属性的管理组件提供全限定带点名称。
配置分层结构提供可修改属性,而监视分层结构中管理组件的属性完全为只读属性。配置分层结构并不严格基于域的模式文档,而监视分层结构稍有不同。
使用 list 命令可以访问所需分层结构中的特定管理组件。随后,调用 get 和 set 命令可以立即获取管理组件的属性的名称和值,或设置这些属性的值。使用通配符 (*) 选项可以获取给定全限定带点名称中的所有匹配项。
Application Server 带点名称使用 "."(句点)作为分界符来分隔完整名称的各部分。这与 UNIX 文件系统中使用 "/" 字符来分隔文件绝对路径名的各级别的方式类似。当形成 get、set 和 list 命令可接受的带点名称时,以下规则适用。请注意,特定命令将应用某些附加语义。
.(句点)始终分隔名称的两个连续部分。
名称的一部分通常标识应用服务器子系统和/或其特定实例。例如:web-container、log-service、thread-pool-1 等。
如果名称的任一部分本身包含 .(句点),则必须使用前导 \(反斜杠)对其进行转义,以使 "." 不用作分界符。
*(星号)可以用于带点名称中的任意位置,它的作用与正则表达式中的通配符类似。此外,* 可以折叠带点名称的所有部分。可以将 "<classname>this.is.really.long.hierarchy </classname>" 之类的长带点名称缩写为 "<classname>th*.hierarchy</classname>"。但请注意,. 始终用于分隔名称的各部分。
在 Solaris 上,当执行将 * 作为选项值或操作数的命令时,需要使用引号。
任何带点名称的顶层开关均为 -‐monitor 或 -m,此开关将在给定命令行中单独指定。此开关的有无意味着针对应用服务器管理选择两种分层结构的其中一种:监视和配置。
如果您碰巧知道确切的完整带点名称(不带任何通配符),则 list 和 get/set 在语义方面稍有不同:
list 命令将此完整带点名称视为分层结构中某个父节点的完整名称。将此名称提供给 list 命令时,此命令仅返回该级别的直接子节点的名称。例如,list server.applications.web-module 将列出部署到域或默认服务器的所有 Web 模块。
get 和 set 命令将此完整带点名称视为某个节点(其带点名称本身是您在删除此带点名称的最后一部分时获得的名称)的属性的全限定名称,并获取/设置此属性的值。如果存在此类属性,则为 true。但从不会出现这种情况,因为为了查找分层结构中某个特定节点的属性的名称,必须使用通配符 *。例如,server.applications.web-module.JSPWiki.context-root* 将返回部署到域或默认服务器的 Web 应用程序的上下文根目录。
list 命令是这三个命令的导航功能的起源。如果要 set 或 get 某个特定应用服务器子系统的属性,则必须知道此子系统的带点名称。可以借助 list 命令来查找此子系统的带点名称。以查找某个以 / 开头的大型文件系统中特定文件的修改日期(属性)为例,您必须首先找出此文件在文件系统中的位置,然后再查看其属性。因此,用于了解 Application Server 中分层结构的前两个命令为:* list "*" 和 <command>* list * -‐monitor。请查阅 get、set 或 list 命令的手册页,以确定这些命令的有序输出。
服务器生命周期命令是指用于创建、删除、启动或停止域、服务 (DAS) 或实例的命令。
表 19–2 服务器生命周期命令
命令 |
定义 |
---|---|
create-service |
配置自动引导时 DAS 的启动。在 Solaris 10 上,此命令使用服务管理工具 (Service Management Facility, SMF)。这是本地命令,必须以具有超级用户权限的 OS 级用户身份运行。此命令仅可用于 Solaris 10。创建服务时,用户必须启动、启用、禁用、删除或停止服务。DAS 必须存储在超级用户有权访问的文件夹中。不能将配置存储在网络文件系统中。创建服务,以使它受操作系统级用户(该用户拥有 DAS 配置所在文件夹)控制。要运行此命令,您必须具有 solaris.smf.* 授权。 |
create-domain |
创建域的配置。域是管理名称空间。每个域都有一种配置,此配置存储在一组文件中。可以在给定的 Application Server 安装中创建任意数量的域,每个域都有一个特定的管理身份。一个域可以独立于其他域存在。任何有权访问给定系统上 asadmin 实用程序的用户都可以创建域,并将其配置存储在所选的文件夹中。默认情况下,在 install_dir/domains 目录中创建域配置。您可以覆盖此位置以将配置存储在其他位置。 |
delete-domain |
删除命名域。此域必须已存在并且必须已停止。 |
start-domain |
启动域。如果未指定域目录,则启动默认 install_dir/domains 目录中的域。如果存在两个或多个域,则必须指定 domain_name 操作数。 |
stop-domain |
停止指定域的域管理服务器。 |
restore-domain |
从备份目录恢复域下的文件。 |
list-domains |
列出域。如果未指定域目录,则列出默认 install_dir/domains 目录中的域。如果存在多个域,则必须指定 domain_name 操作数。 |
backup-domain |
备份命名域下的文件。 |
list-backups |
显示有关备份系统信息库中所有备份的状态信息。 |
shutdown |
正常关闭管理服务器以及所有正在运行的实例。您必须手动启动管理服务器才能再次启动它。 |
列表和状态命令显示已部署组件的状态。
表 19–3 列表和状态命令
命令 |
定义 |
show-component-status |
获取已部署组件的状态。状态为服务器所返回的字符串表示。可能的状态字符串包括 "status of app-name is enabled" 或 "status of app-name is disabled"。 |
list-components |
列出所有已部署的 Java EE 5 组件。如果未指定 --type 选项,则列出所有组件。 |
list-sub-components |
列出已部署的模块或已部署应用程序的模块中的 EJB 或 Servlet。如果未标识模块,则列出所有模块。 |
部署命令部署应用程序或获取客户机桩模块。
表 19–4 部署命令
命令 |
定义 |
---|---|
deploy |
部署企业应用程序、Web 应用程序、EJB 模块、连接器模块或应用程序客户机端模块。如果组件已部署或已存在,则在 -‐force 选项设置为 true 时会对其进行强制重新部署。 |
deploydir |
从开发目录直接部署应用程序。部署目录中必须存在符合 Java EE 规范的相应目录分层结构和部署描述符。 |
get-client-stubs |
将 AppClient 独立模块或包含 AppClient 模块的应用程序的客户机桩模块 JAR 文件从服务器获取到本地目录。在执行此命令之前,应部署应用程序或模块。也可以将客户机桩模块作为使用 --retrieve 选项的 deploy 命令的一部分获取。 |
undeploy |
删除指定的已部署组件。 |
Message Queue 管理命令可用于管理 JMS 目的地。
表 19–5 Message Queue 命令
命令 |
定义 |
---|---|
create-jmsdest |
创建 JMS 物理目的地。可以使用 create-jms-resource 命令连同物理目的地来创建 JMS 目的地资源,此资源具有指定物理目的地的 Name 属性。 |
delete-jmsdest |
删除指定的 JMS 目的地。 |
flush-jmsdest |
从指定目标的 JMS 服务配置的物理目的地中清除消息。 |
list-jmsdest |
列出 JMS 物理目的地。 |
jms-ping |
检查 JMS 服务(也称为 JMS 提供者)是否启动并运行。启动 Application Server 时,默认情况下会启动 JMS 服务。此外,它仅对 JMS 服务中的默认 JMS 主机执行 ping 操作。当它无法对内置 JMS 服务执行 ping 操作时,将显示错误消息。 |
资源命令可用于管理应用程序中使用的各种资源。
表 19–6 资源管理命令
命令 |
定义 |
---|---|
create-jdbc-connection-pool |
注册具有指定 JDBC 连接池名称的新 JDBC 连接池。 |
delete-jdbc-connection-pool |
删除 JDBC 连接池。操作数标识要删除的 JDBC 连接池。 |
list-jdbc-connection-pools |
获取已创建的 JDBC 连接池。 |
create-jdbc-resource |
创建新的 JDBC 资源。 |
delete-jdbc-resource |
删除具有指定 JNDI 名称的 JDBC 资源。 |
list-jdbc-resources |
显示已创建的 JDBC 资源的列表。 |
create-jms-resource |
创建 Java 消息服务 (Java Message Service, JMS) 连接工厂资源或 JMS 目的地资源。 |
delete-jms-resource |
删除指定的 JMS 资源。 |
list-jms-resources |
列出现有的 JMS 资源(目的地资源和连接工厂资源)。 |
create-jndi-resource |
注册 JNDI 资源。 |
delete-jndi-resource |
删除具有指定 JNDI 名称的 JNDI 资源。 |
list-jndi-resources |
标识所有的现有 JNDI 资源。 |
list-jndi-entries |
浏览并查询 JNDI 树。 |
create-javamail-resource |
创建 JavaMail 会话资源。 |
delete-javamail-resource |
删除指定的 JavaMail 会话资源。 |
list-javamail-resources |
列出现有的 JavaMail 会话资源。 |
create-persistence-resource |
注册持久性资源。 |
delete-persistence-resource |
删除持久性资源。当您删除持久性资源时,此命令也会删除使用 create-persistence-resource 命令创建的 JDBC 资源。 |
list-persistence-resources |
显示所有持久性资源。 |
create-custom-resource |
创建自定义资源。自定义资源指定实现 javax.naming.spi.ObjectFactory 接口的自定义服务器范围资源对象工厂。 |
delete-custom-resource |
删除自定义资源。 |
list-custom-resources |
列出自定义资源。 |
create-connector-connection-pool |
添加具有指定连接池名称的新连接器连接池。 |
delete-connector-connection-pool |
删除使用操作数 connector_connection_pool_name 指定的连接器连接池。 |
list-connector-connection-pools |
列出已创建的连接器连接池。 |
create-connector-resource |
注册具有指定 JNDI 名称的连接器资源。 |
delete-connector-resource |
删除具有指定 JNDI 名称的连接器资源。 |
list-connector-resources |
获取所有连接器资源。 |
create-admin-object |
添加具有指定 JNDI 名称的受管对象。 |
delete-admin-object |
删除具有指定 JNDI 名称的受管对象。 |
list-admin-objects |
列出所有受管对象。 |
create-resource-adapter-config |
为连接器模块创建配置信息。 |
delete-resource-adapter-config |
删除在 domain.xml 中为连接器模块创建的配置信息。 |
list-resource-adapter-configs |
列出 domain.xml 中用于连接器模块的配置信息。 |
add-resources |
创建在指定 XML 文件中命名的资源。xml_file_path 是要创建的资源所在的 XML 文件的路径。应在 resources.xml 文件中将 DOCTYPE 指定为 install_dir/lib/dtds/sun-resources_1_2.dtd。 |
ping-connection-pool |
测试连接池是否可用于 JDBC 连接池和连接器连接池。例如,如果为希望随后部署的应用程序创建新的 JDBC 连接池,则在部署应用程序之前,将使用此命令对此 JDBC 池进行测试。在对连接池执行 ping 操作之前,必须创建通过验证的连接池,并且确保已启动 Application Server 或数据库。 |
配置命令可用于配置 Application Server 的操作。本节包括以下主题:
这些命令可用于管理 Application Server 组件的配置。
表 19–7 常用配置命令
命令 |
定义 |
enable |
启用指定的组件。如果组件已启用,则会重新启用它。组件必须已经部署才能启用。如果尚未部署组件,则会返回错误消息。 |
disable |
立即禁用命名组件。组件必须已经部署。如果尚未部署组件,则会返回错误消息。 |
export |
标记变量名称以便自动导出到后续命令的环境中。所有后续命令都使用指定的变量名称值,除非您对它们执行 unset 或退出 multimode。 |
get |
获取属性的名称和值。 |
set |
设置一个或多个可配置属性的值。 |
list |
列出可配置的元素。在 Solaris 上,当执行将 * 作为选项值或操作数的命令时,需要使用引号。 |
unset |
删除一个或多个为多模式环境设置的变量。变量及其关联值将不再存在于环境中。 |
HTTP 和 IIOP 侦听器命令可帮助您管理侦听器。这些命令仅在远程模式下受支持。
表 19–8 IIOP 侦听器命令
命令 |
定义 |
---|---|
create-http-listener |
添加新的 HTTP 侦听器。 |
delete-http-listener |
删除指定的 HTTP 侦听器。 |
list-http-listeners |
列出现有 HTTP 侦听器。 |
create-iiop-listener |
创建 IIOP 侦听器。 |
delete-iiop-listener |
删除指定的 IIOP 侦听器。 |
list-iiop-listeners |
列出现有 IIOP 侦听器。 |
create-ssl |
创建并配置选定 HTTP 侦听器、IIOP 侦听器或 IIOP 服务中的 SSL 元素,以便针对此侦听器/服务启用安全通信。 |
delete-ssl |
删除选定 HTTP 侦听器、IIOP 侦听器或 IIOP 服务中的 SSL 元素。 |
生命周期和审计模块命令可帮助您控制生命周期模块以及用于实现审计功能的可选插件模块。这些命令仅在远程模式下受支持。
表 19–9 生命周期模块命令
命令 |
定义 |
---|---|
create-lifecycle-module |
创建生命周期模块。生命周期模块提供一种用于在 Application Server 环境中运行短持续时间或长持续时间的基于 Java 的任务的方式。 |
delete-lifecycle-module |
删除指定的生命周期模块。 |
list-lifecycle-modules |
列出现有生命周期模块。 |
create-audit-module |
为实现审计功能的插件模块添加命名审计模块。 |
delete-audit-module |
删除命名审计模块。 |
list-audit-modules |
列出所有审计模块。 |
事件探查器和 JVM 选项命令可用于管理事件探查器并控制这些元素。这些命令仅在远程模式下受支持。
表 19–10 事件探查器和 JVM 选项命令
命令 |
定义 |
---|---|
create-profiler |
创建事件探查器元素。可以通过 Java 配置中的事件探查器元素将服务器实例绑定到特定事件探查器。更改事件探查器将要求您重新启动服务器。 |
delete-profiler |
删除您指定的事件探查器元素。可以通过 Java 配置中的事件探查器元素将服务器实例绑定到特定事件探查器。更改事件探查器将要求您重新启动服务器。 |
create-jvm-option |
在 Java 配置或 domain.xml 文件的事件探查器元素中创建 JVM 选项。如果为事件探查器创建 JVM 选项,则可以使用这些选项来记录运行特定事件探查器所需的设置。必须重新启动服务器才能使新创建的 JVM 选项生效。 |
delete-jvm-option |
从 Java 配置或 domain.xml 文件的事件探查器元素中删除 JVM 选项。 |
虚拟服务器命令可用于控制这些元素。这些命令仅在远程模式下受支持。
表 19–11 虚拟服务器命令
命令 |
定义 |
---|---|
create-virtual-server |
创建命名虚拟服务器。通过 Application Server 中的虚拟功能,可以使单个侦听多个主机地址的 HTTP 服务器进程处理多个 URL 域。如果在两个虚拟服务器上提供了应用程序,则这两个服务器仍共享相同的物理资源池。 |
delete-virtual-server |
删除具有指定虚拟服务器 ID 的虚拟服务器。 |
list-virtual-server |
列出现有虚拟服务器。 |
线程池命令可用于控制这些元素。这些命令仅在远程模式下受支持。
表 19–12 线程池命令
命令 |
定义 |
---|---|
create-threadpool |
创建具有指定名称的线程池。您可以指定池中的最大和最小线程数、工作队列数以及线程的空闲超时。可以使用创建的线程池来处理 IIOP 请求,并使资源适配器处理工作管理请求。所创建的线程池可以用于多个资源适配器。 |
delete-threadpool |
删除具有命名 ID 的线程池。 |
list-threadpools |
列出所有线程池。 |
事务和计时器命令可用于控制事务和计时器子系统,允许您暂停任何进行中的事务。这些命令仅在远程模式下受支持。
表 19–13 事务命令
命令 |
定义 |
---|---|
freeze-transaction |
在所有进行中的事务暂停期间冻结事务子系统。请在回滚任何进行中的事务之前调用此命令。对已经冻结的事务子系统调用此命令不会有任何作用。 |
unfreeze-transaction |
恢复所有已暂停的进行中事务。请对已经冻结的事务调用此命令。 |
recover-transactions |
手动恢复暂挂事务。 |
rollback-transaction |
回滚命名事务。 |
list-timers |
列出特定服务器实例所拥有的计时器。 |
这些用户命令可用于管理文件领域验证所支持的用户。这些命令仅在远程模式下受支持。
表 19–14 用户管理命令
命令 |
定义 |
---|---|
create-file-user |
在密钥文件中创建具有指定用户名、密码和组的条目。可以创建多个以冒号 (:) 分隔的组。 |
delete-file-user |
删除密钥文件中具有指定用户名的条目。 |
update-file-user |
使用指定 user_name、user_password 和组更新密钥文件中的现有条目。可以输入多个以冒号 (:) 分隔的组。 |
list-file-users |
创建文件领域验证所支持的文件用户的列表。 |
list-file-groups |
列出文件领域验证所支持的用户和组。此命令可列出文件用户中的可用组。 |
监视数据命令可用于监视服务器。这些命令仅在远程模式下受支持。
表 19–15 监视数据命令
命令 |
定义 |
---|---|
start-callflow-monitoring |
从 Web 容器、EJB 容器和 JDBC 收集数据并使其相关联,以便提供完整的请求调用流/路径。仅当 callflow-monitoring 为 ON 时才收集数据。 |
stop-callflow-monitoring |
禁用收集请求的调用流信息。 |
规则命令可用于管理服务器的规则。这些命令仅在远程模式下受支持。
表 19–16 规则命令
命令 |
定义 |
---|---|
create-management-rule |
创建新的管理规则,以便对 Application Server 安装和已部署的应用程序进行智能化自管理。 |
delete-management-rule |
删除您指定的管理规则。 |
list-management-rules |
列出可用的管理规则。 |
数据库命令可用于启动和停止 Java DB 数据库(基于 Apache Derby)。这些命令仅在本地模式下受支持。
表 19–17 数据库命令
命令 |
定义 |
---|---|
start-database |
启动随 Application Server 一起提供的 Java DB 服务器。仅可将此命令用于部署到 Application Server 中的应用程序。 |
stop-database |
停止 Java DB 服务器的进程。Java DB 服务器随 Application Server 一起提供。 |
诊断和日志记录命令可帮助您解决 Application Server 问题。这些命令仅在远程模式下受支持。
表 19–18 诊断和日志记录命令
命令 |
定义 |
---|---|
generate-diagnostic-report |
生成包含指向应用服务器安装详细信息(例如,应用服务器实例的配置详细信息、日志记录详细信息或进程特定信息)的指针或导航链接的 HTML 报告。 |
generate-jvm-report |
显示给定目标实例(包括域管理服务)的线程(堆栈追踪转储)、类和内存。此命令仅用于应用服务器实例进程。此命令取代了传统的技术(例如,将 ctrl+break 或 kill -3 信号发送到应用服务器进程)。如果目标服务器实例未处于运行状态,则此命令将不会起作用。 |
display-error-statistics |
显示自上次重新启动服务器以来 server.log 中严重级别和警告的汇总列表。 |
display-error-distribution |
显示模块级别的实例 server.log 中的错误分布。™ |
display-log-records |
显示标有给定时间戳的给定模块的所有错误消息。 |
Web 服务命令可用于监视已部署的 Web 服务和管理转换规则。
表 19–19 Web 服务命令
命令 |
定义 |
---|---|
configure-webservice-management |
配置已部署的 Web 服务端点的监视或 maxhistorysize 属性。 |
create-transformation-rule |
创建可应用于 Web 服务操作的 XSLT 转换规则。此规则可应用于请求、响应或同时应用于这两者。 |
delete-transformation-rule |
删除给定 Web 服务的 XSLT 转换规则。 |
list-transformation-rules |
按照规则的应用顺序列出给定 Web 服务的所有转换规则。 |
publish-to-registry |
将 Web 服务的辅件发布到注册表服务器。 |
unpublish-from-registry |
从注册表服务器中取消发布 Web 服务的辅件。 |
list-registry-locations |
显示已配置的 Web 服务条目访问点的列表。 |
这些安全性命令可用于控制连接器连接池的安全性映射。这些命令仅在远程模式下受支持。
表 19–20 安全性命令
命令 |
定义 |
---|---|
create-connector-security-map |
为指定连接器连接池创建安全性映射。如果不存在安全性映射,则会创建新的安全性映射。此外,使用此命令可以将应用程序调用方身份(主体或用户组)映射到基于容器管理事务的方案中适当的企业信息系统 (enterprise information system, EIS) 主体。可以将一个或多个命名的安全性映射与连接器连接池相关联。连接器安全性映射配置支持使用通配符星号 (*) 来表示所有用户或所有用户组。为使此命令成功运行,必须首先创建连接器连接池。EIS 是保存组织数据的任何系统。它可以是主机、消息传送系统、数据库系统或应用程序。 |
delete-connector-security-map |
删除指定连接器连接池的安全性映射。 |
update-connector-security-map |
修改指定连接器连接池的安全性映射。 |
list-connector-security-maps |
列出属于指定连接器连接池的安全性映射。 |
create-message-security-provider |
允许管理员为给定消息层(用于为 Application Server 指定参数和属性的 domain.xml 文件的 message-security-config 元素)创建 provider-config 子元素。 |
delete-message-security-provide |
允许管理员为给定消息层(用于为 Application Server 指定参数和属性的 domain.xml 文件的 message-security-config 元素)删除 provider-config 子元素。 |
list-message-security-providers |
允许管理员为给定消息层(domain.xml 的 message-security-config 元素)列出所有安全性消息提供者(provider-config 子元素)。 |
create-auth-realm |
添加命名验证领域。 |
delete-auth-realm |
删除命名验证领域。 |
list-auth-realms |
列出现有验证领域。 |
密码命令可用于管理密码和确保 Application Server 的安全性。
表 19–21 密码命令
命令 |
定义 |
---|---|
create-password-alias |
创建密码别名并将其存储在 domain.xml 中。别名是格式为 ${ALIAS=password-alias-password} 的令牌。与别名相对应的密码以加密的形式存储。此命令可以采用安全交互形式(提示用户提供所有信息)和更为脚本友好的形式(在命令行中传播密码)。 |
delete-password-alias |
删除密码别名。 |
update-password-alias |
更新命名目标中的密码别名 ID。 |
list-password-aliases |
列出所有密码别名。 |
change-admin-password |
此远程命令用于修改管理密码。此命令为交互式命令,提示用户提供旧的和新的管理密码(并进行确认)。 |
change-master-password |
此本地命令用于修改主密码。此命令为交互式命令,提示用户提供旧的和新的主密码。此命令在服务器停止时才有效。 |
XML 检验命令用于检验 domain.xml 文件的内容。
表 19–22 检验 domain.xml 命令
命令 |
定义 |
---|---|
verify-domain-xml |
检验 domain.xml 文件的内容。 |
MBean 命令可用于管理和注册自定义 MBean。这些命令仅在远程模式下受支持。
表 19–23 自定义 MBean 命令
命令 |
定义 |
---|---|
create-mbean |
创建并注册自定义 MBean。如果目标 MBeanServer (DAS) 未运行,则无法注册 MBean。 |
delete-mbean |
删除自定义 MBean。请确保目标 MBeanServer 处于运行状态。 |
list-mbeans |
列出指定目标的自定义 MBean。 |
杂项命令可用于管理 Application Server 的各个方面。
表 19–24 杂项命令
命令 |
定义 |
---|---|
login |
使您登录到某个域中。如果在不同的计算机上(本地)创建了各种应用服务器域,则从其中任何一台计算机中调用 asadmin 都可以管理位于其他位置(远程)的域。当您选择某台特定计算机作为管理客户机,并使用它来管理多个域和服务器时,这种方法就尤为方便。用于管理位于其他位置的域的 asadmin 命令称为远程命令。使用 asadmin login 命令可以轻松管理此类远程域。login 命令仅在交互模式下运行。它将提示您提供管理用户名和密码。成功登录后,将在用户的主目录中创建文件 .asadminpass。此文件与使用 -‐savelogin 选项时通过 create-domain 命令修改的文件是同一个文件。域必须处于运行状态,才能运行此命令。 |
version |
显示版本信息。如果此命令无法与具有给定用户/密码和主机/端口的管理服务器通信,此命令将在本地检索版本并显示警告消息。 |
help |
显示所有 asadmin 实用程序命令的列表。指定命令可以显示此命令的用法信息。 |
install-license |
防止未经授权使用 Application Server。允许您安装许可证文件。 |