附录 A
使用命令行界面

本附录提供了在系统提示符下以单模式（即在命令提示符下一次运行一条命令）、多模式（即可以运行多条命令，而不必重新输入环境级别的信息）以及在脚本和程序中使用命令行界面（即 asadmin 公用程序）的有关说明。您可以使用命令行界面代替管理界面屏幕。

本附录包括以下各部分：

关于命令行界面
使用 asadmin
安全性考虑
并行访问考虑事项
命令参考

---

关于命令行界面

本部分包括以下主题：

关于 asadmin 公用程序
关于 Ant 任务
关于其他命令行公用程序

关于 asadmin 公用程序

asadmin 公用程序可以执行所有配置和管理任务。您可以使用此公用程序代替管理界面。

关于 Ant 任务

许多开发者使用 Ant 来帮助加快 J2EE 应用程序的开发过程。他们将 asadmin 公用程序编写在 Ant 脚本中以执行某些任务。然后使用 Ant 任务来构建应用程序、部署及取消部署模块和应用程序，以及控制 Sun ONE Application Server。

有关 Ant 任务的详细信息，请参见《Sun ONE Application Server Developer's Guide》。

有关 Ant 的详细信息，请访问 Jakarta Project 站点 http://jakarta.apache.org/ant/。

关于其他命令行公用程序

Sun ONE Application Server 还包含有其他命令行公用程序。下表列出了这些公用程序并给出了每个公用程序的简要说明。

表 A-1 其他命令行公用程序

公用程序	定义
appclient	启动应用程序客户机容器并调用封装在应用程序 JAR 文件中的客户机应用程序。
capture-schema	获取数据库模式和映射信息。
flexanlg	生成有关服务器的统计数据。
htpasswd	创建用户验证文件。
package-appclient	封装应用程序客户机容器库和 JAR 文件。有关详细信息，请参见《 Sun ONE Application Server Developer's Guide to Clients》。
verifier	用 DTD 验证 J2EE 部署描述符。有关详细信息，请参见《Sun ONE Application Server Developer's Guide》。
wscompile	提供服务定义接口并生成客户机占位程序或服务器端骨架，或为提供的接口生成一组 WSDL。
wsdeploy	生成可部署的 WAR 文件。

有关这些公用程序的详细信息，请参见各自的联机帮助。

---

使用 asadmin

asadmin 公用程序有一组用于执行管理任务的命令。您可以使用这些命令执行大多数使用管理界面所能执行的任务。您可以在 install_dir/bin 下找到并运行 asadmin 公用程序。在 Windows 上，双击 asadmin.bat 文件，然后 asadmin 公用程序将在命令窗口中启动并以多模式运行。

请注意，使用命令行无法设置某些 HTTP 服务器相关属性和管理服务器属性，这些属性必须使用管理界面进行设置。您可以设置存储在 server.xml 配置文件中的所有属性，但是不能设置存储在 init.conf 或 obj.conf 中的属性。有关配置文件的详细信息，请参见《Sun ONE Application Server Administrator's Configuration File Reference》。

有关单个命令的详细信息，请参见命令参考和命令的帮助信息。

本部分包括以下主题：

了解命令语法
使用单模式和多模式
使用交互式和非交互式选项
使用环境命令
使用口令文件选项
以本地或远程方式运行 asadmin
使用命令行调用
使用换码符
使用 get 和 set 命令
使用帮助
查看输出和错误消息

了解命令语法

asadmin 公用程序的语法如下：

asadmin command -short-option argument --long-option argument operand

Command

命令是所执行的操作或任务。命令区分大小写。

选项

选项指定公用程序如何执行一条命令。选项区分大小写。请注意，短选项之前有一个短划线 (-)，长选项之前有两个短划线 (--)。对于许多选项，既可以使用长选项形式，也可以使用短选项形式。例如，user 可以是 --user 或 -u。有些选项是必需的，有些是可选的。在命令语法中，可选的选项放在方括号内。运行一条命令时，其中必须包含所有必需选项，否则将返回错误消息，并且命令无法执行。

有关可用的长选项和短选项名称的列表，请参见命令参考中的短选项和长选项、默认值以及环境变量表。

大多数选项都要求提供变量值，例如，--port port_number。但布尔选项除外，它用于切换某功能的打开或关闭，不需要变量值。

您也可以将选项保存在环境变量中。有关详细信息，请参见使用环境命令。有关选项的等效环境变量的完整列表，请参见长选项和短选项格式、默认值以及等效的环境变量。

布尔选项

布尔选项用于切换开或关（例如，使用 --interactive 将打开交互模式，此时系统会提示您输入选项；使用 --no-interactive 将关闭交互模式）。将 --no- 置于长选项之前可以将该选项切换至关闭状态，而指定短选项的名称则始终会将该选项设置为与默认值相反的值。

您可以将短的布尔选项编组。例如，可以使用 -Ie 来指定交互（短选项 -I）和回显（短选项 -e）。

Operand

输入空格或制表符可以关闭操作数。在命令语法中，操作数可以按任意顺序出现。您可以使用后面不带任何选项的 -- 来分隔选项和操作数。-- 之后的任何变量都被视为操作数，即使它们以短划线 (-) 开头。例如，在

asadmin> create-jvm-options --instance server1 -- -Xmx1500m 中，

-XMx1500m 被视为操作数，即使它以短划线开头。

语法示例

asadmin create-instance [--user admin_user] [--password admin_password] [-H host_name] [--port port_number] [--sysuser sys_user] [--domain domain_name] [--local=true/false] [--passwordfile file_name] [--secure | -s] --instanceport instance_port instance_name

在此语法示例中，-H 是 hostname 的短选项，--user 是长选项，其变量为 admin_user，instance_name 是操作数。可选的选项放在方括号内。

以下示例显示了带有实际值的命令语法，其中没有使用某些可选选项。

asadmin create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

使用单模式和多模式

您可以在单模式或多模式下运行 asadmin。在单模式下，可以在命令提示符下一次运行一条命令。在多模式下，可以运行多条命令，而无需重复输入环境级别信息。

使用来自某个文件的输入时，如果命令失败，在单模式下，程序将退出；在多模式下，程序将返回到 asadmin 提示符。

单模式

如果在命令提示符下调用命令行界面中的某条命令，则是在单模式下运行。命令行界面将运行命令，然后退出并返回到命令提示符。要在命令提示符下运行命令行界面，请转至 install_dir/appserv/bin 目录，然后在命令提示符下键入命令：

> asadmin command options arguments

例如：

> asadmin create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

多模式

多模式允许您在开始时设置环境，以便可以运行多条命令而无需重复输入某些环境级别信息（例如，服务器名称、端口和口令）。使用多模式的一个显著优点是可以明显加快命令的输入和执行速度，因为这时 asadmin 驻留在内存中。如果这些环境变量是在操作系统级别设置的，多模式会拾取这些设置。asadmin 公用程序将一直使用这些设置，直至您更改它们。

在 Windows 上，如果运行 asadmin.bat 文件，您将自动处于多模式下。

在 UNIX 上，要从命令行以多模式启动 asadmin 公用程序，请键入以下内容：

> asadmin multimode

处于多模式时，命令提示符将变为 asadmin。然后您可以在 asadmin 提示符下键入命令。这时无需使用公用程序名。例如：

asadmin> create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

键入 exit 或 quit 可以退出多模式。这时将返回到命令提示符。

多重多模式

您也可以使用以下命令在多模式会话中调用多模式：

asadmin> multimode

当退出第二个多模式环境后，您将返回到初始的多模式环境。

例如，如果您在多模式下管理 server1，并且希望管理 server2 以比较两者，则可以在 server1 的多模式下调用 server2 的多模式。因为不需要退出当前的多模式会话，所以可以保持您的环境设置。当退出用于 server2 的多模式会话后，您将返回到 server1 的多模式环境。

使用交互式和非交互式选项

使用命令行界面时，您可以选择交互或非交互使用模式。如果选择交互模式，系统会在您未指定口令时提示您输入口令。默认情况下，系统将启用交互模式。

您可以通过使用 export 命令设置交互环境变量来禁用和启用交互模式。有关详细信息，请参见 export 命令中使用的环境变量表。

在单模式下，您可以在任何情况下使用交互式选项。在多模式下，当您在命令提示符下一次运行一条命令，以及从某个文件中运行时，可以使用交互式选项。但是，多模式下来自某个输入流的命令以及由另一个程序调用的命令无法在交互模式下运行。

使用环境命令

asadmin 公用程序包含一组环境变量，您可以使用环境命令对其进行设置。在多模式下，一旦设置了这些变量，就不需要再重新设置您的环境，直至退出多模式。您也可以在操作系统级别设置这些环境变量。如果这样设置，在进入多模式时，这些变量会被自动拾取，并且在退出多模式后仍会继续保持。

环境变量是“名称/值”对，您可以在任何时候通过分配来设置。环境变量由 AS_ADMIN_ 后跟大写的选项名组成。例如，要设置管理服务器用户，可以键入以下内容：

export AS_ADMIN_USER=administrator

其中 administrator 是管理员的用户名。

这也使 AS_ADMIN_USER 的值可用于 asadmin 命令，例如：

asadmin multimode
asadmin> export AS_ADMIN_HOST=austen

只要您处于此多模式会话中，管理服务器的主机名将一直设置为 austen，除非您重新分配。

您也可以在一个步骤中设置和导出多个环境变量的值，例如：

asadmin> export AS_ADMIN_PORT=4848 AS_ADMIN_USER=admin

要查看当前的环境变量设置，请使用不带变量的 export 命令：

asadmin> export
AS_ADMIN_HOST=austen
AS_ADMIN_PORT=4848
AS_ADMIN_USER=admin

使用 unset 命令可以从环境中删除变量及其值。例如：

asadmin> unset AS_ADMIN_HOST

您可以覆盖为某个环境变量设置的值。要执行此操作，可以重新设置该变量，也可以在某个 asadmin 命令中设置一个不同的值。例如：

asadmin> export AS_ADMIN_HOST=dickens
asadmin> show-instance-status --host austen instance-name

此示例显示了管理服务器主机 austen 中某实例的状态，因为该值覆盖了较早的主机值 dickens。

如果不使用导出的变量，您必须在大多数命令中提供以下选项，或者使用默认值（有关默认值的列表，请参见长选项和短选项格式、默认值以及等效的环境变量）：

--host
--port
--user
--password 或 --passwordfile
--secure=true（如果需要安全保护）
--instance（如果需要）

下面的 export 命令中使用的环境变量表描述了某些可在 export 命令中使用的环境变量。这些变量是最常用的变量，因为它们是专用于设置环境的。第一列显示了环境变量的名称，第二列显示了其用途以及当未设置值时所使用的默认值。有关环境变量的完整列表，请参见长选项和短选项格式、默认值以及等效的环境变量。

表 A-2 export 命令中使用的环境变量

环境变量	用途
AS_ADMIN_HOST	管理服务器的主机名。如果未指定值，则使用本地主机。
AS_ADMIN_PORT	管理服务器的端口号。如果未指定值，则使用 4848。
AS_ADMIN_USER	运行命令的用户的用户名。
AS_ADMIN_PASSWORD	运行命令的用户的口令。用户名和口令用于验证用户，以确定是否允许此用户管理服务器。这与通过管理界面访问管理服务器时的验证相同。
AS_ADMIN_SECURE	=true（如果需要安全保护）。
AS_ADMIN_INSTANCE	设置 Sun ONE Application Server 的实例。任何使用实例名作为变量的后续命令（不包括将其用作操作数的命令）都将使用此指定实例。

使用口令文件选项

如果不希望在命令行上键入口令或为口令设置环境变量，可以创建一个口令文件，然后在命令行上使用它作为一个选项。

每个具有 password 选项的命令也都具有 passwordfile 选项，可以用后者代替前者。口令文件包含以下行：

AS_ADMIN_PASSWORD=value

AS_ADMIN_ADMINPASSWORD=value

AS_ADMIN_USERPASSWORD=value

如果使用 passwordfile 选项，文件中的口令将导出到多模式环境中，并且未指定 password 选项的后续命令将使用这些值。

如果在命令行上同时指定了口令 (password) 和口令文件 (passwordfile) 选项，口令文件中的值将导出到多模式环境中，但是当前命令将使用口令选项指定的口令，因为口令选项优先于口令文件。

以本地或远程方式运行 asadmin

asadmin 公用程序通常通过管理服务器来发送其命令。因此，在安装了 Sun ONE Application Server 的系统上不需要运行 asadmin。但是，为使大多数 asadmin 命令能够工作，必须运行管理服务器。

某些命令具有使其以本地方式运行的选项，例如 create-instance 命令。如果在 create-instance 命令中使用 --local=true 选项，则必须在安装了服务器的计算机上运行此命令，但是不需要为创建实例运行管理服务器。

某些命令必须以本地方式运行。例如，start-appserv（用于启动管理服务器及其所有实例）不能以远程方式运行，因为在使用此命令启动管理服务器之前，管理服务器不会运行。

有关管理服务器的详细信息，请参见第 2 章“设置管理服务器首选项”。

以下命令既可以以本地方式运行也可以以远程方式运行：

create-instance
delete-instance
list-instances
start-instance
stop-instance
display-license
version
stop-domain
restart-instance
list-domains

对于这些命令，您可以选择以本地方式运行命令而不必指定本地 (local) 选项。默认情况下，如果您在命令语法中为用户、口令、主机或端口指定了值，该命令将被视为远程命令（虽然您仍然可以为这些选项指定本地值）。如果没有为这些选项指定值，该命令将默认为以本地方式运行。

以本地方式执行命令时，如果有域 (domain) 选项，则必须为该命令指定域选项（除非只有一个域）；以远程方式执行命令时，将忽略域选项（如果指定了域选项）。

使用命令行调用

您可以用多种方式调用命令行，如以下主题所述：

从命令行使用 asadmin
利用来自文件（脚本）的输入使用 asadmin
通过标准输入（管道）使用 asadmin

从命令行使用 asadmin

使用命令的最简单方式是在命令行上一次运行一条命令，您可以键入公用程序、命令及其选项和变量。在多模式下，您可以键入多条命令而无需重复键入公用程序名和环境选项（如果已经设置了环境变量）。您可以以交互方式（系统会提示输入所需的其他输入信息，例如，口令）或非交互方式运行单模式或多模式命令。

有关单模式和多模式的详细信息，请参见使用单模式和多模式。

有关以交互方式使用命令的详细信息，请参见使用交互式和非交互式选项。

从命令行运行命令的示例

> asadmin create-instance --user admin --password password --host austen --port 4848 --instanceport 1024 server2

该命令完成后，您将返回到操作系统提示符。

利用来自文件（脚本）的输入使用 asadmin

您可以创建一个其中包含许多 asadmin 命令的脚本。使用脚本，您可以成批处理命令、设置在指定时间运行的工作，还可以简化和自动执行任务。

要调用文件中的脚本，请使用以下语法：

> asadmin multimode --file filename

以下是文件中的一个简单脚本的示例，您可以按上述语法调用：

# 创建新实例并启动它。
export AS_ADMIN_USER=admin AS_ADMIN_PASSWORD=mypassword AS_ADMIN_HOST=austen AS_ADMIN_PORT=4848
create-instance --instanceport 9000 austen3
start-instance austen3

此脚本设置了环境，创建了名为 austen3 的实例并启动了新实例。以数字记号 (#) 开头的行是注释行，执行时将被忽略。

通过标准输入（管道）使用 asadmin

您可以使用以下语法通过管道为 asadmin 公用程序提供输入：

cat filename | asadmin multimode

此语法在 Windows 上可能无效。

使用换码符

在命令语法中使用某些字符（冒号 :、星号 * 和反斜线 \）时会导致错误，除非使用换码符将其关闭。能否使用换码符取决于所用的平台，以及使用的是单模式还是多模式。

注	您不需要为 get 和 set 命令中的冒号使用换码符。

本部分包括以下主题：

UNIX 上单模式下的换码符
Windows 上单模式下的换码符
所有平台上单模式下的换码符
所有平台上多模式下的换码符

UNIX 上单模式下的换码符

在 Solaris 上，您可以使用双反斜线 (\\) 或双引号 (" ") 为受限制的字符换码。

使用反斜线 (\\) 换码

例如，在使用其值中包含冒号的选项创建 JDBC 连接池时，可以使用反斜线（示例中假设已经为某些属性设置了环境变量）：

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=jdbc\\:oracle\\:thin\\:@asperfsol8\\:1521\\:V8i:user=staging_lookup_app:passw ord=staging_lookup_app OraclePoollookup

使用引号换码

要在上述示例中使用引号，需要将值放在双引号 (" ") 内，同时使用反斜线为双引号换码。

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=\"jdbc:oracle:thin:@asperfsol8:1521:V8i\":user=staging_lookup_app:password=st aging_lookup_app OraclePoollookup

您也可以使用所有平台上单模式下的换码符中介绍的方法。

Windows 上单模式下的换码符

在 Windows 上，您可以使用反斜线字符进行换码。例如，在使用其值中包含冒号的选项创建 JDBC 连接池时，可以使用反斜线（示例中假设已经为某些属性设置了环境变量）：

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=jdbc\:oracle\:thin\:@asperfsol8\:1521\:V8i:user=staging_lookup_app:password=s taging_lookup_app OraclePoollookup

您也可以使用所有平台上单模式下的换码符中介绍的方法。

所有平台上单模式下的换码符

在任意平台上，您可以使用反斜线为字符换码，然后将包含换码字符的值放在双引号内。例如，在使用其值中包含冒号的选项创建 JDBC 连接池时，可以如下所示使用换码符（示例中假设已经为某些属性设置了环境变量）：

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url="jdbc\:oracle\:thin\:@iasperfsol8\:1521\:V8i":user=staging_lookup_app:passwor d=staging_lookup_app OraclePoollookup

所有平台上多模式下的换码符

在多模式下，您可以使用以下语法，其中只需要引号，不需要斜线或反斜线：

asadmin> create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url="jdbc:oracle:thin:@asperfsol8:1521:V8i":user=staging_lookup_app:password=stag ing_lookup_app OraclePoollookup

使用 get 和 set 命令

使用 get 和 set 命令可以访问和更改 Sun ONE Application Server 中的配置设置。多数情况下，asadmin 命令仅设置了必需的属性。使用 set 命令可以更改可选属性的值。

表 A-3 get 和 set 命令

命令	变量	用途
get	(scope) 其中 scope 代表某个属性，并且是一个有效名称。	获取属性的值。
set	(scope=value) 其中 scope 代表某个属性，并且是一个有效名称，value 是要为该属性设置的值。	设置属性的值。
reconfig	instance-name	运行任何修改了配置文件的命令后，需要运行 reconfig 以便将更改应用到服务器。有关应用更改/重新配置服务器的详细信息，请参见应用对应用服务器实例所做的更改。

您可以在一条命令中用空格分开各个属性以便获取或设置多个属性值。例如：

set server1.appReloadPollInterval=20 server1.mime.mime1.file=mime.types

您也可以使用 AS_ADMIN_PREFIX 环境变量设置一个将为后续的 get 和 set 命令使用的前缀。之后，在后续 get 和 set 命令中的前缀字符串和操作数之间会自动插入一个句点 (.)。例如：

asadmin>export AS_ADMIN_PREFIX=server1
asadmin>get *
server1.locale = en_US
server1.appReloadPollInterval = 2
server1.name = server1
...

因为 get 和 set 命令使用句点作为分隔符，所以如果某项目的名称中包含句点，则必须在句点前面使用反斜线换码符 (\)。以下示例显示了一个服务器实例名 server2.sun.com，其中在句点前面使用了反斜线：

get server2\.sun\.com.*

如果未包含反斜线，将收到一条错误消息。

get 和 set 命令示例

以下示例显示了如何使用 get 命令获取属性的值，以及如何使用 set 命令来设置值。

MDB 容器服务示例

如果应用服务器实例是 server1，则可以使用您的环境设置，在多模式下运行以下命令以获取所有 MDB 容器属性的值：

asadmin> get server1.mdb-container.*

以下是此命令的输出示例，其中显示了属性的当前值：

server1.mdb-container.logLevel = null
server1.mdb-container.steadyPoolSize = 10
server1.mdb-container.idleInPoolTimeoutInSeconds = 600
server1.mdb-container.maxPoolSize = 60
server1.mdb-container.monitoringEnabled = false
server1.mdb-container.poolResizeQuantity = 2

要仅获取 MDB 容器 monitoringEnabled 属性的值，请使用以下命令：

asadmin> get server1.mdb-container.montioringEnabled

要将 monitoringEnabled 属性的值设置为 True，请使用以下命令：

asadmin> set server1.mdb-container.montioringEnabled=true

JMS 资源示例

要配置任何资源，属性应如下所示：

instancename.resource.primary_key_value.attribute_name

例如：

asadmin> get server1.jms-resource.myjms.*

这将获取名为 myjms 的 JMS 目标资源的所有属性。例如：

server1.jms-resource.myjms.resType = javax.jms.Topic
server1.jms-resource.myjms.enabled = true
server1.jms-resource.myjms.name = myjms
server1.jms-resource.myjms.description = null

要获取单个属性（例如，resType）的值：

asadmin> get server1.jms-resource.myjms.resType

要设置某个属性（例如，description）：

asadmin> set server1.jms-resource.myjms.description=mydescription

此示例将 description 属性设置为 mydescription。

获取和设置多个值的示例

您可以通过一条命令获取和设置多个值。要同时设置两个属性，请将这两个属性用空格分开。例如：

set server1.appReloadPollInterval=20 server1.mime.mime1.file=mime.types

您也可以使用环境变量 AS_ADMIN_PREFIX 来设置用于若干 get 和 set 命令的前缀。

使用 get 和 set 命令进行监视

您也可以使用 get 和 set 命令监视正在运行的服务器。此外，还可以使用 list 命令进行监视。您可以将 monitor 选项设置为 True 或 False。如果设置为 True，将监视指定的属性。有关使用命令行界面监视 Sun ONE Application Server 的详细信息，请参见使用 CLI 提取监视数据。

使用帮助

您可以在命令提示符下键入 -h 或 --help 以获得每条 asadmin 命令的帮助。例如，要获得有关 asadmin 的帮助，请键入以下内容：

asadmin --help

您将看到一个包含所有 asadmin 命令的列表。

要获得某个特定 asadmin 命令的帮助，请键入以下内容：

asadmin command -h

或

asadmin command --help

帮助信息包括命令提要、命令说明、语法信息、示例以及相关命令列表。

请注意，在命令中的任何位置使用 -h 或 --help 都将获得此命令的帮助，而不会执行命令。

您也可以在 UNIX 环境中访问手册页形式的命令行帮助页面。对于非捆绑的安装，请将 install_dir/man 添加到 MANPATH 环境变量中。执行此操作后，您便可以访问 Sun ONE Application Server 公用程序的手册页。例如，可以在命令提示符下键入 man asadmin。

查看输出和错误消息

如果命令成功执行，您将看到一条消息，通知您所完成的操作。如果命令失败，将显示一条错误消息。

本节包括以下主题：

查看退出状态
查看用法

查看退出状态

除了显示一条错误消息外，asadmin 命令还始终会退出并包含一个退出状态。如果命令成功执行，退出状态为 0，如果命令失败，退出状态为 1。

UNIX 上的退出状态

您可以在命令提示符下键入 echo $? 以检查退出状态。

您也可以在脚本中使用退出代码。例如，以下 Korn shell 脚本使用退出状态来指示是否成功执行了 list-instances 命令：

#!/bin/ksh
asadmin list-instances
if [[ $? = 0 ]]
then
echo "success"
else
echo "error"
fi

Windows 上的退出状态

在 Windows 上，您可以在 .bat 脚本中检查退出状态。例如，以下两个脚本分别显示了成功的脚本及返回的输出，以及未成功的脚本及返回的输出：

成功条件

myscript.bat
------------
echo off
echo Processing Command
call asadmin list-instances --domain domain1
if not %errorlevel% EQU 0 goto end
echo Command Succesful
goto program-end
:end
echo Command Failed
:program-end

输出：

Processing Command
admin-server <not running>
server1 <not running>
Command Succesful

错误条件

myscript.bat
-------------
echo off
echo Processing Command
call asadmin list-instances
if not %errorlevel% EQU 0 goto end
echo Command Succesful
goto program-end
:end
echo Command Failed
:program-end

输出：

Processing Command
No default domain.Need to enter a domain.
Command Failed

查看用法

如果键入命令而不带有变量，将显示一条错误消息，其中包含该命令的语法。例如：

asadmin> create-instance

接收的操作数数量无效

用法:create-instance [--user admin_user] [--password admin_password] [--host localhost] [--port 4848] [--sysuser sys_user] [--domain domain_name] [--local=false] [--passwordfile file_name] [secure | -s] --instanceport instanceport instancename

---

安全性考虑

从命令行运行命令行界面时，必须为所有命令提供口令。如果在多模式下运行，则必须在一开始设置环境时提供口令。如果退出多模式，则再次启动多模式时，必须再次设置环境，其中包括口令。您需要使用环境命令来设置口令。有关详细信息，请参见使用环境命令。

您也可以设置一个口令文件，这样便无需在命令行键入口令。有关详细信息，请参见使用口令文件选项。

如果没有有效的用户名和口令验证信息，将不会执行命令。

命令行界面具有您为 Sun ONE Application Server 设置的安全性措施。有关 Sun ONE Application Server 中的安全性的详细信息，请参见《Sun ONE Application Server Administrator's Security Guide》。

---

并行访问考虑事项

有时可能会有多个用户同时试图使用命令行界面和/或管理界面来配置某个服务器。如果发生这种情况，第二个配置请求将排队等候，直至第一个请求完成。如果请求的等候时间过长，将发生超时。

对于某些命令，只有在使用了 reconfig 命令之后更改才会生效。这意味着在将更改应用到服务器之前，可能有多个用户对某个属性进行了编辑。有关 reconfig 的详细信息，请参见应用对应用服务器实例所做的更改。

---

命令参考

本节包括以下主题：

命令列表
带点的名称和属性列表
长选项和短选项格式、默认值以及等效的环境变量

命令列表

下表显示了所有 asadmin 命令及其用途。有关命令的语法和用法的详细信息，请参见联机帮助。

左列显示了命令名，右列显示了其用途。

表 A-4 asadmin 命令

命令	用途
add-resources	添加一个或多个 JDBC、JMS 或 JavaMail 类型的资源。
create-acl	创建 ACL（存取控制表）。
create-authdb	创建验证数据库。
create-auth-realm	创建验证领域。
create-custom-resource	创建自定义资源。
create-domain	创建域。
create-file-user	在密钥文件中创建文件领域用户。
create-http-listener	创建 HTTP 侦听程序。
create-http-qos	为应用服务器实例或虚拟服务器创建 HTTP 服务质量设置。
create-iiop-listener	创建 IIOP 侦听程序。
create-instance	创建应用服务器实例。
create-javamail-resource	创建 Java 邮件资源。
create-jdbc-connection-pool	创建 JDBC 连接池。
create-jdbc-resource	创建 JDBC 资源。
create-jmsdest	创建 JMS（Java 消息服务）目标。
create-jms-resource	创建 JMS 资源。
create-jndi-resource	创建 JNDI 资源。
create-jvm-options	在 Java 配置或事件探查器元素中创建 JVM 选项。
create-lifecycle-module	创建生命周期模块。
create-mime	创建 MIME 类型文件。
create-persistence-resource	创建持久性管理器工厂资源。
create-profiler	为 JVM 创建事件探查器。
create-ssl	为 HTTP 侦听程序、IIOP 侦听程序或 IIOP 服务创建 SSL 设置。
create-virtual-server	创建虚拟服务器。
delete-acl	删除 ACL。
delete-authdb	删除验证数据库。
delete-auth-realm	删除验证领域。
delete-custom-resource	删除自定义资源。
delete-domain	删除域。此命令只能以本地方式执行。
delete-file-user	从密钥文件中删除文件领域用户。
delete-http-listener	删除 HTTP 侦听程序。
delete-http-qos	删除应用服务器实例或虚拟服务器的 HTTP 服务质量设置。
delete-iiop-listener	删除 IIOP 侦听程序。
delete-instance	删除应用服务器实例。
delete-javamail-resource	删除 Java 邮件资源。
delete-jdbc-connection-pool	删除 JDBC 连接池。
delete-jdbc-resource	删除 JDBC 资源。
delete-jmsdest	删除 JMS 目标。
delete-jms-resource	删除 JMS 资源。
delete-jndi-resource	删除 JNDI 资源。
delete-jvm-options	从 Java 配置或事件探查器元素中删除 JVM 选项。
delete-lifecycle-module	删除生命周期模块。
delete-mime	删除 MIME 类型文件。
delete-persistence-resource	删除持久性管理器工厂资源。
delete-profiler	删除 JVM 事件探查器。
delete-ssl	删除 HTTP 侦听程序、IIOP 侦听程序或 IIOP 服务的 SSL 设置。
delete-virtual server	删除虚拟服务器。
deploy	在应用服务器实例中部署 EJB、WEB、连接器、appclient 或应用程序组件。
deploydir	在应用服务器实例中部署目录中的 EJB、WEB、连接器、appclient 或应用程序组件。
disable	禁用应用服务器实例中已部署的组件。
display-license	显示许可证信息。此命令只能以本地方式执行。
enable	启用（允许运行）应用服务器实例中已部署的组件。
export	导出 asadmin 环境变量的值，以便可以为后续的 asadmin 命令使用。
get	获取属性的值。
帮助	显示给定命令的帮助信息（说明、用法、语法、示例），或 asadmin 的一般帮助信息。
install-license	安装许可证文件。此命令只能以本地方式执行。
jms-ping	对 JMS 提供商执行 ping 命令，以查看它是否正在运行。
list	列出可配置的元素。
list-acls	列出应用服务器实例的 ACL。
list-authdbs	列出验证数据库。
list-auth-realms	列出验证领域。
list-components	列出服务器实例已部署的组件。
list-custom-resources	列出服务器实例中的自定义资源。
list-domains	列出域。
list-file-users	列出服务器实例中的所有文件领域用户。
list-file-groups	列出指定文件领域用户的所有组。如果未指定用户，则列出服务器实例的所有组。
list-http-listeners	列出服务器实例的 HTTP 侦听程序。
list-instances	列出域中的应用服务器实例。
list-iiop-listeners	列出服务器实例的 IIOP 侦听程序。
list-javamail-resources	列出服务器实例的 Java 邮件资源。
list-jdbc-connection-pools	列出服务器实例的 JDBC 连接池。
list-jdbc-resources	列出服务器实例的 JDBC 资源。
list-jmsdest	列出服务器实例的 JMS 目标。
list-jms-resources	列出服务器实例的 JMS 资源。
list-jndi-resources	列出服务器实例的 JNDI 资源。
list-lifecycle-modules	列出服务器实例的生命周期模块。
list-mimes	列出服务器实例的 MIME 类型文件。
list-persistence-resources	列出服务器实例的持久性管理器工厂资源。
list-profilers	列出服务器实例的 JVM 事件探查器。
list-components	列出部署的模块（或部署的应用程序的模块）中的一个或多个 EJB（或 Servlet）。
list-virtual-servers	列出服务器实例的虚拟服务器。
multimode	允许您在保持环境设置并保持在 asadmin 中时，执行多条命令。
reconfig	将更改应用到服务器。大多数更改在应用之后才会生效。
restart-instance	重新启动服务器实例。
set	设置属性的值。
show-component-status	显示已部署的组件的状态。
show-instance-status	显示服务器实例的状态（即它是否正在运行）。
shutdown	关闭管理服务器。
start-appserv	启动管理服务器和所有服务器实例。此命令只能以本地方式执行。
start-domain	启动域中的所有实例。此命令只能以本地方式执行。
start-instance	启动服务器实例。
stop-appserv	停止管理服务器和所有服务器实例。此命令只能以本地方式执行。
stop-domain	停止域中的所有实例。
stop-instance	停止服务器实例。
undeploy	删除服务器实例中已部署的组件。
unset	取消为 asadmin 设置的导出的环境变量。
update-file-user	更新现有文件领域用户。
version	显示 Sun ONE Application Server 的版本信息。

带点的名称和属性列表

在使用 get 和 set 命令获取和设置属性时，需要知道 asadmin 用于表示服务、资源等的名称，以便使用此名称获取特定对象的属性。

因为用于使用这些名称的语法会用句点来分隔名称，所以这些名称被称为带点的名称。

asadmin 中使用的带点的名称

下表列出了使用 asadmin 配置项目时所使用的名称。这些名称可以分为以下类别：

服务名称
资源名称
应用程序名称
其他名称

服务名称

下表显示了用于获取和设置服务的属性的服务名称：

表 A-5 用于命令行界面的服务名称

服务	带点的名称
JMS 服务配置	jms-service
事务服务配置	transaction-service
MDB 容器配置	mdb-container
EJB 容器配置	ejb-container
Web 容器配置	web-container
JVM 配置	java-config
ORB 配置	orb 或 iiop-service
ORB 侦听程序配置	orblistener 或 iiop-listener 请注意，orblistener 或 iiop-listener 本身并不是有效名称，它们都要求在后面提供侦听程序的名称。例如： ORB 侦听程序配置 orblistener.<listener name> 或 iiop-listener.<listener name>
日志配置	log-service
安全性配置	security-service
HTTP 配置	http-service

资源名称

下表显示了用于获取和设置资源的属性的资源名称。请注意，这些名称本身并不是有效名称，它们都要求在后面提供资源的名称。

表 A-6 用于命令行界面的资源名称

资源	带点的名称
JDBC 资源配置	jdbc-resource
JNDI 资源配置	jndi-resource
JDBC 连接池资源配置	jdbc-connection-pool
自定义资源配置	custom-resource
JMS 资源配置	jms-resource
持久性管理器工厂资源配置	persistence-manager-factory-resource
Java 邮件资源配置	mail-resource

应用程序名称

下表显示了用于获取和设置应用程序相关配置的属性的带点的名称。请注意，这些名称本身并不是有效名称，它们都要求在后面提供应用程序的名称。

表 A-7 用于命令行界面的应用程序名称

应用程序组件	带点的名称
应用程序配置	application
EJB 模块配置	ejb-module
Web 模块配置	web-module
连接器模块配置	connector-module

其他名称

下表显示了可以使用 get 和 set 进行配置的其他项目的带点的名称。请注意，这些名称本身并不是有效名称，它们都要求在后面提供应用程序的名称；例如，http-listener.listener_name、lifecycle-module.module-name 等。

表 A-8 用于命令行界面的其他项目的名称

项目	带点的名称
HTTP 侦听程序	http-listener 或 http-server.http-listener
MIME 类型文件	mime
ACL	acl
虚拟服务器	virtual-server
验证数据库	auth-db
安全性领域	authrealm
生命周期模块	lifecycle-module
事件探查器配置	profiler
服务器配置	server configuration (服务器实例的名称)

属性

以下各节显示了上面列出的每个命名项目的属性并提供了用法示例。请注意，某些属性是只读的（即只能用于 get 命令，不能用于 set 命令）。

注	本部分的示例假设已在环境变量中定义了用户、口令、主机和端口，因此未在语法中列出这些选项。

jms-service

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-9 JMS 服务属性

server.xml 名称	asadmin 名称
port	port
admin-username	adminUserName
admin-password	adminPassword
log-level	logLevel
enabled	enabled
init-timeout-in-seconds	initTimeoutInSeconds
start-args	startArgs

要获取实例 (server1) 的所有属性：

asadmin> get server1.jms-service.*

要获取名为 adminPassword 的属性：

asadmin> get server1.jms-service.adminPassword

要将名为 adminPassword 的属性的值设置为 admin：

asadmin> set server1.jms-service.adminPassword=admin

transaction-service

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-10 事务服务属性

server.xml 名称	asadmin 名称
automatic-recovery	automaticTransactionRecovery
timeout-in-seconds	transactionRecoveryTimeout
tx-log-dir	transactionLogFile
heuristic-decision	heuristicDecision
keypoint-interval	keypointInterval
log-level	logLevel
monitoring-enabled	monitoringEnabled

要获取实例 (server1) 的所有属性：

asadmin> get server1.transaction-service.*

要获取名为 transactionRecoveryTimeout 的属性：

asadmin> get server1.transaction-service.transactionRecoveryTimeout

要将名为 transactionRecoveryTimeout 的属性的值设置为 49：

asadmin> set server1.transaction-service.transactionRecoveryTimeout=49

mdb-container

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-11 MDB 容器属性

server.xml 名称	asadmin 名称
steady-pool-size	steadyPoolSize
pool-resize-quantity	poolResizeQuantity
max-pool-size	maxPoolSize
idle-timeout-in-seconds	idleInPoolTimeoutInSeconds
log-level	logLevel
monitoring-enabled	monitoringEnabled

要获取实例 (server1) 的所有属性：

asadmin> get server1.mdb-container.*

要获取名为 steadyPoolSize 的属性：

asadmin> get server1.mdb-container.steadyPoolSize

要将名为 steadyPoolSize 的属性的值设置为 10：

asadmin> set server1.mdb-container.steadyPoolSize=10

ejb-container

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-12 EJB 容器属性

server.xml 名称	asadmin 名称
steady-pool-size	steadyPoolSize
pool-resize-quantity	poolResizeQuantity
max-pool-size	maxPoolSize
cache-resize-quantity	cacheResizeQuantity
max-cache-size	maxCacheSize
pool-idle-timeout-in-seconds	idleInPoolTimeoutInSeconds
cache-idle-timeout-in-seconds	idleInCacheTimeoutInSeconds
removal-timeout-in-seconds	removalTimeoutInSeconds
victim-selection-policy	victimSelectionPolicy
commit-option	commitOption
log-level	logLevel
monitoring-enabled	monitoringEnabled

要获取实例 (server1) 的所有属性：

asadmin> get server1.ejb-container.*

要获取名为 maxPoolSize 的属性：

asadmin> get server1.ejb-container.maxPoolSize

要将名为 maxPoolSize 的属性的值设置为 12：

asadmin> set server1.ejb-container.maxPoolSize=12

web-container

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-13 Web 容器属性

server.xml 名称	asadmin 名称
log-level	logLevel
monitoring-enabled	monitoringEnabled（未使用）

要获取实例 (server1) 的所有属性：

asadmin> get server1.web-container.*

要获取名为 logLevel 的属性：

asadmin> get server1.web-container.logLevel

要将名为 monitoringEnabled 的属性的值设置为 WARNING：

asadmin> set server1.web-container.logLevel=WARNING

java-config

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-14 JVM 属性

server.xml 名称	asadmin 名称
java-home	javahome
debug-enabled	debugEnabled
debug-options	debugOptions
javac-options	javacoptions
rmic-options	rmicoptions
classpath-prefix	classpathprefix
server-classpath	serverClasspath
classpath-suffix	classpathsuffix
native-library-path-prefix	libpathprefix
native-library-path-suffix	libpathsuffix
env-classpath-ignored	envpathignore

要获取实例 (server1) 的所有属性：

asadmin> get server1.java-config.*

要获取名为 classpathprefix 的属性：

asadmin> get server1.java-config.classpathprefix

要将名为 classpathprefix 的属性的值设置为 com.sun：

asadmin> set server1.java-config.classpathprefix=com.sun

orb 或 iiop-service

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-15 ORB/IIOP 服务属性

server.xml 名称	asadmin 名称
message-fragment-size	msgSize
steady-thread-pool-size	minThreads
max-thread-pool-size	maxThreads
max-connections	maxConnections
idle-thread-timeout-in-seconds	idleThreadTimeout
log-level	log
monitoring-enabled	monitor
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

要获取实例 (server1) 的所有属性：

asadmin> get server1.orb.*

或

asadmin> get server1.iiop-service.*

要获取名为 msgSize 的属性：

asadmin> get server1.orb.msgSize

或

asadmin> get server1.iiop-service.msgSize

要将名为 idleThreadTimeout 的属性的值设置为 300：

asadmin> set server1.orb.idleThreadTimeout=300

或

asadmin> set server1.iiop-service.idleThreadTimeout=300

orblistener 或 iiop-listener

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-16 IIOP 侦听程序属性

server.xml 名称	asadmin 名称
id	id
address	address
port	port
enabled	enabled
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

要获取实例 (server1) 的所有属性：

asadmin> get server1.orblistener.orb_listener_id.*

或

asadmin> get server1.iiop-listener.orb_listener_id.*

要获取名为 port 的属性：

asadmin> get server1.orblistener.orb_listener_id.port

或

asadmin> get server1.iiop-listener.orb_listener_id.port

要将名为 address 的属性的值设置为 bluestar：

asadmin> set server1.orblistener.orb_listener_id.address=bluestar

或

asadmin> set server1.iiop-listener.orb_listener_id.address=bluestar

log-service

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-17 日志配置属性

server.xml 名称	asadmin 名称
file	file
level	level
log-stdout	stdout
log-stderr	stderr
echo-log-messages-to-stderr	echoToStderr
create-console	createConsole
log-virtual-server-id	LogVirtualServerId
use-system-logging	useSystemLogging

要获取实例 (server1) 的所有属性：

asadmin> get server1.log-service.*

要获取名为 level 的属性：

asadmin> get server1.log-service.level

要将名为 echoToStderr 的属性的值设置为 True：

asadmin> set server1.log-service.echoToStderr=true

security-service

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-18 安全性领域配置属性

server.xml 名称	asadmin 名称
default-realm	defaultRealm
default-principal	defaultPrinicpal
default-principal-password	defaultPrinicpalPassword
anonymous-role	anonymousRole
audit-enabled	auditEnabled
log-level	logLevel

要获取实例 (server1) 的所有属性：

asadmin> get server1.security-service.*

要获取名为 anonymousRole 的属性：

asadmin> get server1.security-service.anonymousRole

要将名为 encryptPasswords 的属性的值设置为 True：

asadmin> set server1.security-service.auditEnabled=true

http-service

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-19 HTTP 服务属性

server.xml 名称	asadmin 名称
qos-metrics-interval-in-seconds	qos-metrics-interval-in-seconds
qos-recompute-time-interval-in-millis	qos-recompute-time-interval-in-millis
qos-enabled	qos-enabled
bandwidth-limit	bandwidthLimit
enforce-bandwidth-limit	enforceBandwidthLimit
connection-limit	connectionLimit
enforce-connection-limit	enforceConnectionLimit

要获取实例 (server1) 的所有属性：

asadmin> get server1.http-service.*

要获取名为 bandwidthLimit 的属性：

asadmin> get server1.http-service.bandwidthLimit

要将名为 qos-enabled 的属性的值设置为 True：

asadmin> set server1.http-service.qos-enabled=true

jdbc-resource

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-20 JDBC 资源属性

server.xml 名称	asadmin 名称
jndi-name	name
pool-name	pool
enabled	enabled
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.jdbc-resource.jdbc_resource_name.*

要获取名为 pool 的属性：

asadmin> get server1.jdbc-resource.jdbc_resource_name.pool

要将名为 enabled 的属性的值设置为 True：

asadmin> set server1.jdbc-resource.jdbc_resource_name.enabled=true

jndi-resource

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-21 JNDI 资源属性

server.xml 名称	asadmin 名称
jndi-name	name
jndi-lookup-name	LookupName
res-type	resType
factory-class	factory
enabled	enabled
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.jndi-resource.jndi_name.*

要获取名为 factory 的属性：

asadmin> get server1.jndi-resource.jndi_name.factory

要将名为 factory 的属性的值设置为 com.sun：

asadmin> set server1.jndi-resource.jndi_name.factory=com.sun

jdbc-connection-pool

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-22 JDBC 连接池属性

server.xml 名称	asadmin 名称
name	name
datasource-classname	dsClassName
res-type	resType
description	description
steady-pool-size	steadyPoolSize
max-pool-size	maxPoolSize
max-wait-time-in-millis	maxWaitTime
pool-resize-quantity	resizeValue
idle-timeout-in-seconds	idleTimeout
transaction-isolation-level	transactionIsolationLevel
is-isolation-level-guaranteed	isIsolationLevelGuaranteed
connection-validation-method	validationMethod
is-connection-validation-required	isValidationRequired
fail-all-connections	failAll
validation-table-name	validationTable

要获取实例 (server1) 的所有属性：

asadmin> get server1.jdbc-connection-pool.pool_name.*

要获取名为 dsClassName 的属性：

asadmin> get server1.jdbc-connection-pool.pool_name.dsClassName

要将名为 resizeValue 的属性的值设置为 2：

asadmin> set server1.jdbc-connection-pool.pool_name.resizeValue=2

custom-resource

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-23 自定义资源属性

server.xml 名称	asadmin 名称
jndi-name	name
res-type	resType
factory-class	factory
enabled	enabled
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.custom-resource.jndi_name.*

要获取名为 factory 的属性：

asadmin> get server1.custom-resource.jndi_name.factory

要设置名为 factory 的属性：

asadmin> set server1.custom-resource.jndi_name.factory=myclass

jms-resource

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-24 JMS 资源属性

server.xml 名称	asadmin 名称
jndi-name	name
res-type	resType
enabled	enabled
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.jms-resource.jms_resource_name.*

要获取名为 res-type 的属性：

asadmin> get server1.jms-resource.jms_resource_name.resType

要将名为 enabled 的属性的值设置为 True：

asadmin> set server1.jms-resource.jms_resource_name.enabled=true

persistence-manager-factory-resource

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-25 持久性管理器工厂资源属性

server.xml 名称	asadmin 名称
jndi-name	jndiName
jdbc-resource-jndi-name	JdbcResourceJndiName
factory-class	factoryClass
enabled	enabled
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.persistence-manager-factory-resource.jndi_name

要获取名为 factoryClass 的属性：

asadmin> get server1.persistence-manager-factory-resource.jndi_name.factoryClass

要将名为 enabled 的属性的值设置为 True：

asadmin> set server1.persistence-manager-factory-resource.jndi_name.enabled=true

mail-resource

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-26 Java 邮件资源属性

server.xml 名称	asadmin 名称
jndi-name	name
enabled	enabled
store-protocol	storeProtocol
store-protocol-class	storeProtocolClass
transport-protocol	transportProtocol
transport-protocol-class	transportProtocolClass
host	host
user	user
from	from
debug	debug
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.mail-resource.jndi_name.*

要获取名为 host 的属性：

asadmin> get server1.mail-resource.jndi_name.host

要将名为 enabled 的属性的值设置为 True：

asadmin> set server1.mail-resource.jndi_name.enabled=true

application

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-27 应用程序属性

server.xml 名称	asadmin 名称
name	name
location	location
virtual-servers	virtualServers
description	description
enabled	enabled

要获取实例 (server1) 的所有属性：

asadmin> get server1.application.application_name.*

要获取应用程序中名为 location 的属性：

asadmin> get server1.application.application_name.location

要设置名为 location 的属性：

asadmin> set server1.application.application_name.location=
"/export/home/as7se/as1/repository/applications/ASConverter"

ejb-module

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-28 EJB 模块属性

server.xml 名称	asadmin 名称
name	name
location	location
description	description
enabled	enabled

要获取实例 (server1) 中独立 EJB 模块的所有属性：

asadmin> get server1.ejb-module.ejb_jar_name.*

要获取实例 (server1) 的应用程序中的 EJB 模块的所有属性：

asadmin> get server1.j2ee-application.application_name.ejb-module.ejb_jar_name.*

或

asadmin>get server1.application.application_name.ejb-module.ejb_jar_name.*

要获取独立 EJB 模块的名为 location 的属性：

asadmin> get server1.ejb-module.ejb_jar_name.location

要获取应用程序中 EJB 模块的名为 location 的属性：

asadmin> get server1.j2ee-application.application_name.ejb-module.ejb_jar_name.
location

或

asadmin> get server1.application.application_name.ejb-module.ejb_jar_name.location

要设置独立 EJB 模块的名为 location 的属性：

asadmin> set server1.ejb-module.ejb_jar_name.location="/export/home/as7se/as1/repository/modul es/ejb_jar_name"

要设置捆绑到应用程序的 EJB 模块中名为 location 的属性：

asadmin> set server1.j2ee-application.application_name.ejb-module.ejb_jar_name.
location="/export/home/as7se/as1/repository/modules/ejb_jar_name"

或

asadmin>set server1.application.application_name.ejb-module.ejb_jar_name.location="/export/ho me/as7se/as1/repository/modules/ejb_jar_name"

web-module

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-29 WEB 模块属性

server.xml 名称	asadmin 名称
name	name
location	location
context-root	contextRoot
virtual-servers	virtualServers
description	description
enabled	enabled

要获取实例 (server1) 中独立 Web 模块的所有属性：

asadmin> get server1.web-module.web_war_name.*

要获取实例 (server1) 的应用程序中的 Web 模块的所有属性：

asadmin> get server1.web-module.application_name.web_war_name.*

要获取独立 Web 模块的名为 location 的属性：

asadmin> get server1.web-module.web_war_name.location

要获取应用程序中 Web 模块的名为 location 的属性：

asadmin> get server1.web-module.application_name.web_war_name.location

要设置独立 Web 模块的名为 location 的属性：

asadmin> set server1.web-module.war-ic.location=
"/export/home/as7se/as1/repository/modules/web_war_name"

要设置捆绑到应用程序的 Web 模块中名为 location 的属性：

asadmin> set server1.web-module.application_name.web_war_name.location=
"/export/home/as7se/as1/repository/modules/web_war_name"

connector-module

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-30 连接器模块属性

server.xml 名称	asadmin 名称
name	name
location	location
description	description
enabled	enabled

要获取实例 (server1) 中独立连接器模块的所有属性：

asadmin> get server1.connector-module.connector_rar_name.*

要获取独立连接器模块的名为 location 的属性：

asadmin> get server1.connector-module.connector_rar_name.location

要设置独立连接器模块的名为 location 的属性：

asadmin> set server1.connector-module.connector_rar_name.location=
"/export/home/as7se/as1/repository/modules/connector_rar_name"

http-listener 或 http-server.http-listener

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-31 HTTP 侦听程序属性

server.xml 名称	asadmin 名称
id	id
address	address
port	port
family	family
acceptor-threads	acceptorThreads
blocking-enabled	blockingEnabled
security-enabled	securityEnabled
default-virtual-server	defaultVirtualServer
server-name	serverName
enabled	enabled
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

要获取实例 (server1) 的所有属性：

asadmin> get server1.http-listener.http_listener_name.*

或

asadmin> get server1.http-server.http-listener.http_listener_name.*

要获取名为 factory 的属性：

asadmin> get server1.httpl-listener.http_listener_name.address

或

asadmin> get server1.http-server.http-listener.http_listener_name.address

要将名为 address 的属性的值设置为 IP 地址 0.0.0.0：

asadmin> set server1.http-listener.http_listener_name.address=0.0.0.0

或

asadmin> set server1.http-server.http-listener.http_listener_name.address=0.0.0.0

mime

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-32 MIME 类型属性

server.xml 名称	asadmin 名称
id	id
file	file

要获取实例 (server1) 的所有属性：

asadmin> get server1.mime.mime_name.*

要获取名为 file 的属性：

asadmin> get server1.mime.mime_name.file

要将名为 file 的属性的值设置为 mime.types：

asadmin> set server1.mime.mime_name.file=mime.types

acl

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-33 ACL 属性

server.xml 名称	asadmin 名称
id	id
file	file

要获取实例 (server1) 的所有属性：

asadmin> get server1.acl.acl_name.*

要获取名为 file 的属性：

asadmin> get server1.acl.acl_name.file

要设置名为 file 的属性：

asadmin> set server1.acl.acl_name.file=com/as1.acl

virtual-server

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-34 虚拟服务器属性

server.xml 名称	asadmin 名称
id	id
http-listeners	httpListeners
config-file	configFile
default-object	defaultObject
accept-language	acceptLanguage
log-file	logFile
default-web-module	defaultWebModule
hosts	hosts
mime	mime
state	state
acls	acls
bandwidth-limit	bandwidthLimit
enforce-bandwidth-limit	enforceBandwidthLimit
connection-limit	connectionLimit
enforce-connection-limit	enforceConnectionLimit
property name="dir" value=	property.dir
property name="nice" value=	property.nice
property name="user" value=	property.user
property name="group" value=	property.group
property name="chroot" value=	property.chroot
property name="docroot" value=	property.docroot
property name="accesslog" value=	property.accesslog

要获取实例 (server1) 的所有属性：

asadmin> get instance_name.virtual-server.vserver_id.*

例如：

asadmin> get server1.virtual-server.server1.*

要获取虚拟服务器 server1 的名为 httpListeners 的属性：

asadmin> get server1.virtual-server.server1.httpListeners

要将名为 acceptLanguage 的属性的值设置为 False：

asadmin> set server1.virtual-acceptLanguage=false

auth-db

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-35 验证数据库属性

server.xml 名称	asadmin 名称
id	id
database	database
basedn	basedn
certmaps	certmaps

要获取实例的所有属性：

asadmin> get instancename.virtual-server.vserver_id.auth-db.authdb_id.*

例如，对于实例 server1、虚拟服务器 server1：

asadmin> get server1.virtual-server.server1.auth-db.authdb_id.*

要获取名为 database 的属性：

asadmin> get server1.virtual-server.server1.auth-db.authdb_id.database

要设置名为 database 的属性：

asadmin> set server1.virtual-server.server1.auth-db.authdb_id.database=Oracle

authrealm

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-36 验证领域属性

server.xml 名称	asadmin 名称
name	name
classname	classname

要获取实例 (server1) 的所有属性：

asadmin> get server1.authrealm.authrealm_id.*

要获取名为 classname 的属性：

asadmin> get server1.authrealm.authrealm_id.classname

要设置名为 classname 的属性：

asadmin> set server1.authrealm.authrealm_id.classname=com.sun.as.security.auth.realm.sharedpas sword.SharedPasswordRealm

lifecycle-module

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-37 生命周期模块属性

server.xml 名称	asadmin 名称
name	name
enabled	enabled
class-name	className
classpath	classPath
load-order	loadOrder
is-failure-fatal	isFailureFatal
description	description

要获取实例 (server1) 的所有属性：

asadmin> get server1.lifecycle-module.lifecycle_module_id.*

要获取生命周期模块的名为 className 的属性：

asadmin> get server1.lifecycle-module.lifecycle_module_id.className

要设置名为 className 的属性：

asadmin> set server1.lifecycle-module.lifecycle_module_id.className=com.lifecycle_module_id.li fecycle

profiler

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-38 JVM 事件探查器配置属性

server.xml 名称	asadmin 名称
name	name
classpath	classPath
native-library-path	nativeLibraryPath
enabled	enabled

要获取实例 (server1) 的所有属性：

asadmin> get server1.profiler.*

要获取名为 enabled 的属性：

asadmin> get server1.profiler.enabled

要将名为 enabled 的属性的值设置为 False：

asadmin> set server1.profiler.enabled=false

server configuration (服务器实例的名称)

下表的左列显示了属性的 server.xml 名称，右列显示了 asadmin 使用的名称。

表 A-39 服务器配置属性

server.xml 名称	asadmin 名称
instance-name	name
locale	locale
log-root	logRoot
session-store	sessionStore
application-root	applicationRoot
dynamic-reload-enabled	appDynamicReloadEnabled
dynamic-reload-poll-interval-in-seconds	appReloadPollInterval

要获取实例 (server1) 的所有属性：

asadmin> get server1.*

要获取名为 logRoot 的属性：

asadmin> get server1.logRoot

要设置名为 logRoot 的属性：

asadmin> set server1.logRoot="/space/log"

长选项和短选项格式、默认值以及等效的环境变量

下表列出了命令行选项的长格式和短格式。如果未列出短格式，则表明该选项没有短格式。

表 A-40 短选项和长选项、默认值以及环境变量

选项名	长格式	短格式	默认值	环境变量
acceptlang	--acceptlang			AS_ADMIN_ACCEPT_
acceptorthreads	--acceptorthreads			AS_ADMIN_ACCEPTOR_THREADS
acls	--acls			AS_ADMIN_ACLS
address	--address			AS_ADMIN_ADDRESS
adminpassword	--adminpassword			AS_ADMIN_ADMINPASSWD
adminport	--adminport		4848	AS_ADMIN_ADMINPORT
adminuser	--adminuser			AS_ADMIN_ADMINUSER
basedn	--basedn			AS_ADMIN_BASEDN
blockingenabled	--blockingenabled			AS_ADMIN_BLOCKINGENABLED
bwlimit	--bwlimit			AS_ADMIN_BWLIMIT
certmaps	--certmaps			AS_ADMIN_CERTMAPS
certname	--certname			AS_ADMIN_CERTNAME
classname	--classname			AS_ADMIN_CLASSNAME
classpath	--classpath			AS_ADMIN_CLASSPATH
clientauthenabled	--clientauthenabled			AS_ADMIN_CLIENTAUTHENABLED
configfile	--configfile			AS_ADMIN_CONFIGFILE
connectionpoolid	--connectionpoolid			AS_ADMIN_CONNECTIONPOOLID
connlimit	--connlimit			AS_ADMIN_CONNLIMIT
contextroot	--contextroot			AS_ADMIN_CONTEXTROOT
database	--database			AS_ADMIN_DATABASE
debug	--debug		false	AS_ADMIN_DEBUG
defaultobj	--defaultobj			AS_ADMIN_DEFAULTOBJ
defaultwebmodule	--defaultwebmodule			AS_ADMIN_DEFAULTWEBMODULE
description	--description			AS_ADMIN_DESCRIPTION
discardmanualchanges	--discardmanualchanges	-d	false	AS_ADMIN_DISCARDMANUALCHANGES
echo	--echo	-e	false	AS_ADMIN_ECHO
enabled	--enabled			AS_ADMIN_ENABLED
enforcebwlimit	--enforcebwlimit			AS_ADMIN_ENFORCEBWLIMIT
enforceconnlimit	--enforceconnlimit			AS_ADMIN_ENFORCECONNLIMIT
failconnection	--failconnection		false	AS_ADMIN_FAILCONNECTION
failurefatal	--failurefatal		false	AS_ADMIN_FAILUREFATAL
family	--family			AS_ADMIN_FAMILY
file	--file	-f		AS_ADMIN_FILE
force	--force	-F	true	AS_ADMIN_FORCE
help	--help	-h		AS_ADMIN_HELP
host	--host	-H		AS_ADMIN_HOST
hosts	--hosts			AS_ADMIN_HOSTS
httplistenerid	--httplistenerid			AS_ADMIN_HTTPLISTENERID
httplisteners	--httplisteners			AS_HTTP_LISTENERS
idletimeout	--idletimeout		300	AS_ADMIN_IDLETIMEOUT
instance	--instance	-i	server1	AS_ADMIN_INSTANCE
instanceport	--instanceport			AS_ADMIN_INSTANCEPORT
interactive	--interactive	-I	true	AS_AMDIN_INTERACTIVE
isconnectvalidaterequired	--isconnectvalidaterequired		false	AS_ADMIN_ISCONNECTVALIDATEREQUIRED
jdbcjndiname	--jdbcjndiname	-a		AS_ADMIN_JDBCJNDINAME
jndilookupname	--jndilookupname	-l		AS_ADMIN_JNDILOOKUPNAME
keepmanualchanges	--keepmanualchanges	-k	false	AS_ADMIN_KEEPMANUALCHANGES
loadorder	--loadorder			AS_ADMIN_LOADORDER
local	--local	-l	false
logfile	--logfile			AS_ADMIN_LOGFILE
maxpoolsize	--maxpoolsize		32	AS_ADMIN_MAXPOOLSIZE
maxwait	--maxwait		6000	AS_ADMIN_MAXWAIT
mime	--mime			AS_ADMIN_MIME
mimefile	--mimefile			AS_ADMIN_MIMEFILE
monitor	--monitor	-m	false	AS_ADMIN_MONITOR
name	--name	-n		AS_ADMIN_NAME
nativelibpath	--nativelibpath			AS_ADMIN_NATIVELIBPATH
objtype	--objtype	-o		AS_ADMIN_OBJTYPE
password	--password	-w		AS_ADMIN_PASSWORD
poolresize	--poolresize		2	AS_ADMIN_POOLRESIZE
port	--port	-p	8000	AS_ADMIN_PORT
prefix	--prefix	-x		AS_ADMIN_PREFIX
printprompt	--printprompt	-P	true	AS_ADMIN_PROMPT
property	--property			AS_ADMIN_PROPERTY
securityenabled	--securityenabled			AS_ADMIN_SECURITYENABLED
servername	--servername			AS_ADMIN_SERVERNAME
ssl2ciphers	--ssl2ciphers			AS_ADMIN_SSL2CIPHERS
ssl2enabled	--ssl2enabled			AS_ADMIN_SSL2ENABLED
ssl3enabled	--ssl3enabled			AS_ADMIN_SSL3ENABLED
ssl3tlsciphers	--ssl3tlsciphers			AS_ADMIN_SSL3TLSCIPHERS
state	--state			AS_ADMIN_STATE
steadypoolsize	--steadypoolsize	8		AS_ADMIN_STEADYPOOLSIZE
storeprotocol	--storeprotocol			AS_ADMIN_STOREPROTOCOL
storeprotocolclass	--storeprotocolclass			AS_ADMIN_STOREPROTOCOLCLASS
tlsenabled	--tlsenabled			AS_ADMIN_TLSENABLED
tlsrollbackenabled	--tlsrollbackenabled			AS_ADMIN_TLSROLLBACKENABLED
transprotocol	--transprotocol		smtp	AS_ADMIN_TRANSPROTOCOL
type	--type			S_ADMIN_TRANSPROTOCOLCLASS
upload	--upload	-U	true	AS_ADMIN_TYPE
url	--url			AS_ADMIN_URL
user	--user	-u		AS_ADMIN_USER
validationmethod	--validationmethod		auto-commit	AS_ADMIN_VALIDATIONMETHOD
validationtable	--validationtable			AS_ADMIN_VALIDATIONTABLE
version	--version	-v		AS_AMDIN_VERSION
virtualserver	--virtualserver			AS_ADMIN_VIRTUALSERVER

上一个      目录      索引      下一个

---

版权所有 2003 Sun Microsystems, Inc.。保留所有权利。