适用于 Microsoft Windows 的 Sun Java Enterprise System 5 安装指南

第 5 章 完成安装后配置

本章包含关于在 Sun Java Enterprise System (Java ES) 组件安装后,完成其初始配置的说明。如果某个 Java ES 组件未在本章中列出,则表示该组件不需要进行安装后配置。不过,该组件可能仍需要与监视数据服务相关的安装后任务(如果您要安装这些 Java ES 组件)。

本章包括以下各节:

如何使用本章

在 Java ES 安装程序完成安装后,大多数组件均需要进行附加配置,之后,Java ES 环境才能有效运作。此项工作的范围取决于所选择的配置类型(“安装过程中自动配置”或“安装后手动配置”)。

如果选择了“安装后手动配置”选项,安装程序会将组件软件包文件放在其各自的目录中。由于不进行任何参数设置,运行时服务不可用,因此大多数组件都不能运行。许多组件都包括用于完成安装后手动配置的配置工具。运行配置工具时,通过按照本指南和每个组件文档中的说明操作可进行任何附加更改。

在按照本章中的信息操作之前,您应该已经完成了 Java ES 组件的安装。有关与组件相关联的软件包列表,参见附录 B,默认目录和端口。可在 JavaES-install-dir\Summarydate .txt 文件中获得一份摘要报告,其中包含在安装期间所设置的配置值。

完成安装后,请就您所安装的 Java ES 组件查看本章中所包含的过程。如果您的 Java ES 组件不需要任何附加配置,可按照第 6 章,检验安装的 Java ES 组件中的说明启动 Java ES 组件。


注 –

Java ES 组件的默认安装位置可能因平台而异。因此,本章中的过程会使用变量来表示这些位置。例如,ApplicationServer-base 表示 Application Server 的安装目录,与平台无关。


Monitoring Console 安装后配置

如果您安装的 Java ES 组件将要使用 Java ES 监视功能,则必须将每个组件配置为使用 Monitoring Framework。有关配置说明,参阅《Sun Java Enterprise System 5 监视指南》中的第 2  章 “启用和配置 Monitoring Framework”

Access Manager 安装后配置

每当您使用 Java ES 安装程序在 Web Server 上配置 Access Manager 时,都需要执行以下步骤。


注 –

对于所有 Access Manager 安装,均需重新启动 Web 容器。如果正在 Web Server 或 Application Server 上执行完全安装,安装程序将停止 Web 容器实例,这要求您手动启动 Web 容器。有关重新启动 Access Manager 的说明,参见启动和停止 Access Manager


Procedure在 Web Server 上配置 Access Manager

  1. 启动 Directory Server。

  2. 启动 Web 容器。

在“安装过程中自动配置”操作完成后配置 Access Manager

在“安装过程中自动配置”操作完成后,可启动 Access Manager 并登录到 Access Manager 控制台。不过,您只有完成一些最终配置步骤方可执行基本的用户管理操作。这些步骤会有所不同,具体取决于 Access Manager 是否正在使用已置备用户数据的 Directory Server 实例。您可能还需要对您的部署执行以下附加配置任务。

有关执行这些任务的说明,参阅《Sun Java System Access Manager 7.1 Postinstallation Guide》。

在“安装后手动配置”操作完成后配置 Access Manager

在“安装后手动配置”操作完成后,软件包已经安装,您可以使用 Access Manager 配置批处理文件 AccessManager-base \setup\amconfig.bat 来配置 Access Manager。有关使用此程序的更多信息,参见《Sun Java System Access Manager 7.1 Postinstallation Guide》

有关针对第三方 Web 容器(BEA WebLogic 或 IBM WebSphere Application Server)配置 Access Manager 的说明,参见《Sun Java System Access Manager 7.1 Postinstallation Guide》。

Application Server 安装后配置

在“安装过程中自动配置”操作完成后,Application Server 不需要任何安装后配置,但您需要在“安装过程中自动配置”和“安装后手动配置”操作完成之后配置 Application Server 负载平衡插件。

Procedure在“安装后手动配置”操作完成后配置 Application Server

  1. 找到 Application Server 的附件 DVD。

    附件内容也可以从位于 http://www.sun.com/download/index.jsp 的“Sun 下载中心”下载。

  2. 参阅 DVD 上 Addon 文件夹中的 README 文件,并按照其中详细介绍的过程操作。

  3. 修改 ApplicationServer-base\samples\common.properties 文件。

    修改 common.properties 文件中的以下属性。如果不知道某些属性的路径,可从 ApplicationServer-base \config\asenv.conf 文件中复制。

    • com.sun.aas.derbyRoot=JavaDB-base

    • com.sun.aas.webServicesLib=ApplicationServer-base/lib

    • com.sun.aas.imqHome=ApplicationServer-base/domains/domain1/imq

    • com.sun.aas.imqBinDir=MessageQueue-base/bin

    • com.sun.aas.imqUserMgr=MessageQueue-base/bin/imqusermgr

    • com.sun.aas.imqLib=MessageQueue-base/lib

    • com.sun.aas.installRoot=ApplicationServer-base

    • com.sun.aas.javaRoot=J2SE-base

    • com.sun.aas.domains.dir=ApplicationServer-base/domains

    • #admin.password=

      管理员密码没有作为默认值保存。用户可手动键入密码并予以保存。

    • admin.host=jws-v210-4

    • appserver.instance=server

      默认情况下,appserver.instance 的值为 AppServer1。将 AppServer1 替换为 server。有关更多信息,参见错误号 6485254。

    • appserver.instance.port=8080

    • admin.user=admin

    • admin.port=4849

    • derby.port=1527

    • domain.name=domain1

    • server.cert.alias=s1as

    • keystore=${com.sun.aas.domains.dir}/${domain.name}/config/keystore.jks

    • keystore.password=changeit

    • trustStore=${com.sun.aas.domains.dir}/${domain.name}/config/cacerts.jks


    注 –

    要配置 Application Server 以实现负载平衡,参阅《Sun Java System Application Server Enterprise Edition 8.2 High Availability Administration Guide》中的第 5  章 “Configuring HTTP Load Balancing”中的“配置 Web Server 以实现 HTTP 负载平衡”一节。


Procedure配置 Application Server 负载平衡插件

  1. 在注册表中将 IS_LB 的值设置为 "true",将 Cfgr_LB 的值设置为 "false"。

    Windows 2000

    HKEY_LOCAL_MACHINE > Software > Sun Microsystems > EntSys5 > Installer > Application Server

    Windows 2003 x64 版

    HKEY_LOCAL_MACHINE > Software > Wow6432node > Sun Microsystems > EntSys5 > Installer > Application Server

  2. 编辑 ApplicationServer-base\setup\ASConfigurator.properties 文件。

    设置 AS_WSINSTANCEDIRAS_WSINSTANCENAME 属性的值。例如,键入:

    AS_WSINSTANCEDIR= C:\\Sun\\JavaES5\\WebServer7\\https-jws-winpc-1.red.iplanet.com

    AS_WSINSTANCENAME=https-jws-winpc-1.red.iplanet.com

  3. 运行 ApplicationServer-base\setup\ASConfigure.bat 命令。

Directory Proxy Server 安装后配置操作

在“安装过程中自动配置”操作完成后,不必进行任何附加配置。

在“安装后手动配置”操作完成后,软件包已经安装,您可以对 Directory Proxy Server 进行配置。有关 Directory Proxy Server 实例创建的说明,参见《Sun Java System Directory Server Enterprise Edition 6.0 Installation Guide》。

Procedure在“安装后手动配置”操作完成后配置 Directory Proxy Server

  1. 切换到 DirectoryProxyServer-base\dps6\bin 目录。

    cd DirectoryProxyServer-base\dps6\bin

  2. 创建 Directory Proxy Server 实例。

    dpadm.exe create -p port-no -P ssl-port-no instance-path

  3. 启动该实例。

    dpadm.exe start instance-path

Directory Server 安装后配置

在“安装后手动配置”操作完成后,软件包已经安装,您可以执行 Directory Server 的配置任务。

Procedure在“安装后手动配置”操作完成后配置 Directory Server

  1. 切换到 DirectoryServer-base\ds6\bin 目录。

    cd DirectoryServer-base\ds6\bin

  2. 创建 Directory Server 实例。

    dsadm.exe create -p port-no -P ssl-port-no instance-path

  3. 启动该实例。

    dsadm.exe start instance-path

  4. 根据对应的域组件创建根后缀。

    dsconf.exe create-suffix --unsecured -p port-no root-suffix

Procedure在“安装后手动配置”操作完成后配置 Directory Service Control Center (DSCC)

  1. 切换到 DirectoryServer-base\ds6\bin 目录。

    cd DirectoryServer-base\ds6\bin

  2. 运行 dsccsetup.exe

HADB 安装后配置

HADB 不需要任何附加的安装后配置。

Message Queue 安装后配置

在“安装过程中自动配置”操作完成后,不需要进行任何附加配置。可使用 Windows 服务启动 Message Queue,参见使用 Windows 服务启动 Message Queue

在“安装后手动配置”操作完成后,软件包已经安装,您可以执行 Message Queue 的配置任务。有关安装后配置说明的更多信息,参见《Sun Java System Message Queue 3.7 UR1 Administration Guide》

Portal Server 和 Portal Server Secure Remote Access 安装后配置

在“安装过程中自动配置”操作期间,安装程序将只配置 Portal Server。

在“安装后手动配置”操作完成后,仅复制了文件。您需要手动完成 Portal Server 的配置。

如果选择安装 Application Server 和 Web Server 两者,则部署 Access Manager 时,将使用 Web Server 作为默认的 Web 容器。Portal 会部署到其中部署了 Access Manager 的容器中。


注 –

如果是在未安装 Portal Server 的计算机上配置 SRA 组件,应使用 psconfig.bat 命令。


在“安装过程中自动配置”操作完成后配置 Portal Server 和 Portal Server Secure Remote Access

在“安装过程中自动配置”操作期间,安装程序将只配置 Portal Server。如果选择了 Portal Server Secure Remote Access (SRA) 组件,则将安装相应的 MSI 软件包,但不会对这些组件进行配置。Portal Server SRA 组件包括:

可使用以下实用程序之一配置 SRA 组件:

Procedure使用 psadmin.bat 配置 SRA

  1. 将所需 SRA 组件的模板属性文件从 PortalServer-base\template\sra 目录复制到 portalserver-base\ data

    模板属性文件为:

    • GatewayGWConfig.properties.template

    • Netlet ProxyNLPConfig.properties.template

    • Rewriter ProxyRWPConfig.properties.template

  2. 启动 Directory Server。

  3. 启动 Cacao 实例。

  4. 启动 Web 容器。

  5. 编辑模板属性文件。

  6. 开启 SRA。

    PortalServer-base\bin\psadmin.bat switch-sra-status -u admin-user-name -f password-file on

  7. 启用 SRA。

    PortalServer-base\bin\psadmin.bat provision-sra -u admin-user-name -f password-file -p PortalName --gateway-profile gateway_profile -enable

  8. 创建 SRA 组件实例。

    PortalServer-base\bin\psadmin.bat create-sra-instance -u admin-user-name -f password-file -S PortalServer-base/data/template-property-file -t gateway/nlproxy/rwproxy

  9. 启动 SRA 实例。

    PortalServer-base \bin\psadmin.bat start-sra-instance -u admin-user-name -f password-file -N gateway_profile -t gateway/nlproxy/rwproxy

Procedure使用 psconfig.bat 配置 SRA

  1. 切换到 PortalServer-base\samples\psconfig 目录。

  2. 选择相应的示例 xml 文件并使用适当的值编辑该文件。

    使用 PortalServer-base \samples\psconfig 下的 README.txt 选择相应的示例文件并使用适当的值对其进行修改。相关的样例 xml 文件为:

    example10.xml

    仅安装 Gateway 组件的模板样例配置文件

    example11.xml

    仅安装 Netlet Proxy 组件的模板样例配置文件

    example12.xml

    仅安装 Rewriter Proxy 组件的模板样例配置文件

    example17.xml

    用于将 Portal Server 或 Search Server 以及所有 SRA 组件配置为部署到 Web Server 容器中的模板样例配置文件

  3. 运行 psconfig.bat 命令。

    psconfig.bat --config PortalServer-base\samples\psconfigexample-file

Procedure在“安装后手动配置”操作完成后配置 Portal Server 和 Portal Server Secure Remote Access

  1. 切换到 PortalServer-base\samples\psconfig 目录。

  2. 选择相应的示例 xml 文件并使用适当的值编辑该文件。

    使用 PortalServer-base\samples\psconfig 下的 README.txt 选择相应的示例文件并使用适当的值对其进行修改。

  3. 运行 psconfig.bat 命令。

    psconfig.bat --config PortalServer-base\samples\psconfig example-file

Service Registry 安装后配置

Service Registry 无法在安装期间自动配置。在“安装后手动配置”操作完成后,软件包已经安装,可以按照以下过程执行 Service Registry 的配置任务。

Procedure在“安装后手动配置”操作完成后使用默认属性配置 Service Registry

配置进程会在 ServiceRegistry-base\data 处创建一个 Application Server 域。默认域名为 registry。随后,配置进程将启动该域、部署 Service Registry 并使该域处于运行状态。默认配置目录为 ServiceRegisry-base

  1. 以管理员身份登录。

  2. 切换到 ServiceRegistry-base\install 目录。

  3. 检验是否设置了 JAVA_HOME 环境变量。

  4. 运行 SRConfig.bat 命令。


    注 –

    要使用自定义属性设置执行配置,参见《Service Registry 3.1 管理指南》。


Web Proxy Server 安装后配置

在“安装过程中自动配置”操作完成后,不需要进行任何附加配置。在“安装后手动配置”操作完成后,软件包已经安装,您可以按照以下过程配置 Web Proxy Server。

Procedure在“安装后手动配置”操作完成后配置 Web Proxy Server

  1. 切换到 Web Proxy Server-base\bin\proxy\install\misc 目录。

  2. 使用您的设置更新属性文件。

    例如,wps.properties 文件可能包含以下内容:


    WPS_JDK_HOME=<Java_Home>
    WPS_SERVER_ROOT=JavaES-install-dir\webproxyserver
    WPS_ADMIN_NAME=admin
    WPS_ADMIN_PWD=admin123
    WPS_ADMIN_PORT=8889
    WPS_START_ON_BOOT=N
    WPS_ADMIN_SERVER_USER=root
    WPS_SERVER_NAME=jws-v60x-4.red.iplanet.com
    WPS_SERVER_PORT=8081
    WPS_SERVER_ID=proxy-server1
    WPS_ADMIN_SERVER_ID=proxy-admserv
    WPS_SERVER_USER=root
  3. 转到位置 WebProxyServer-base。

  4. 运行 WPSConfigure.bat 命令。

Web Server 安装后配置

在“安装过程中自动配置”操作完成后,不需要对 Web Server 进行任何附加配置。

Procedure在“安装后手动配置”操作完成后配置 Web Server

在“安装后手动配置”操作完成后,软件包已经安装,您可以按照以下过程配置 Web Server。

  1. 运行 Web Server 配置程序,为 Web Server 创建运行时配置。

    有关更多信息,参见《Sun Java System Web Server 7.0 Installation and Migration Guide》中的“Configure Later Mode (Java ES Only)”

  2. 检验通用服务器设置并根据需要更新设置。

配置 Java 虚拟机软件

在完成 Java ES 组件的必需安装后配置之后,某些 Java ES 组件可能会要求您对 Java 虚拟机 (Java Virtual Machine, JVMTM) 软件进行调优。JVM 软件包括多个实体,其中最重要的是编译器,它可将 Java 字节代码转换为机器指令。在本 Java ES 发行版本随附的 Java 开发工具包 (Java development kit, JDKTM) 软件版本中,可针对 JVM 软件做出多种选择。最佳的启动选项是 –server 选项。对于在服务器模式下运行的 JVM 而言,–server 是一个很好的调优选项。通过使用 java –? 命令可获得选项列表。

其他可能需要配置的主要调优选项是 Java 堆内存。例如:

对于频繁使用的系统的起点,将最大堆大小设置为 1.2 GB 比较合适。

接下来的操作

完成本章中的配置任务之后,请按照第 6 章,检验安装的 Java ES 组件所述,通过启动 Java ES 组件来检验安装后配置。