asadmin 实用程序

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

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

asadmin 可以在命令 Shell 调用或多命令模式（称为 multimode）中使用。在命令 Shell 调用中，从命令 Shell 调用 asadmin 实用程序。asadmin 将执行命令，然后退出。在多命令模式中，调用 asadmin 一次后，它将接受多个命令，直至您退出 asadmin 并返回到常规命令 Shell 调用。在处于多命令模式时设置的环境变量将用于所有的后续命令，直至您退出 multimode。可以通过从文件或标准输入（管道）传递先前准备好的命令列表来提供命令。此外，您可以从多模式会话中调用 multimode；当您退出第二个多模式环境之后，将返回到原先的多模式环境。

您还可以使用交互或非交互选项运行 asadmin 实用程序。默认情况下，启用交互选项。它提示您提供必需的参数。在任何情况下，您都可以在命令 Shell 调用中使用交互选项。当您在命令提示符下一次运行一条子命令时，以及从某个文件中运行时，您可以在 multimode 中使用交互选项。在 multimode 中，来自某个输入流的子命令以及通过另一个程序调用的子命令无法使用交互选项运行。

本地子命令可以在不存在管理服务器的情况下执行。但是，用户必须登录到托管域的计算机才能执行子命令，并且必须对安装目录和域目录具有访问（权限）。远程子命令始终通过连接到管理服务器并在其中执行子命令来执行。需要使用正在运行的管理服务器。所有远程子命令都需要以下选项：

• -u -‐user 授权的域应用服务器管理用户名。

• -‐passwordfile 包含以下形式的域应用服务器密码的文件：AS_ADMIN_PASSWORD=password。其中 password 是实际的管理员密码。

• -H -‐host 运行域应用服务器的计算机的名称。

• -p -‐port 侦听管理请求的域应用服务器的端口号。对于 Platform Edition，默认端口号为 4848。

• -s -‐secure 如果为 true，则使用 SSL/TLS 与域应用服务器进行通信。

• -t -‐terse 指示任何输出数据都必须非常简明，通常在脚本中避免使用用户友好的句子，而支持使用格式完好的数据。默认值为 false。

• -e -‐echo 如果设置为 true，将在标准输出中回显命令行语句。默认值为 false。

• -I -‐interactive 如果设置为 true（默认值），则仅提示所需的密码选项。

• -h -‐help 显示命令的帮助文本。

对于可以在本地或远程执行的子命令，如果设置了 --host、--port、--user 和 --passwordfile 选项中的任何一个选项，则无论在环境中还是在命令行中，子命令都将以远程模式运行。此外，对于可以在本地或远程执行的子命令，如果 --local 选项设置为 true，则子命令将在本地运行。此外，如果未设置任何本地选项，则无论在命令行中还是在环境中，默认情况下子命令都将在本地执行。将 --local 选项设置为 true 将覆盖本地的 --host、--port、--user 和 --passwordfile 设置，即使已指定这些选项也是如此。子命令将以本地模式运行。

可以在本地执行的子命令将接受 --domain 选项以指定需要的域；如果只有一个域，该操作将采用该域作为默认域。如果有多个域，则 --domain 选项是必需的选项。对于可以在本地或远程运行的子命令，如果在远程运行时指定了 --host、--port、--user 和 --passwordfile 选项， 将忽略 --domain 选项。如果子命令以远程模式运行，则忽略 --domain 选项。请注意，每个域都有一个管理实例，因此在一台具有多个域的计算机上，本地执行必须指定域，而远程执行必须为该域的管理实例指定 --host、--port、--user 和 --passwordfile 选项。

为了安全起见，可以从文件中为子命令设置密码，而不要在命令行输入密码。--passwordfile 选项用于指定包含密码的文件。文件的有效内容为：

示例 C–1 密码文件内容

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

如果已将 AS_ADMIN_PASSWORD 导出到全局环境，则指定 --passwordfile 选项将产生有关使用 --password 选项的警告。取消设置 AS_ADMIN_PASSWORD 以防止出现此警告。主密码不通过命令行或环境变量传播，但可以在 passwordfile 中指定。

要使用 --secure 选项，必须使用 set 命令启用 domain.xml 的 admin http-listener 中的安全性 --enabled 标志。使用 asadmin 子命令进行创建和/或删除时，必须重新启动服务器以使新创建的命令生效。使用 start-domain 命令重新启动服务器。

要在 Solaris 平台上访问 Application Server 命令行界面子命令的手册页，请将 $AS_INSTALL/man 添加到 MANPATH 环境变量中。

您可以通过调用 --help 选项来获取任何 asadmin 实用程序子命令的全部用法信息。如果指定子命令，将显示该子命令的用法信息。使用不带子命令的 --help 选项将显示所有可用子命令的列表。