Sun Java System Application Server Enterprise Edition 8.2 管理指南

第 19 章 asadmin 实用程序

Application Server 包含一个称为 asadmin 的命令行管理实用程序。asadmin 实用程序用于启动和停止 Application Server,同时也可用于管理用户、资源和应用程序。

本章包括以下各节:

asadmin 命令用法

使用 asadmin 实用程序可以执行 Application Server 的所有管理任务。您可以使用此 asadmin 实用程序来代替管理控制台。

asadmin 实用程序将调用可标识您希望执行的操作或任务的命令。这些命令区分大小写。短选项参数具有单个破折号 (-),而长选项参数具有两个破折号 (--)。选项用于控制实用程序执行命令的方式。选项也区分大小写。大多数选项都需要参数值,但是可在功能 ON 或 OFF 之间切换的布尔选项除外。操作数出现在参数值后面,并且以空格、制表符或双破折号 (--) 分隔。asadmin 实用程序将跟在选项及其值后面的任何内容都视为操作数。


示例 19–1 语法示例

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 选项将显示所有可用命令的列表。


示例 19–2 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_PASSWORDAS_ADMIN_USERPASSWORDAS_ADMIN_ALIASPASSWORDAS_ADMIN_MAPPEDPASSWORD

所有远程命令都必须通过 -‐passwordfileasadmin 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 选项用于指定包含密码的文件。文件的有效内容为:


示例 19–3 密码文件内容


AS_ADMIN_PASSWORD=value
AS_ADMIN_ADMINPASSWORD=value
AS_ADMIN_USERPASSWORD=value
AS_ADMIN_MASTERPASSWORD=value

Multimode 命令

使用 multimode 命令可以处理 asadmin 命令。命令行界面将提示您输入某个命令,执行此命令,显示此命令的结果,然后提示您输入下一个命令。此外,在此模式下设置的所有 asadmin 选项名称都将用于所有后续命令。您可以设置环境并运行命令,直至通过键入 "exit" 或 "quit" 退出 multimode。您还可以通过从文件或标准输入(管道)传递先前准备好的命令列表来提供命令。您可以从多模式会话中调用 multimode;当您退出第二个多模式环境之后,将返回到原先的多模式环境。

要调用 multimode,请输入 asadmin multimode

List、Get 和 Set 命令

asadmin listgetset 命令串联使用可以为 Application Server 的点式命名分层结构提供导航机制。有两个分层结构:配置监视,可以对它们运行这些命令。list 命令可为具有只读或可修改属性的管理组件提供全限定带点名称。

配置分层结构提供可修改属性,而监视分层结构中管理组件的属性完全为只读属性。配置分层结构并不严格基于域的模式文档,而监视分层结构稍有不同。

使用 list 命令可以访问所需分层结构中的特定管理组件。随后,调用 getset 命令可以立即获取管理组件的属性的名称和值,或设置这些属性的值。使用通配符 (*) 选项可以获取给定全限定带点名称中的所有匹配项。

Application Server 带点名称使用 "."(句点)作为分界符来分隔完整名称的各部分。这与 UNIX 文件系统中使用 "/" 字符来分隔文件绝对路径名的各级别的方式类似。当形成 getsetlist 命令可接受的带点名称时,以下规则适用。请注意,特定命令将应用某些附加语义。

list 命令是这三个命令的导航功能的起源。如果要 setget 某个特定应用服务器子系统的属性,则必须知道此子系统的带点名称。可以借助 list 命令来查找此子系统的带点名称。以查找某个以 / 开头的大型文件系统中特定文件的修改日期(属性)为例,您必须首先找出此文件在文件系统中的位置,然后再查看其属性。因此,用于了解 Application Server 中分层结构的前两个命令为:* list "*"<command>* list * -‐monitor。请查阅 getsetlist 命令的手册页,以确定这些命令的有序输出。

服务器生命周期命令

服务器生命周期命令是指用于创建、删除、启动或停止域、服务 (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 管理命令

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 的操作。本节包括以下主题:

常用配置命令

这些命令可用于管理 Application Server 组件的配置。

表 19–7 常用配置命令

命令 

定义 

enable

启用指定的组件。如果组件已启用,则会重新启用它。组件必须已经部署才能启用。如果尚未部署组件,则会返回错误消息。 

disable

立即禁用命名组件。组件必须已经部署。如果尚未部署组件,则会返回错误消息。 

export

标记变量名称以便自动导出到后续命令的环境中。所有后续命令都使用指定的变量名称值,除非您对它们执行 unset 或退出 multimode

get

获取属性的名称和值。 

set

设置一个或多个可配置属性的值。 

list

列出可配置的元素。在 Solaris 上,当执行将 * 作为选项值或操作数的命令时,需要使用引号。

unset

删除一个或多个为多模式环境设置的变量。变量及其关联值将不再存在于环境中。 

HTTP、IIOP 和 SSL 侦听器命令

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 选项命令

事件探查器和 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_nameuser_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+breakkill -3 信号发送到应用服务器进程)。如果目标服务器实例未处于运行状态,则此命令将不会起作用。

display-error-statistics

显示自上次重新启动服务器以来 server.log 中严重级别和警告的汇总列表。

display-error-distribution

显示模块级别的实例 server.log 中的错误分布。™

display-log-records

显示标有给定时间戳的给定模块的所有错误消息。 

Web 服务命令

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.xmlmessage-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

此本地命令用于修改主密码。此命令为交互式命令,提示用户提供旧的和新的主密码。此命令在服务器停止时才有效。 

检验 domain.xml 命令

XML 检验命令用于检验 domain.xml 文件的内容。

表 19–22 检验 domain.xml 命令

命令 

定义 

verify-domain-xml

检验 domain.xml 文件的内容。

自定义 MBean 命令

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。允许您安装许可证文件。