使用 CLI

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

Web Server 引入了一个称为 wadm 的新 CLI。

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

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

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

Web Server 不支持 HttpServerAdmin。

Web Server 支持 wdeploy，其目的仅为了与 6.x 版本保持向后兼容，该命令行界面仅适用于 Administration Server 节点。

CLI 模式

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

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

  wadm> create-config --doc-root=[DOCROOT] --jdk-home=[JAVAHOME] --server-user=[SERVERUSER] [--document-root=serverdocroot] [--platform=32|64] --http-port=port --server-name=servername CONFIGNAME

• 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

何处可以找到 Web Server 管理 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 不包含任何敏感数据，所以不需要进行密码保护。

重置管理密码

打开命令提示符终端并导航至 install-root/bin/wadm 目录，然后键入以下命令以重置密码：

./wadm reset-admin-password。

系统将提示您键入新的管理密码。再次键入密码以进行确认。重新启动服务器以使密码生效。现在，可以使用新密码登录到服务器。

在使用 set-admin-prop 命令更改密码时，必须从 install-root/admin-server/bin/restart 目录中重新启动 Administration Server。请勿使用 restart-admin 命令重新启动服务器。

向 Sun Connection 注册

可以使用管理控制台向 Sun Connection 注册 Web Server。在主页中单击向 Sun Connection 注册选项卡，将打开一个向导。按照向导说明完成注册。向 Sun Connection 注册 Web Server 具有以下好处。

• 修补程序信息和错误更新

• 新闻和事件

• 支持和培训服务