Sun Java System Web Server 7.0 Update 3 管理员指南

第 2 章配置、实例和节点

上一章介绍了 Web Server 7.0 中的一些新概念。管理员的主要任务是配置和管理服务器的运行时服务。本章介绍可以管理配置的不同方法，以及如何部署配置以在节点中启动实例。

概述

实例是指给定节点上 Web 服务器守护进程的环境，包括其配置、日志文件和其他运行时辅件，例如锁定数据库、高速缓存和临时文件。

节点是网络资源，例如服务器或主机。在典型数据中心中，节点构成的网络称为服务器群。本节讨论如何使用管理控制台 GUI 配置节点。

您可以将一个或多个实例部署到节点。此外，还可以将同一实例部署到多个节点，同一实例也可以构成不同群集的一部分。

为了实现管理，可以启动、停止、重新启动或动态重新配置实例。

管理配置

创建配置

开始使用 Web 服务器之前，您需要创建配置。

要创建新配置，请执行以下步骤：

单击配置选项卡。
单击新建按钮。

向导将指导您完成用于创建配置的可用设置。以下各节提供了向导页面中的可用字段说明。

步骤 1－设置配置信息

此向导页面允许您设置新配置的一般信息。

在向导页面中设置以下参数：

配置名称－为配置添加新的唯一名称。
服务器名－为新配置添加服务器名。此名称可与配置名称相同。
文档根目录－请输入有效的文档根目录，所有已部署的 Web 应用程序均在此维护自己的目录。默认值为 ../docs。您可以输入服务器上任何有效目录的路径。
64 位－启用/禁用 Web 服务器的 64 位支持。默认值为禁用。
服务器用户－如果服务器在基于 UNIX 的系统上运行，请提供服务器进程的有效用户名。例如，root。

部署 2－为配置创建侦听器

此向导页面允许您为新配置设置 HTTP 侦听器属性。

在向导页面中设置以下参数：

端口－配置绑定并用来侦听请求的端口号。
IP 地址－主机的 IP 地址。键入 * 将设置所有可用的 IP 地址。

步骤 3－配置 Java、CGI 和 SHTML

此向导页面允许您配置与 Java/CGI 和 SHTML 相关的属性。

在向导页面中设置以下参数：

Java－已启用。默认情况下，将启用 Java。警告：如果需要使用此配置部署基于 Java 的 Web 应用程序，请不要禁用 Java。设置 Java SE 目录的主目录。默认值为指向捆绑的 Java SE 目录的目录。可以选择默认 Java SE 目录或指定新路径。

注 –
如果 Web Server 实例没有为任何 Java Web 应用程序提供服务，则可以使用 disable-java CLI 命令或通过管理控制台禁用 Java。例如，FastCGI 和反向代理插件均为非 Java 应用程序。禁用 Java 会减少 Web Server 实例的内存使用量。默认情况下，该实例将启用 Java。

有关禁用 Java 的更多信息，请参见 CLI 参考 disable-java(1) 和 enable-java(1)。
CGI－无（禁用 CGI 支持）、启用为文件类型（启用 CGI 支持）和目录（指定将存储 CGI 文档的 URI 和路径）。
SHTML－默认情况下，禁用 SHTML。

恢复配置

在本节中，您可以恢复以前部署的配置。

注 –

您只能恢复最近 7 个配置。

恢复配置

单击“配置”选项卡

单击“常规”>“恢复”子选项卡

从配置备份列表中选择相应的配置。

单击“恢复”按钮

单击管理控制台页面右上角的“部署暂挂”链接以部署恢复的配置

将打开一个新的弹出式窗口。

单击“部署”按钮

步骤 4－创建实例

此向导页面允许您为新配置创建实例。

在向导页面中设置以下参数：

配置－新配置的名称。
选择节点－选择要为新配置创建实例的节点。从可用列表中选择节点，然后单击添加或全部添加按钮以添加节点。

注 –

使用 CLI

要通过 CLI 创建配置，请执行以下命令：

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

config1 为新配置的名称。

请参见 CLI 参考 create-config(1)。

复制服务器配置

您可以通过复制服务器配置的方式来创建新配置。新复制的配置与现有配置相同。但是，新配置将不具有任何实例，即使从其进行复制的配置包含实例。

要复制配置，请执行以下步骤：

单击配置选项卡。
从配置列表中选择相应的配置。
单击复制按钮。
在弹出式窗口中，输入新的配置名称，然后单击“确定”。

注 –

使用 CLI

要通过 CLI 执行操作，请执行以下命令：

wadm> copy-config --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 copyconfig1

copyconfig1 是新配置的名称。

请参见 CLI 参考 copy-config(1)。

部署服务器配置

您需要先创建一个配置才能在节点上进行部署。

要部署现有的配置，请执行以下步骤：

单击配置选项卡。
通过选择配置复选框来标识配置。
单击部署按钮。
将显示一个新窗口，请单击部署按钮以部署配置。

删除服务器配置

注 –

如果某配置的实例已部署到节点上，则不能删除此配置。即使这些实例已部署但未运行，您也不能删除此服务器配置。停止正在运行的实例并取消部署这些实例可以删除配置。

要删除配置，请执行以下步骤：

单击配置选项卡。
通过选择配置复选框来标识配置。
单击删除按钮。
将显示一个新窗口，请单击确定按钮以删除配置。

将配置更改引入 Administration Server

手动更改配置时，应按照以下操作将更改复制回 Administration Server 系统信息库：

像 Web Server 的早期版本一样，手动编辑服务器实例的配置文件（不建议这样做）。
启动 Administration Server。
要将更改引入 Administration Server 系统信息库，请执行以下命令。
wadm> pull-config --user=admin --config=CONFIG_NAME

注 –

根据配置的不同，此操作可能需要一些时间。

注 –

应始终使用管理控制台或 wadm CLI 来编辑这些设置。在调用 pull-config 时，仅将 <instance_dir>/config 目录的内容从 Web Server 引入配置库。

从服务器中删除“管理节点”

在“日常任务”页中，单击“节点”选项卡。

选择“管理节点”。

从列表中选择“管理节点”

单击“删除”按钮。

管理服务器实例

创建服务器实例

创建新服务器实例之前，请先执行以下检查：

检查您是否已创建配置。创建新的服务器实例需要指定现有的实例配置。
检查服务器群中的所有可用节点是否均已具有所需配置的实例。您不能创建重复的实例。

要创建新服务器实例，请执行以下步骤：

单击配置选项卡，然后单击要创建实例的配置链接。
在“新建实例向导”页面中，选择需要创建实例的配置。如果要为此实例创建服务，请选择 SMF 服务，然后单击下一步按钮。
选择选定配置 [步骤 2] 的实例所在的节点。单击下一步按钮。
查看所做选择的摘要。单击下一步按钮以查看操作的结果。

注 –

使用 CLI

要创建服务器实例，请执行以下命令：

wadm> create-instance --user=admin --password-file=admin.pwd 
--host=serverhost --port=8989 --config=config1 serverhost

请参见 CLI 参考 create-instance(1)。

启动服务器实例

单击节点选项卡以查看在服务器中配置的节点列表。
通过选择节点名称复选框来选择节点。
单击启动实例按钮将打开一个页面窗口，其中列出了由该节点控制的所有实例。
选择一个实例并单击启动实例按钮以启动该实例。
检查该实例的状态是否为“正在运行”并关闭窗口。

注 –

使用 CLI

要通过 CLI 启动服务器实例，请执行以下命令：

wadm> start-instance --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 nodehost1

请参见 CLI 参考 start-instance(1)。

停止服务器实例

单击节点选项卡以查看在服务器中配置的节点列表。
通过选择节点名称复选框来选择节点。
单击停止实例按钮将打开一个页面窗口，其中列出了由该节点控制的所有实例。
选择一个实例并单击停止实例按钮以停止该实例。
检查该实例的状态是否为“未运行”并关闭窗口。

注 –

使用 CLI

要通过 CLI 停止服务器实例，请执行以下命令：

wadm> stop-instance --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 nodehost1

请参见 CLI 参考 stop-instance(1)。

重新启动服务器实例

单击节点选项卡以查看在服务器中配置的节点列表。
通过选择节点名称复选框来选择节点。
单击重新启动实例按钮将打开一个页面窗口，其中列出了由该节点控制的所有实例。
选择一个实例并单击重新启动实例按钮以重新启动该实例。
检查该实例的状态是否为“正在运行”并关闭窗口。

注 –

使用 CLI

wadm> restart-instance --user=admin --password-file=admin.pwd 
--host=serverhost --port=8989 --config=config1 nodehost1

请参见 CLI 参考 restart-instance(1)。

重新配置服务器实例

对配置进行更改时，一些情况下无需重新启动实例。Administration Server 支持重新配置服务器实例，以引入对配置库所进行的更改。在此配置中，更改将会反映到实例中，无需重新启动服务器。配置中只有可动态重新配置的更改会受到影响。

注 –

用户、临时路径、日志、线程库、pkcs11、统计信息、CGI、DNS、DNS 高速缓存、文件高速缓存、ACL 高速缓存、SSL 会话高速缓存、访问日志缓冲区和 JVM（日志级别除外）设置的更改只有在重新配置后才会生效。执行重新配置时，将会记录要求重新启动的所有更改。重新配置文件高速缓存要求重新启动服务器。

单击节点选项卡以查看在服务器中配置的节点列表。
通过选择节点名称复选框来选择节点。
单击重新配置实例按钮将打开一个页面窗口，其中列出了在该节点上已部署的所有实例。
选择一个实例并单击重新配置实例按钮以重新配置该实例。
检查该实例的状态是否为“正在运行”并关闭窗口。

注 –

使用 CLI

要通过 CLI 重新配置服务器实例，请执行以下命令：

wadm> reconfig-instance --user=admin --password-file=admin.pwd 
--host=serverhost --port=8989 --config=config1 serverhost

请参见 CLI 参考 reconfig-instance(1)。

删除服务器实例

注 –

要删除的服务器实例应处于未运行状态。

单击配置选项卡以查看可用配置的列表。
从配置列表中选择相应的配置。
单击实例子选项卡。
从节点部分下已部署的实例列表中选择实例。
从操作下拉式列表中选择删除实例以删除选定的实例。

注 –

使用 CLI

要通过 CLI 删除服务器实例，请执行以下命令：

wadm> delete-instance --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 serverhost

请参见 CLI 参考 delete-instance(1)。

自动配置实例

可以根据安排的事件重新配置实例或重新启动实例。您可以设置特定的时间和时间间隔来安排自动重新配置实例。

要安排事件，请执行以下步骤：

单击配置选项卡并选择相应的配置。
单击常规 > 安排的事件子选项卡。

添加安排的事件

选择配置。

单击“配置”选项卡后，从显示的列表中选择配置。

单击“常规”>“安排的事件”子选项卡。

单击“新建”按钮。

配置以下属性：
- 事件
  - 重新启动实例－此安排的事件将为相应的配置重新启动所有已部署且正在运行的实例。
  - 重新配置实例－此安排的事件将为相应的配置重新配置所有已部署且正在运行的实例。
  - 自定义命令行－提供将要执行的文件的绝对路径。
- 进度表
  
  配置的事件启动时间。从下拉式框中选择小时和分钟值。
  - 每天－每天在指定的时间启动指定的事件。
  - 特定日期－在特定日期启动指定的事件。
    
    1. 星期几－指定从星期日至星期六的任意一天。
    
    2. 日期－指定一个月中从 1 日至 31 日间的任意一天（以逗号分隔条目）。例如，4,23,9。
  - 特定月份－在特定时间和月份启动指定的事件。指定从一月至十二月之间的月份。
  - 时间间隔
    
    每隔此时间段即启动指定的事件。
    
    1. 间隔小时数－从下拉式框中选择小时数。
    
    2. 间隔秒数－在文本字段中输入秒数。
注 –
使用 CLI

要通过 CLI 安排事件，请执行以下命令：
wadm> create-event --user=admin --password-file=admin.pwd --host=serverhost --port=8989 --config=config1 --time=10:10 --command=restart
请参见 CLI 参考 create-event(1)。

删除安排的事件

选择配置。

单击“配置”选项卡后，从显示的列表中选择配置。

单击“常规”>“安排的事件”子选项卡。

选择安排的事件并单击“删除”按钮。

为 Administration Server 配置 LDAP 验证

Administration Server 只允许一个预定义的管理员登录，而不允许用户组管理。因此，如果多个用户必须登录到 Administration Server，请使用 LDAP 验证。您可以使用 LDAP 用户 ID 和密码通过管理控制台或 CLI 登录到 Administration Server。

注 –

默认情况下，Administration Server 只允许属于 wsadmin 组的用户进行登录。因此，在启用 LDAP 验证时，管理员可以定义 wsadmin 以外的一些组以允许其成员进行登录。

此外，也可以手动配置 LDAP auth-db 以允许 Administration Server 通过 LDAP 进行验证，如下所示：

<default-auth-db-name>ldap</default-auth-db-name>

<auth-db>
<name>ldap</name>
<url>ldap://ooooxxxxooooo.india.sun.com:389/dc963dindia,dc963dsun,dc963dcom</url>
<property>
<name>bindpw</name>
<value>YWRtaW5hZG1pbg==</value>
<encoded>true</encoded>
</property>
<property>
<name>binddn</name>
<value>cn=Directory Manager</value>
</property>
</auth-db>

配置 LDAP 验证

登录到管理控制台。

单击“节点”选项卡以查看在服务器中配置的节点列表。

单击列表中的“管理节点”。

从“Administration Server - 常规设置”页面中选择“验证”。

选择“使用 LDAP 验证”按钮。

注 –
将仅为 Administration Server 启用“使用 LDAP 验证”。

输入 LDAP 验证信息。

通过在“允许的组”文本字段中输入用户组，管理员可以启用或禁用该组的 LDAP 验证。

单击“保存”按钮。

注 –

使用 CLI

要允许 Administration Server 通过 LDAP 服务器进行验证，请执行以下命令。

wadm enable-admin-ldap-auth --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true --no-prompt rcfile=null 
--ldap-url=ldap://serverhost.com:3950/dc=xyz,dc=xyz,dc=xyz 
--bind-dn=cn="Directory Manager"

wadm enable-admin-ldap-auth --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true 
--ldap-url=ldap://serverhost:port/dc=acme,dc=com 
--allow-group="group1,group2,group3"

请参见 CLI 参考 enable-admin-ldap-auth(1)

要禁止 Administration Server 通过 LDAP 服务器进行验证，请执行以下命令。

wadm disable-admin-ldap-auth --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true --no-prompt --rcfile=null

请参见 CLI 参考 disable-admin-ldap-auth(1)

要显示 Administration Server 的 LDAP 验证属性，请执行以下命令。

wadm get-admin-ldap-auth-prop --user=admin --host=serverhost 
--password-file=../admin.passwd --port=8989 --ssl=true --no-prompt rcfile=null

wadm get-admin-ldap-auth-prop --user=admin 
--host=serverhost --password-file=../admin.passwd --port=8989 --ssl=true 
--no-prompt rcfile=null allow-group

请参见 CLI 参考 get-admin-ldap-auth-prop(1)

第 2 章 配置、实例和节点

概述

管理配置

创建配置

步骤 1－设置配置信息

部署 2－为配置创建侦听器

步骤 3－配置 Java、CGI 和 SHTML

恢复配置

恢复配置

步骤 4－创建实例

复制服务器配置

部署服务器配置

删除服务器配置

将配置更改引入 Administration Server

从服务器中删除“管理节点”

从服务器中删除“管理节点”

管理服务器实例

创建服务器实例

启动服务器实例

停止服务器实例

重新启动服务器实例

重新配置服务器实例

删除服务器实例

自动配置实例

添加安排的事件

删除安排的事件

为 Administration Server 配置 LDAP 验证

配置 LDAP 验证

第 2 章配置、实例和节点