TongWeb5.0 使用文档
第 1 章 TongWeb5.0 安装 1.1 TongWeb5.0 的安装说明 1.1.1 TongWeb5.0 支持的操作系统 Windows 平台 Linux 平台 RedHat 系列 RedFlag 系列 Suse Linux 系列 Unix 平台 Sun Microsystems Solaris 系列 IBM AIX 系列 1.1.2 TongWeb5.0 系统要求 系统组件 Java 环境内存硬盘空间监视器 系统要求 JDK1.5 及以上至少需要 256MB 的内存至少需要 256MB 磁盘空间图形界面安装需要 256 色, 字符界面安装没有色 彩要求 浏览器 Microsoft IE6 或 Firefox3.0 及以上版本浏览器 1.1.3 其它要求 (1). TongWeb5.0 需要在操作系统 hosts 文件中定义本机 IP 地址, 并以本机的 IP 优先 如
下所示 : 168.1.103.6 localhost 127.0.0.1 localhost (2). TongWeb5.0 安装完成后, 需设置使用的 JDK 路径, 设置本机的 JAVA_HOME 值 1.2 安装 TongWeb5.0 注 : 以在 Unix 下字符界面为例说明 TongWeb5.0 的安装过程 (1). 建立 TongWeb 用户账户或直接使用 root 用户安装 (2). 上传 TongWeb5.0 安装程序 Install_TW_Alpha_AIX.bin 至服务器, 并赋予可执行权限 (chmod +x Install_TW_Alpha_AIX.bin) (3). 执行命令./ Install_TW_Alpha_AIX.bin i console 开始安装 (4). 输入 Y, 确认接收本协议 "Intelligent Property Protection Regulation", "Copyright Law", "Exclusive Law" Now, you must have already carefully read and understand this license, and agreed to obey all the terms and conditions strictly. DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y (5). 输入 TongWeb 安装目录回车 Where would you like to install? Default Install Folder: /home/tongweb/tongweb5.0 ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : /home/tongweb/tongweb5.0 (6). 输入 Y, 确认安装目录 INSTALL FOLDER IS: /home/tongweb/tongweb5.0 IS THIS CORRECT? (Y/N): Y
(7). 选择 4, 不用建立连接 Where would you like to create links? ->1- Default: /home/tongweb 2- In your home folder 3- Choose another location... 4- Don't create links ENTER THE NUMBER OF AN OPTION ABOVE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : 4 (8). 回车执行安装过程, 进度条走完, 安装过程完毕 =============================================================== Installing...------------- [================== ================== ==================] [------------------ ----------------- (9). 将 TongWeb 的授权文件 license.dat 拷入 TongWeb 的根目录下 1.3 TongWeb5.0 的启动和停止 (1). 启动 TongWeb 需要进入 TongWeb 的 bin 目录, 执行如下命令 : nohup./startserver.sh & 注 : 这是后台启动方式, 如果直接运行 startserver.sh, 当 telnet 断开后导致 TongWeb 进程退出 同时 bin 目录会生成一个 nohup.out 日志文件 (2). 当日志中出现如下一行, 没有异常信息, 说明 TongWeb 启动成功 [INFO] [core] [TongWeb server startup complete.] (3). 在客户端打开 IE, 输入 TongWeb 控制台地址 : http://tongwebip:9060/twns, 显示出 TongWeb 控制台的首页面, 输入用户名 / 密码 ( 默认值 :twns/twns), 登陆控制台 (4). 停止 TongWeb, 需进入 TongWeb 的 bin 目录执行 stopserver.sh
第 2 章 liferay 在 TongWeb5.0 上部署 2.1 部署说明 本章以移植 liferay4.3.6 为例进行说明, 移植环境如下 : 软件名称软件版本 liferay 下载 liferay4.3.6 在 Tomcat5.5 下的应用. liferay-portal-tomcat-5.5-4.3.6.zip oracle Oracle10g, 导库脚本 liferay-portal-sql-oracle-10-4.3.6.dmp 2.2 整理 liferay 的应用包 (1). Tomcat 下的 webapps/root 目录为整个 liferay 的应用目录 (2). 将 Tomcat 的 common/lib/ext 下 portal-kernel.jar,portlet.jar, portal-service.jar,ext-service.jar 拷入应用的 lib 目录下 ( 即 ROOT/WEB-INF/lib 目录下 ) (3). 再找一个 xercesimpl.jar 和 mail.jar 放在应用的 lib 目录下,TongWeb5.0 不带此包 (4). 修改应用的 web.xml 文件 ( 即 ROOT/WEB-INF/web.xml) 将 web.xml 的头改为 JEE5 的, 否则不认 mapped-name 元素, 如下 : <web-app xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemalocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="webapp_id" version="2.5"> 将 web.xml 关于 JavaMail 的描述改为如下, 增加红色标记内容 <resource-ref> <description>test JavaMail</description> <res-ref-name>mail/mailsession</res-ref-name> <res-type>javax.mail.session</res-type> <res-auth>container</res-auth> <res-sharing-scope>shareable</res-sharing-scope> <mapped-name>mail/mailsession</mapped-name> </resource-ref>
(5). 将整个 ROOT 目录打成 war 包备用 2.3 导入 liferay 数据库 安装 Oracle 数据库, 建立账号和表空间, 执行如下命令导入数据库 imp tongtech/tongtech@orcl file=liferay-portal-sql-oracle-10-4.3.6.dmp full=y 2.4 针对 liferay 修改的 TongWeb5.0 配置 (1). 将 oracle 的 JDBC 驱动包 ojdbc14.jar 放入 TongWeb 的 lib 目录下 (2). liferay 有针对不同应用服务器的处理, 由于没有对 TongWeb 的处理, 所以在 TongWeb 的 lib 目录下已放置了 Tomcat 的类, 让 liferay 认为是 Tomcat 来处理 (3). 修改 bin 目录的 startserver.sh 脚本, 在 70 行左右加入如下参数 : JAVA_OPTS="${JAVA_OPTS} -Dfile.encoding=UTF-8" JAVA_OPTS="${JAVA_OPTS} -Duser.timezone=GMT" (4). 修改 config 目录下的 twns.xml 文件, 在 web-container 元素处设置如下 : <web-container parameter-encoding="utf-8" response-encoding="utf-8"> (5). 启动 TongWeb, 进入管理控制台配置数据源连接池 进入 资源管理 -> JDBC -> JDBC 连接池, 点击 创建 按钮
配置参数 : 名称 :liferay 资源类型 :javax.sql.datasource 数据库类型 :Oracle Type 4 Driver for Oracle 8.1.7,9.0.1,9.2.0 点击 下一步 配置数据库连接 配置参数 :
连接 URL:jdbc:oracle:thin:@127.0.0.1:1521:orcl 数据库驱动类名 :oracle.jdbc.driver.oracledriver 用户名 / 密码 :tongtech/tongtech 连接验证 : 选中 表名 :dual ( 输入数据库中存在的表名 ) 其于配置暂为默认值点击 创建 完成配置重新进入配置页面, 点击 测试连接, 检查是否连接成功 进入 JDBC 资源, 点击 创建 配置参数 : JNDI 名称 :jdbc/liferaypool ( 注 : 名称必须为 jdbc/liferaypool) 连接池名称 : 选择配置的 liferay 其余暂为默认值点击 创建 完成配置 (6). 进入管理控制台配置 JavaMail 进入 资源管理 -> JavaMail 资源, 点击 创建
配置参数 : JNDI 名称 :mail/mailsession ( 注 : 名称必须为 mail/mailsession) 默认邮件服务器 :mail.163.com 默认用户名 :test 默认用户的邮箱 :test@163.com 其余暂为默认值点击 创建 完成配置 2.5 liferay 在 TongWeb5.0 上的部署 TongWeb5.0 可以将应用以 war 包形式部署, 也可以展开目录形式部署, 现介绍目录部 署方式 (1). 将打好的 liferay 应用包通过 FTP 工具上传至 TongWeb 应用服务器所在机器上 (2). 将应用包解压到 TongWeb 安装目录以外的目录下, 如 /home/tongweb/application 下 (3). 进入 TongWeb 管理控制台, 部署应用 进入 应用 -> 应用管理 -> Web 应用, 点击 部署
配置参数 : 应用类型 : 选择 WEB 应用 和 本地部署 本地部署 :/home/tongweb/application ( 应用所在目录 ) 应用名称 :liferay 应用前缀 :/ ( 注 : 应用前缀必须为斜线 ) 虚拟主机 : 选择 server 其余暂为默认值点击 部署, 开始应用部署 2.6 测试并访问应用 (1). 确认应用部署成功, 日志中没有异常信息出现 (2). TongWeb 默认为应用分配的访问端口为 8080, 通过访问 http://tongwebip:8080 可以访 问到应用
(3). 也可以点击应用的 http 访问, 访问到应用