目 录

PRIMETON TECHNOLOGIES, LTD. 普元信息技术股份有限公司 Portal 安装指南

目录 1 概述... 3 1.1 本文目标...3 1.2 非本文目标...3 1.3 目标读者基本要求...3 1.4 术语表...3 1.4.1 Widget...3 1.4.2 Portlet 容器...4 1.4.3 跨域...4 2 介质说明... 4 2.1 标准 Portal 部署包 (portal_war.zip)...4 3 标准 Portal 安装指南... 5 3.1 安装 Portal 的前提...5 3.1.1 安装 SSO Server...5 3.1.2 准备好数据库...5 3.1.3 准备好应用服务器...5 3.2 安装 Portal 服务器...5 3.2.1 使用介质...5 3.2.2 安装步骤...5 3.2.3 配置全文检索... 10 4 常见故障排除... 10 4.1 常规故障定位步骤... 10 4.2 登录后提示为非法用户或初始化失败... 11 4.3 在 Was 下修改配置文件不生效... 12 4.4 在 Was 下 Portal 页面出现乱码... 13 第 2 页共 13 页

1 概述 1.1 本文目标 本文详细描述了普元 Portal 的安装过程, 希望为 PS 和合作伙伴基于普元 Portal 进行多应用 集成实施提供参考 1.2 非本文目标 本文不包含单点登录集成相关的内容, 如 :SSO Server 的安装部署 SSO Client 的安装部署等 与单点登录 (SSO) 相关的内容请参考 SSO 安装指南 和 SSO 集成指南 文档 本文不包含内容集成相关的内容, 与内容集成相关的内容请参考 Portal 集成指南 文档 本文不包含组织机构权限框架的相关内容, 与组织机构权限框架相关的内容请参考普元开源框架 coframe 的相关介绍 1.3 目标读者基本要求 如果您已经具备了以下技能, 将会有利于顺利完成 Portal 服务器的安装 : 了解单点登录服务器配置和集成方式 ( 可通过 SSO 安装指南 和 SSO 集成指南 进行了解 ) 了解 tomcat jboss weblogic websphere 应用服务器的基本概念, 如 : 如何安装 启动 停止, 如何查看应用服务器的 IP 地址 / 域名 端口号等 掌握如何在应用服务器上部署标准 war 包, 如何查找已部署的应用, 如何修改应用名 掌握基本的数据库操作, 如 : 连接数据库 执行脚本等 了解所使用的操作系统的基本操作, 如文件拷贝 编辑等如果您尚不了解以上相关技能, 建议您通过网络进行搜索学习 1.4 术语表 1.4.1 Widget Widget 是一种能够提供特定服务或信息 ( 例如 : 提供日历 天气预报 公司新闻 管理驾驶舱 产品信息等 ) 的 Web 页面小构件, 通过 Widget 调用, 消费者可使用 Widget 提供的服务并获取所需的信息 第 3 页共 13 页

1.4.2 Portlet 容器 普元 Portal 通过可扩展的 Widget 容器来加载不同类型的 Widget Widget 容器负责处理 Widget 请求 加载并生成动态内容 普元 Portal 提供了常用的 Widget 容器并支持扩展 Widget 容器, 支持加载常用的 url 链接的 web 页面 flash 插件 ( 放在 web 页面中 ) 以及符合 JSR168 标准的 Portlet 等 其中,Portlet 容器就是支持加载符合 JSR168 标准的 Portlet 的 Widget 容器 如果希望将已有的 Portlet 集成到普元 Portal 中, 就需要安装 Portlet 容器 1.4.3 跨域 当两个域具有相同的协议 ( 如 http), 相同的端口 ( 如 80), 相同的 host( 如 ), 那么我们就可以认为它们是相同的域 比如 http:///index.jsp 和 http:///erp/index.jsp 是同域, 而 http://, https://, http://:8080 中的任何两个都将构成跨域 2 介质说明 Portal 提供 portal_war.zip, 下面对介质进行说明 : 2.1 标准 Portal 部署包 (portal_war.zip) 当需要独立部署不带 ECM( 内容管理 ) 组件的 Portal 服务器时, 使用本介质进行安装 目录 说明 jar_system tomcat jboss weblogic websphere sql src 部署 Portlet 容器需要的 jar 包在 tomcat 应用服务器下部署 portal 服务器时的 war 包在 jboss 应用服务器下部署 portal 服务器时的 war 包在 weblogic 应用服务器下部署 portal 服务器时的 war 包在 websphere 应用服务器下部署 portal 服务器时的 war 包搭建 Portal 服务器所需要的数据库初始化脚本, 按不同数据库类型分别存放 Portal 框架开源项目源码包 第 4 页共 13 页

3 标准 Portal 安装指南 3.1 安装 Portal 的前提 安装 Portal 之前, 需要做好以下准备工作 : 3.1.1 安装 SSO Server Portal 作为多应用集成的企业门户, 必须具备单点登录功能 因此, 在安装 Portal 之前, 必须先安装好单点登录服务器 (SSO Server) 单点登录服务器可以与 Portal 安装在同一个应用服务器下, 也可以单独安装 关于如何安装 SSO Server 请参考 SSO 安装指南 文档 对于 BPS Platform 7 的用户, 在安装 BPS Platform 7 时可以通过选择安装 SSO 组件的方式来安装 SSO Server 3.1.2 准备好数据库 准备好数据库作为 Portal 系统数据库 3.1.3 准备好应用服务器 需要准备好应用服务器作为安装 Portal 的服务器, 并保证该应用服务器能够与准备的 Portal 系统数据库正常连接 3.2 安装 Portal 服务器 3.2.1 使用介质 使用 portal_war.zip 3.2.2 安装步骤 步骤 1: 部署 portal 的 war 包 解压 portal_war.zip, 从解压后对应的应用服务器目录下获取 portal.war, 如 : 需要安装在 tomcat 服务器下, 则从解压后的 tomcat 目录下获取 portal.war 按照应用服务器下标准 war 包的部署方式, 将 portal.war 部署到应用服务器下 如 : 对于 tomcat 服务器, 将 portal.war 解压后, 将整个 portal 目录拷贝到 tomcat 服务器的 webapps 目录下 第 5 页共 13 页

说明 : 当部署 portal.war 时, 为了方便初始化过程, 建议使用 portal 这个应用名 当然, 您也可以根据需要更改部署后的应用名, 一旦更改了应用名, 请注意在后续安装过程中, 需要使用您更改后的应用名 步骤 2: 修改 web.xml 确定 Portal 服务器和 SSO 服务器 IP 地址和应用端口号, 例如 :Portal 服务器部署后的应用名为 portal,ip 地址为 :192.168.0.123, 端口 8080;sso 服务器部署后的应用名为 sso-server,ip 地址为 :192.168.0.110, 端口 8081 打开部署后 Portal 应用的 \WEB-INF 下的 web.xml 文件, 按照 Portal 服务器和 SSO 服务器对应的地址 端口号和应用名, 修改其中与 SSO 相关的配置 本例中, web.xml 修改后的内容如下 ( 黄色背景内容 ): <context-param> <param-name>cas-url</param-name> <param-value>http://192.168.0.110:8081/sso-server</param-value> </context-param> 配置为 SSO Server 对应的 IP 地 <filter> 址 端口号和应用名 <filter-name>sso Filter</filter-name> <filter-class>edu.yale.its.tp.cas.client.filter.casfilter</filter-class> <init-param> <param-name>edu.yale.its.tp.cas.client.filter.loginurl</param-name> <param-value>http://192.168.0.123:8080/portal/sso.login</param-value> </init-param> 配置为 Portal 对应的 IP 地址 端 <init-param> 口号和应用名 <param-name>edu.yale.its.tp.cas.client.filter.validateurl</param-name> <param-value>http://192.168.0.110:8081/sso-server/servicevalidate</param-value> </init-param> 配置为 SSO Server 对应的 IP 地 <init-param> 址 端口号和应用名 <param-name>edu.yale.its.tp.cas.client.filter.servername</param-name> <param-value>192.168.0.123:8080</param-value> </init-param> 配置为 Portal 对应的 IP 地址和端口号 <init-param> <param-name>edu.yale.its.tp.cas.client.filter.initcontextclass</param-name> ue> <param-value>com.primeton.cap.portal.runtime.integration.portalcontextinit</param-val </init-param> <init-param> <param-name>edu.yale.its.tp.cas.client.filter.filterexclusion</param-name> 第 6 页共 13 页

<param-value>/portal/login/login.jsp</param-value> </init-param> 配置为 Portal 对应的应用名 </filter> <filter-mapping> <filter-name>sso Filter</filter-name> <url-pattern>*.jsp</url-pattern> </filter-mapping> <filter-mapping> <filter-name>sso Filter</filter-name> <url-pattern>*.flow</url-pattern> </filter-mapping> 说明 : 在 WAS 服务器上修改 web.xml 可能出现不生效的情况 需要同时手工修改 <WAS_INSTALL_ROOT>/profiles/<PROFILE_NAME>/config/cells/<CELL_N AME>/applications/XXX.ear/deployments/XXXX/YYYY.war/WEB-INF/ 下面的 xml 才能保证修改生效 步骤 3: 部署 Portlet 容器需要的 jar 将解压后 jar_system 目录下所有的 jar 包部署到应用服务器的公共 lib 下, 保证在服务器启动时能够加载这些 jar 即可 如 : 对于 tomcat 服务器, 可将这些 jar 文件拷贝至 tomcat 服务器的 common/lib 目录下 对于 jboss 服务器, 需要拷贝到 jboss 服务器的 /server/default/lib 目录下 步骤 4: 配置 portal 应用对应的数据源 如果已经安装了 BPS Platform 产品, 并在安装过程中配置了数据源, 并且 Portal 数据库就对应到该数据源上, 则可使用 Portal 默认的数据源配置, 忽略本步骤 Portal 默认的数据源配置如下 : <module name="datasource"> <!--system default datasouce --> <group name="default"> <configvalue key="jndi-name">defaultdatasource</configvalue> <configvalue key="transaction-isolation">isolation_read_committed</configvalue> <configvalue key="test-connect-sql">select count(*) from EOS_UNIQUE_TABLE</configValue> <configvalue key="retry-connect-count">-1</configvalue> </group> </module> 第 7 页共 13 页

说明 : Portal 默认的数据源配置指向应用服务器已配置的数据源, 数据源名称为指定的 DefaultDataSource, 只有在应用服务器配置了同名的数据源的情况下, 使用默认配置才有效, 否则, 需要手工配置数据源 ( 注 : 安装 BPS Platform 的过程中配置数据源即是为应用服务器配置了名为 DefaultDataSource 的数据源 ) 对于 tomcat 服务器, 可通过修改 /conf/server.xml 中的数据源配置来配置 Portal 默认的数据源 如果希望为 Portal 服务器配置指定的数据源, 可参考以下步骤 : 打开 Portal 应用下 /WEB-INF/_srv/config/user-config.xml 文件, 根据 Portal 数据库对应的数据源修改 DataSource 相关配置 以 mysql 链接地址为 192.168.2.88 为例, 数据库别名 portal,portal 数据源配置示例如下 : <module name="datasource"> <group name="default"> <configvalue key="database-type">mysql</configvalue> <configvalue key="jdbc-type"/> <configvalue key="c3p0-driverclass">com.mysql.jdbc.driver</configvalue> <configvalue key="c3p0-url">jdbc:mysql://192.168.2.88:3306/portal</configvalue> <configvalue key="c3p0-username">root</configvalue> 连接数据库的用 <configvalue key="c3p0-password">000000</configvalue> 户名和密码 <configvalue key="c3p0-poolsize">5</configvalue> <configvalue key="c3p0-maxpoolsize">5</configvalue> <configvalue key="c3p0-minpoolsize">5</configvalue> <configvalue key="transaction-isolation">isolation_default</configvalue> <configvalue key="test-connect-sql">select count(*) from PORTAL_APP</configValue> <configvalue key="retry-connect-count">-1</configvalue> </group> </module> 步骤 5: 初始化 portal 数据库 根据准备的数据库类型, 选择解压后对应目录下的数据库初始化脚本, 如 : 数据库为 mysql, 则需要选择解压后 sql\mysql 目录下的脚本文件 注意 :portal-init-data.sql 脚本中初始化 PORTAL_APP 表的脚本需要根据 portal 服务器的 IP 地址 端口号和应用名进行调整, 如黄色背景内容 : DELETE FROM PORTAL_APP; INSERT INTO PORTAL_APP(APP_ID,TENANT_ID,APP_CODE,APP_NAME,HOST_URL,IS_SYSTEM_M ENU,MENU_NAME,OPEN_MODE,MENU_ACTION,ICON,SORT,LOGIN_TYPE,CREATE_U SER,CREATE_TIME,NEED_CHECK) 第 8 页共 13 页

VALUES ('portal', 'default', 'portal', 'portal', 'http://192.168.0.123:8080', '1', 'portal 应用 ', '0', '/com.primeton.cap.portal.runtime.uiservice.menuruntimemgr.getmenudata.biz.ext', NULL, '1', '0', NULL, NULL, '0'); 修改后, 依次执行 coframe.sql coframe_init_data.sql portal-table.sql 和修改后的 portal-init-data.sql 初始化 Portal 数据库 说明 : 如果 Portal 数据库中尚未初始化 BPS 的系统表, 请先通过 BPS Governor 初始 化 BPS 的系统表 步骤 6: 申请 License portal 的 war 包中提供了临时 License, 限制 5 个并发数 如果希望使用正式 License, 则可向普元售后部门提出申请 步骤 7: 访问 Portal 主页 启动 SSO Server, 启动 Portal 应用, 在浏览器地址栏输入 :http://{portal 应用 host}/{portal 应用名 }/, 如 :http://192.168.0.123:8080/portal/, 出现如下登录页面 : 输入用户名 ( 初始化的用户名为 sysadmin) 和密码 ( 初始化的密码为 000000) 后, 登录到 Portal 主页 : 第 9 页共 13 页

至此,Portal 服务器安装成功 3.2.3 配置全文检索 因为标准 Portal 没有集成 ECM( 内容管理 ) 功能, 默认的文档搜索功能无法正常使用 可通过修改 Portal 应用下 /skins/default/config/searchs.js 调整检索功能 var searchs={ ' 文档 ':{ url:'http://127.0.0.1:8080/ecmclient/docsearch/search/search4portal.jsp', // 绝对路径代表当前应用的 url, 必须以 / 开头 ; 也可配置为完整路径 parmname:'keywords' 配置为内容管理应用的检索或 }, 者删除 文档 配置内容 ' 百度 ':{ url:'http://www.baidu.com/baidu', parmname:'wd' } } 4 常见故障排除 本章节针对一些常见的故障提供了解决方案 4.1 常规故障定位步骤 说明 : 部署 Portal 环境后, 可能由于多种原因造成运行异常 在此列举常规的定位故障的 步骤, 供实施参考 步骤 1: 清除应用系统缓存再重启运行 第 10 页共 13 页

停止 sso server 和 portal server, 清除应用系统缓存之后, 再重启 sso server 和 portal server, 如果仍然运行异常, 参照以下步骤定位 步骤 2: 验证 sso 配置是否正常 启动 sso server 和 portal server, 在浏览器中输入 url : http://127.0.0.1:8080/sso-server/login( 注意 :url 中 IP 地址和 Port 为 sso server 所在的应用服务器的 IP 和 Port) 如果没有进入如下图所示的 cas 的登录页面, 则说明 sso 配置有问题 如果进入了 SSO 的登录页面, 输入用户名 sysadmin, 密码 000000, 点击 登录 按钮, 如果页面抛出异常, 则可能是 sso server 中的登录校验配置有误, 请按照 SSO 集成指南 文档检查 sso 配置 ( 在未修改过 sso server 默认配置时,sso server 用户验证规则为用户名和密码相同 ) 如果登录成功, 则说明 sso 配置正常 步骤 3: 验证是否能够正常进入 Portal 登录首页 启动 sso server 和 portal server, 在浏览器中输入 url:http://{portal server name+port}/{portal 所在应用名 }/ 如果没有出现 Portal 登录首页, 说明 portal server 配置有问题, 请按照指南文档检查 portal 配置, 尤其是 Portal 应用下 web.xml 的配置 步骤 4: 验证是否能够正常进入 Portal 主页 在 Portal 登录首页中输入用户名 sysadmin, 密码 000000, 点击 登录 按钮, 如果页面抛出异常, 说明 Portal 配置有问题, 请检查配置以及数据库初始化是否 正确之后再重启运行 4.2 登录后提示为非法用户或初始化失败 现象 在登录页面输入用户名和密码后登录, 页面提示为非法用户或初始化失败, 如下图所 示 : 第 11 页共 13 页

原因 1 登录的用户是 SSO 的合法用户, 但在 Portal 中没有对应的用户 解决方案 1 检查登录用户在 Portal 数据库的 PORTAL_USER 表中是否有对应的用户记录 原因 2 在执行 Portal 应用初始化过程中出现异常 解决方案 2 检查 Portal 应用下 user-config.xml 中数据源配置是否正确 检查 Portal 应用下 web.xml 中 edu.yale.its.tp.cas.client.filter.initcontextclass 配置的实现类是否正确, 如果可能跟踪初始化过程, 定位出错原因 如果使用了包含 ECM 的 Portal, 则需要确认 ECM Server 是否正常, 并且 Portal 应用下 user-config.xml 中 ECM Server 的配置是否正确 原因 3 应用服务器缺少 Portal 数据源对应数据库所需的 driver 如: 默认的 jboss 环境下不带 mysql driver 解决方案 3 将对应的数据库 driver 拷贝到应用服务器的公共 lib 下 4.3 在 Was 下修改配置文件不生效 现象在部署好的 was 环境下, 修改应用的 /WEB-INF 下的 xml 配置文件不生效 解决方案需要同时手工修改 <WAS_INSTALL_ROOT>/profiles/<PROFILE_NAME>/config/cells/<CELL_NAME >/applications/xxx.ear/deployments/xxxx/yyyy.war/web-inf/ 下面的 xml 才能保证修改生效 第 12 页共 13 页

4.4 在 Was 下 Portal 页面出现乱码 现象 Portal 部署在 was 环境下, 登录 Portal 主页后, 页面出现乱码, 如 : 导航的中文名称显示乱码, 系统菜单 功能菜单 快捷菜单标题乱码 原因 Portal 部署在 was 环境下, 登录 Portal 主页后, 页面出现乱码, 如 : 导航的中文名称显示乱码, 系统菜单 功能菜单 快捷菜单标题乱码 解决方案需要将 <WAS_INSTALL_ROOT>/AppServer/properties/ 目录下 encoding.properties 中的 zh=gb2312 改成 zh=utf-8, 重启 WAS 第 13 页共 13 页