使用 CLI

本节介绍 Sun Java System Web Server 7.0 的命令行界面，并定义用于配置和管理服务器的所有支持的命令。

Sun Java System Web Server 7.0 引入了称为 wadm 的新 CLI。

服务器的早期版本支持一些独立的命令行，这些命令行一起仅构成 GUI 中所提供全部管理功能的一个子集。Sun Java System Web Server 6.1 中支持的命令行界面有 HttpServerAdmin、wdeploy 和 flexanlg。新 CLI (wadm) 功能：

• 用于脚本编写的嵌入式 JACL shell。

• 可扩展的 CLI－可通过第三方插件向 CLI 中添加更多命令。

Sun Java System Web Server 7.0 不支持 HttpServerAdmin。

Sun Java System Web Server 7.0 中支持 wdeploy，其目的仅为了保持与 6.x 版本向后兼容，该命令将仅处理 Administration Server 节点。

CLI 模式

wadm 支持 3 种模式下的调用。它们是：

• 单机模式－在此模式下，可从命令 shell 调用 wadm，并指定需要的命令、选项和操作数。命令执行完后，CLI 将退出并返回到 shell。此模式既支持命令的交互执行，也支持非交互执行。默认情况下支持交互执行，如果密码文件中未指定密码（通过 --password-file 选项传递），将会提示您输入密码。如果未指定 --password-file 选项，非交互执行将会产生错误。例如，

  wadm> create-config --user=admin --password-file=./admin.pwd --http-port=2222 --server-name=syrinx myconfig

• Shell 模式－在此模式下，可从命令 shell 调用 wadm，但不指定命令。wadm 将提示用户输入命令。执行命令后，将返回到 shell。键入 exit 或 quit 命令可退出此 shell。交互执行和非交互执行都适用于此模式。例如，

  wadm -user=admin -host=serverhost --password-file=admin.pwd --port=8989

• 文件模式－在此模式下，可以在文件中添加一个命令列表，然后将该文件作为参数传递到 wadm。例如，

  wadm -user=admin -host=serverhost --password-file=admin.pwd --port=8989 -commands-file=/space/scripts/admscr

下图描述了调用 wadm 命令的语法。

使用 wadm CLI 时，可以执行使用管理控制台可以执行的所有任务。

何处可以找到 wadm CLI

哪里可以找到 Sun Java System Web Server 7.0 的管理 CLI？

管理 CLI 位于 install-root/bin/wadm 中。要使用 CLI，需要知道：

• 管理服务器主机名（默认为 localhost）。

• 管理服务器的 SSL 端口（默认为 8989）。

• 管理服务器用户名（默认为 admin）。

• 管理服务器密码。

要使用 CLI，需要运行管理服务器。可通过运行 install-root/admin-server/bin/startserv 启动该服务器。

CLI 中的验证

wadm 将使用管理员的用户名和密码通过 Administration Server 的验证。必须将有效的用户名和密码文件作为参数传递给单一模式下运行的每个命令。调用 wadm 可执行文件时，shell 模式接受用户名和密码文件。shell 模式下调用的命令不需要连接选项（例如，user、password-file、host、port 和 ssl）。如果指定了连接选项，它们将会被忽略。

CLI 支持的一些命令要求输入密码。例如， bindpw、user-password 和 token-pin。用户可以在包含管理用户密码的同一文件中指定这些密码。如果在指定命令时未指定 password-file，将会提示用户输入密码。

wadm 通过 SSL（如果 Administration Server 中启用了 SSL） 与 Administration Server 通信。Administration Server 传递的证书将会根据 truststore (~/.wadmtruststore) 进行验证。如果该证书存在并且有效，命令将正常继续执行。否则，wadm 将显示该证书，并让用户选择是否接受它。如果用户接受该证书，证书将被添加到 truststore 中，并且命令将正常继续执行。

由于 truststore 不包含任何敏感数据，所以不需要进行密码保护。