Sun Java logo     上一页      目录      索引      下一页     

Sun logo
Sun Java System Portal Server 6 2004Q2 管理员指南 

第 2 章
安装后的配置

最小安装配置

在使用 Sun Java™ Enterprise System 安装程序进行最小配置安装后，请使用 Portal Server 配置器对 Portal Server 组件产品进行配置。本部分的以下清单介绍了配置 Portal Server 组件产品所使用的参数。

运行配置器：

  1. 以根用户身份在终端窗口中转到包含配置器的目录：

    2. cd portal-server-install-root/SUNWps/lib

  2. 键入以下命令运行配置器脚本：

    3. ./configurator

    注

    开启调试功能：

    configurator -DPS_CONFIG_DEBUG=y

    如果开启了调试功能，屏幕上会显示口令以及调试信息。

  3. 按照配置屏幕上的说明进行操作。

如果已执行的是最小安装，您将需要使用 Sun Java™ System Portal Server 配置器对 Portal Server 安装进行配置。以下清单描述了最小安装后进行配置所需的值。根据所执行的安装类型，使用的值可能不同。

Portal Server 及 Secure Remote Access

表 2-1 包含三列，其中列出了最小安装后进行配置可能需要的所有值。根据所执行的安装类型，使用的值可能不同。

表 2-1 是一个清单示例，它假定执行的是 Sun Java System Application Server 部署。如果是在 Sun Java System Web Server、BEA WebLogic 或 IBM WebSphere Application Server 上部署，参见 Web 容器清单，部分以了解相应的 Web 容器值。

表 2-1  Portal Server 安装清单 

参数

默认值

描述

安装目录

Sun Java System 配置器组件的安装目录

/opt

这是安装 Portal Server 软件的基目录。

部署信息

部署类型

Sun Java System Web Server

可以将 Portal Server 部署在 Sun Java System Web Server、Sun Java System Application Server、BEA WebLogic Server 或 IBM WebSphere Application Server 上。

部署 URI

/portal

URI 是 Portal Server 使用的 Web 服务器或应用程序服务器上的空间。

部署 URI 的值必须有且仅有一条前导斜线。但部署 URI 不能仅为”/”自身。

控制 Portal Server 实例的负载平衡器

未选中

如果要在 Portal Server 中配合使用负载平衡器，请选中此框。

负载平衡器 URL

http://fully_qualified_domain:port/portal

 

Web 容器信息 (Sun Java System Application Server)

安装目录

/opt/SUNWappserver7

安装 Sun Java System Application Server 的目录。

域

/var/opt/SUNWappserver7/
domains/domain1

Sun Java System Application Server 域包含一组实例。指定的域将包含由 Portal Server 使用的实例。必须已配置好此域。

实例

server1

将要部署 Portal Server 的 Sun Java System Application Server 实例的名称。此实例必须已被配置。

实例名称不能含有空格。

实例端口

80

将在其上运行 Sun Java System Application Server 实例的端口。

文档根目录

/var/opt/
SUNWappserver7/
domains/domain1/
server1/docroot

保存静态页的目录。

管理员

admin

管理员用户 ID。

管理端口

4848

管理服务器的端口号。

管理口令

 

管理服务器口令。

Identity Server 信息

安装基目录

/opt

这是安装 Sun Java System Identity Server 软件的基目录。

内部 LDAP 验证用户口令

 

在 Sun Java System Identity Server 安装期间选择的”内部 LDAP 验证用户口令”。

管理员 (amadmin) 口令

 

在 Sun Java System Identity Server 软件安装期间选择的顶级管理员 (amadmin) 口令。

目录管理器 DN

cn=Directory Manager

LDAP 目录管理器识别名 (DN)。

目录管理器口令

 

在安装 Sun Java System Directory Server 期间选择的目录管理器口令。

安全远程访问信息（用于配置安全远程访问支持）

网关协议

https

网关使用的协议。网关将使用”安全套接字层”(SSL) 进行通信。

Portal Server 域

portal-server-domain-name

安装 Portal Server 的机器的域名。

网关域

gateway-domain-name

网关计算机的域名。

网关端口

443

网关侦听的端口。

网关配置文件名

default

网关配置文件含有与网关配置相关的所有信息，诸如网关侦听所在端口、SSL 选项及代理选项。

可在网关管理控制台中创建多个配置文件，并将不同的网关实例与不同的配置文件相关联。

参见《Sun Java System Portal Server, Secure Remote Access 6 2004Q2 管理指南》中的“创建网关配置文件”。

网关登录用户口令

 

允许非根访问管理员查看网关日志文件。

确认口令

 

再次键入以验证口令。

网关

表 2-2  网关安装清单 

参数

默认值

描述

协议         

https

网关使用的协议。网关通常使用“安全套接字层”(SSL) 进行通信。

主机名

host

安装网关的机器的主机名。

子域

gateway-subdomain-name

网关计算机的子域名。

域

gateway-domain-name

网关计算机的域名。

IP 地址

host-ip-address

IP 地址应为网关安装机的 IP 地址，而不是 Sun Java System Identity Server 的 IP 地址。

访问端口

443

网关计算机侦听的端口。

网关配置文件名

default

指定一个相同的配置文件名，即在安装 Portal Server 或“安全远程访问”支持时所使用的配置文件名。

有关详细信息，参见《Sun java System Portal Server, Secure Remote Access 6 2004Q2 管理指南》中的“创建网关配置文件”

网关登录用户口令

 

允许非根访问管理员查看网关日志文件。

安装后启动网关

已选中

自动启动网关（如果选中此选项）或以后手动启动它。

要手动启动网关，请使用位于 portal-server-install-root/SUNWps/bin 中的以下命令：

./gateway -n gateway-profile-name start

证书信息

组织

MyOrganization

您所在组织名。

部门

MyDivision

您所在部门名。

城市或地区

MyCity

您所在城市或地区名

州或省

MyState

您所在州名

两字母国家代码

us

您所在国家的两字母国家代码。

证书数据库口令

 

您可以选择任意口令。

再次键入口令

 

再次键入口令进行验证。

Netlet 代理

表 2-3  Netlet 代理安装清单 

参数

默认值

描述

主机名

hostname

安装“Netlet 代理”的机器的主机名。

子域

localhost-subdomain-name

安装“Netlet 代理”的机器的子域名。

域

localhost- domain-name

安装“Netlet 代理”的机器的域名。

IP 地址

host-ip-address

IP 地址应为“Netlet 代理”安装机的 IP 地址，而不是 Sun Java System Identity Server 的 IP 地址。

访问端口

10555

“Netlet 代理”侦听的端口。

网关配置文件名

default

指定一个相同的配置文件名，即在安装 Portal Server 或“安全远程访问”支持时所使用的配置文件名。

有关详细信息，参见《Sun java System Portal Server, Secure Remote Access 6 2004Q2 管理指南》中的“创建网关配置文件”。

网关登录用户口令

 

允许非根访问管理员查看网关日志文件。

安装后启动“Netlet 代理”

已选中

自动启动“Netlet 代理”（如果选中此选项）或以后手动启动它。要手动启动“Netlet 代理”，请使用以下命令，该命令位于 netlet-proxy-install-root/SUNWps/bin

./netletd -n default start

证书信息

组织

MyOrganization

您所在组织名。

部门

MyDivision

您所在部门名。

城市或地区

MyCity

您所在城市或地区名。

州或省

MyState

您所在州或省名。

两字母国家代码

us

您所在国家的两字母国家代码。

证书数据库口令

 

您可以选择任意口令。

再次键入口令

 

再次键入口令进行验证。

重写器代理

表 2-4  重写器代理安装清单 

参数

默认值

描述

主机名

hostname

“重写器代理”安装机的主机名。

子域

localhost-subdomain-name

“重写器代理”安装机的子域名。

域

localhost- domain-name

“重写器代理”安装机的域名。

IP 地址

host-ip-address

IP 地址应为“重写器代理”安装机的 IP 地址，而不是 Sun Java System Identity Server 的 IP 地址。

访问端口

10443

“重写器代理”侦听的端口。

网关配置文件名

default

指定一个相同的配置文件名，即在安装 Portal Server 或“安全远程访问”支持时所使用的配置文件名。

有关详细信息，参见《Sun java System Portal Server, Secure Remote Access 6 2004Q2 管理指南》中的“创建网关配置文件”。

网关登录用户口令

 

允许非根访问管理员查看网关日志文件。

安装后启动“重写器代理”

已选中

自动启动“重写器代理”（如果选中此选项）或以后手动启动它。

要手动启动“重写器代理”，请使用以下命令，该命令位于 rewriter-proxy--install-root/SUNWps/bin

./rwproxyd -n default start

证书信息

组织

MyOrganization

您所在组织名。

部门

MyDivision

您所在部门名。

城市或地区

MyCity

您所在城市或地区名。

州或省

MyState

您所在州或省名。

两字母国家代码

us

您所在国家的两字母国家代码。

证书数据库口令

 

您可以选择任意口令。

确认口令

 

再次键入口令进行验证。

表 2-5  Netlet 和重写器代理信息

参数

默认值

描述

使用此节点上的 Portal Server

已选中

如果 Portal Server 和 Sun Java System Secure Remote Access 组件将要安装在单独的机器上，请取消选中此框。

如果 Portal Server 和 Sun Java System Secure Remote Access 组件安装在同一台机器上，则选中此框。

选中此框时，以下字段将被启用。

Portal Server 协议

http

Portal Server 用来进行通信的协议。

Portal Server 主机

fully-qualified-host-name

Portal Server 的全限定主机名。

Portal Server 端口

80

 

Portal Server 部署 URI

/portal

 

组织 DN

 

 

Identity Server 服务 URI

/amserver

 

Identity Server 口令加密密钥

 

加密密钥的值。加密密钥位于：

/etc/opt/SUNWam/config
AMConfig.properties（作为参数 am.encryption.pwd）。

Web 容器清单

Portal Server 安装需要使用一些 Web 容器参数。以下清单描述 Portal Server 安装过程中所需的参数。请查看正在其上部署 Portal Server 产品的 Web 容器清单。

Sun Java System Web Server 清单

表 2-6  Portal Server 安装期间使用的 Sun Java System Web Server 值

参数

默认值

描述

安装目录

/opt/SUNWwbsvr

安装 Sun Java System Web Server 的基目录。

实例

host

希望 Portal Server 使用的 Web 服务器实例。

实例名称不能含有空格。

实例端口

80

用于访问 Portal Server 的端口。

安全 Web 容器实例端口

未选中

如果 SSL 将在该实例端口上运行，请选中此框。

文档根目录

/opt/SUNWwbsvr/docs

保存静态页的目录。

Sun Java System Application Server 清单

表 2-7  Portal Server 安装期间使用的 Sun Java System Application Server 值 

参数

默认值

描述

安装目录

/opt/SUNWappserver7

安装 Sun Java System Application Server 的目录。

域

/var/opt/SUNWappserver7/
domains/domain1

Sun Java System Application Server 域包含一组实例。指定的域将包含由 Portal Server 使用的实例。必须已配置好此域。

实例

server1

将要部署 Portal Server 的 Sun Java System Application Server 实例的名称。此实例必须已被配置。

实例名称不能含有空格。

实例端口

80

用来访问 Portal Server 的端口。

安全 Web 容器实例端口

未选中

如果 SSL 将在该实例端口上运行，请选中此框。

文档根目录

/var/opt/SUNWappserver7/
domains/domain1/server1/
docroot

保存静态页的目录。

管理员

admin

管理员用户 ID。

管理端口

4848

管理服务器的端口号。

管理口令

 

管理服务器口令。

BEA WebLogic Server 清单

表 2-8  Portal Server 安装期间使用的 BEA WebLogic Server 值 

参数

默认值

描述

BEA 起始目录           

/user/local/bea

安装 BEA 的目录。

产品安装目录

/usr/local/bea/weblogic81

安装 BEA WebLogic Server 软件的目录。

用户项目的目录

user_projects

使用在 BEA WebLogic 安装期间输入的值。

域

mydomain

BEA WebLogic Server 域包含一组实例。指定的域将包含由 Portal Server 使用的实例。必须已配置好此域。

实例

myserver

将要部署 Portal Server 的 BEA WebLogic Server 实例的名称。此实例必须已被配置。

名称不能含有空格。

如果您正在管理服务器实例上安装 Portal Server，则应为管理服务器实例的名称。否则它就将是管理的服务器实例的名称。

实例端口

7001

用于访问 Portal Server 的端口

安全实例端口

未选中

如果 SSL 将在该实例端口上运行，请选中此框。

文档根目录

/usr/local/bea/user_projects/
domains/mydomain/applications

需要将文档根值 DefaultWebApp 部署到正在其上运行 Portal Server 软件的 BEA WebLogic Server 实例上。DefaultWebApp 是默认 Web 应用程序，静态内容服务于 BEA WebLogic Server 中的 DefaultWebApp 上。默认情况下，仅将 DefaultWebApp 部署到域 (mydomain) 及在 BEA WebLogic Server 安装期间定义或创建的服务器实例。这表明，如果您创建自己的 BEA WebLogic Server 或域，则需要通过将该目录复制到新服务器的部署目录，或通过使用 BEA WebLogic Server 管理控制台，将 DefaultWebApp 部署到 BEA WebLogic Server 或域。有关如何配置默认 Web 应用程序的详细信息，参见 BEA WebLogic Server 文档。

管理员

system

管理员的用户 ID。

管理协议

http

BEA WebLogic Server 管理服务器的运行协议。

管理端口

7001

运行 BEA WebLogic Server 管理服务器的端口。如果将 Portal Server 安装在 BEA WebLogic Server 管理服务器本身上，那么 Portal Server 的运行端口与 BEA WebLogic Server 的管理端口为同一端口。

管理口令

 

系统口令。

IBM WebSphere Application Server 清单

表 2-9  Portal Server 安装期间使用的 IBM WebSphere Application Server 值

参数

默认值

描述

安装目录     

/opt/WebSphere/Express51/AppServer

安装 IBM WebSphere Application Server 软件的目录。

虚拟主机

default_host

使用在 IBM WebSphere 安装期间输入的值。

节点

machine-name

 

实例

server1

将要部署 Portal Server 的实例名称。此实例必须已被配置。

无法将 Portal Server 安装至名称中含有短划线或空格的应用程序服务器实例或域中（例如，“Default-Server”或“Default Server”）。

文档根目录

/opt/IBMHTTPD/htdocs/
en_US

保存静态页的目录。在 Sun Java System Identity Server 安装期间创建此目录。

Portal Server 安装之后的任务

下列每一组件都需要执行安装之后的任务：

Portal Server

要访问 Portal Server 或 Identity Server 管理控制台，必须首先启动 Directory Server 和 Web 容器。

使用以下命令启动本地安装的 Directory Server：

/var/opt/mps/serverroot/slapd-hostname/start-slapd

下列安装之后的任务取决于在其上部署 Portal Server 的 Web 容器的类型。

Sun Java System Web Server

启动 Sun Java System Web Server：

  1. 启动管理实例。在终端窗口中键入：

    2. cd web-server-install-root/SUNWwbsrv

    ./start

  2. 访问 Sun Java System Web Server 管理控制台。
  3. 单击“应用更改”重新启动 Web 容器。

Sun Java System Application Server

配置应用程序服务器实例
  1. 启动管理实例。在终端窗口中键入：

    2. cd /var/opt/SUNWAppserver7/domains/domain1/admin-server/bin

    ./start

  2. 在浏览器中，转到 Sun Java System Application Server 管理控制台。默认的 URL 为

    3. http://hostname:4848

  3. 在左边的导航框架中，单击“应用程序服务器实例”左侧的键。
  4. 选择 server1，或选择在其上安装了 Sun Java System Identity Server 的应用程序服务器实例的名称。
  5. 单击“应用更改”。
停止和启动 Sun Java System Application Server

启动 Sun Java System Application Server 实例。

在终端窗口中，将目录转到应用程序服务器的实例实用程序目录，然后运行 startserv 脚本。以下示例假定使用了默认的应用程序服务器域和实例。

cd /var/opt/SUNWappserver7/domains/domain1/server1/bin

./startserv

要使用 asadmin 实用程序或通过 Sun Java System Application Server 管理控制台来停止和启动 Sun Java System Application Server，参见 Sun Java System Application Server 文档。

BEA WebLogic Server

在 BEA WebLogic Server 上部署 Portal Server 时，请在安装完 Portal Server 软件后执行下列步骤。

  1. 检查
    /var/sadm/install/logs/Java_Enterprise_System_install.B/MMddhhmm 文件是否有错误。

    2. MM = 月份

    dd = 日期

    hh = 小时

    mm = 分钟

  2. 停止所有 BEA WebLogic Server 实例（管理及受管服务器）。
  3. 启动 BEA WebLogic 管理服务器实例。（如果是在某个受管实例上进行的安装，还要启动该受管实例。）
  4. 在命令行中执行以下命令：

    5. portal-server-install-root/SUNWps/bin/deploy

    为部署 URI 和服务器实例名称选择默认值，然后在出现屏幕提示时输入 BEA WebLogic Server 管理员口令。

  5. 执行以下命令：
    1. setenv DEPLOY_ADMIN_PASSWORD BEA-WebLogic-admin-password
    2. setenv IDSAME_ADMIN_PASSWORD Identity-Server-admin-password
    3. portal-server-install-root/SUNWps/lib/postinstall_PortletSamples

      4. 出现屏幕提示时，输入 BEA WebLogic Server 管理员口令和 Identity Server 管理员口令。

      这将部署 portletsamples.war 文件。

  6. 重新启动在其中部署了 Portal Server 的 BEA WebLogic Server 实例。有关启动 Web 容器实例的说明，参见您的 Web 容器文档。

    7. 注

    在安装了受管服务器的情况下，.war 文件不会被部署。应使用 BEA WebLogic Server 管理控制台部署 .war 文件。

如果想支持多种验证方法，如 LDAP、UNIX 或“匿名验证”，必须将每种验证类型添加到“核心”验证服务中，以便创建一个验证菜单。有关进一步信息，参见《Sun Java System Portal Server 6 2004Q2 管理指南》。

IBM WebSphere Application Server

  1. 检查 /var/sadm/install/logs/Java_Enterprise_System_install.B/MMddhhmm 文件是否有错误。
  2. 停止并重新启动应用程序服务器实例和应用程序服务器节点。有关启动 Web 容器实例的说明，参见您的 Web 容器文档。

Secure Remote Access

使用带有网关的 Portal Server 时，无论 Portal Server 是在 HTTP 模式下运行还是在 HTTPs 模式下运行，都必须将网关“证书授权机构”(CA) 证书添加到 Portal Server 的信任 CA 列表中。

当用户会话超时或发生用户会话注销操作时，Sun Java System Identity Server 会向网关发送一条会话通知。即使 Sun Java System Identity Server 是在 HTTP 模式下运行，它也会作为 SSL 客户机使用 HttpsURLConnection 来发送通知。由于它会连接到 SSL 服务器（网关），所以其“信任 CA”列表中应当包括网关 CA 证书，或者它应当有一个选项来允许使用自签名证书。

注

将 CA 添加到信任 CA 列表中的方法取决于所定义的协议处理程序。

要创建 HttpsURLConnection，需要设置“Java 虚拟机”(JVM™) 属性 -Djava.protocol.handler.pkgs。

如果 Portal Server 在 Sun Java System Web Server、Sun Java System Application Server 或 BEA WebLogic Server 上运行，默认情况下，此属性会被正确设置为 com.iplanet.services.comm。Sun Java System Identity Server 软件包中包括有 HttpsURLConnection 的实现，并且它还提供了一个选项以接受来自任何 SSL 服务器的自签名证书，这是通过在 AMConfig.properties 文件中添加 com.iplanet.am.jssproxy.trustAllServerCerts=true 标志来完成的。

对于 IBM WebSphere Application Server，在默认情况下，不会设置 -Djava.protocol.handler.pkgs。与所支持的应用程序服务器相应的 HttpsURLConnection 实现必须使用它们自身的默认处理程序（该实现可以是 JSSE 或自定义 SSL 实现）。

网关

  1. 使用以下命令启动网关：

    2. gateway-install-root/SUNWps/bin/gateway -n new-profile-name start

    default 为安装期间所创建的网关配置文件的默认名称。可在以后创建自己的配置文件，然后用新的配置文件重新启动网关。参见《Sun Java System Portal Server, Secure Remote Access 6 2004Q2 管理指南》第 2 章中的“创建网关配置文件”。

    如果有多个网关实例，请使用：

    gateway-install-root/SUNWps/bin/gateway start

    注

    如果在网关安装期间为“安装后启动网关”选项选择了 y，则不必执行这一步骤。

    警告

    请确保 /etc/opt/SUNWps 目录中只包含要启动实例的配置文件。

如果想要停止在特定节点上运行的所有网关实例，请使用以下命令：

gateway-install-root/SUNWps/bin/gateway stop

Netlet 和网关需要 Rhino JavaScript™ 分析器（它被打包成 SUNWrhino）来支持 PAC 文件。该分析器必须安装在“网关”和 Portal Server 节点中。安装时请采用以下步骤：

  1. 在当前目录中运行 pkgadd -d . SUNWrhino，添加此软件包。
  2. 将 package-base-dir/js.jar 复制到 ${JAVA_HOME}/jre/lib/ext 目录。

Netlet 和重写器代理

在启动“Netlet 代理”和“重写器代理”之前，请确保网关配置文件已用“Netlet 代理”和“重写器代理”选项进行了更新。

Sun Java System Portal Server 软件 NetFile 需要 jCIFS 库（这些库被打包成 SUNWjcifs）来进行 Windows 访问。只需在 Portal Server 节点中安装该软件包。安装时请采用以下步骤。

  1. 在当前（本）目录中运行 pkgadd -d .SUNWjcifs，添加此软件包。
  2. 运行 portal-server-install-root/SUNWps/lib/postinstall_JCIFS
  3. 运行 portal-server-install-root/SUNWps/bin/undeploy
  4. 运行 portal-server-install-root/SUNWps/bin/deploy 命令。
  5. 重新启动服务器。

验证 Portal Server 安装

访问 Portal Server 管理控制台和桌面

访问 Sun Java System Identity Server 管理控制台

  1. 打开一个浏览器。
  2. 键入 protocol://hostname.domain:port/amconsole

    3. 例如，

    http://example.com:80/amconsole

  3. 输入管理员名称及口令以查看管理控制台。

    4. 它们是您在安装 Sun Java System Identity Server 软件时指定的名称和口令。

访问 Portal Server 桌面

可通过访问桌面来验证 Portal Server 安装。请使用以下 URL 来访问桌面：

protocol://fully-qualified-hostname:port/portal-URI

例如，

http://example.com:80/portal

访问桌面时，会显示“Authless 桌面”。该桌面允许用户访问将会自动验证并授予桌面访问权的“桌面 URL”。

如果示例“门户桌面”显示时未出现任何异常，则表明您已正确安装了 Portal Server。

验证网关安装

  1. 运行以下命令，检查网关是否在指定的端口上运行：

    2. netstat -an | grep port-number

    其中，默认网关端口为 443。

    如果网关未在运行，请在调试模式下启动网关，查看控制台中输出的消息。请使用以下命令在调试模式下启动网关：

    portal-server-install-root/SUNWps/bin/gateway -n profilename start debug

    另外，在将 platform.conf.profilename 文件中的 gateway.debug 属性设置为 message 后，查看日志文件。有关详细信息，参见《Sun Java System Portal Server, Secure Remote Access 6 2004Q2 管理指南》第 2 章“管理网关”中的“了解 platform.conf 文件”部分。

  2. 在安全模式下运行 Portal Server，方法是在浏览器中键入以下网关 URL：

    3. https://gateway-machine-name:portnumber

    如果在安装期间选择了默认端口 (443)，则不需要指定端口号。

  3. 使用用户名 amadmin 以及安装时指定的口令，以管理员身份登录到 Identity Server 管理控制台。

现在便可以在管理控制台中创建新的组织、角色和用户并分配所需的服务和属性了。



上一页      目录      索引      下一页     

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