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

`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_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 选项用于指定包含密码的文件。文件的有效内容为：

示例 19–3 密码文件内容

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

asadmin 命令用法