STRINGBEANS 安装说明
========================
本文用作StringBeans 的安装说明。
War 发布文件与包含了TOMCAT 的捆绑发布文件一样。
Stringbeans 3.5需要 JDK 1.5 及更高.
Beta 版本中没有包括对WSRP (Web Services for Remote Portlets) 的支持,只会在最终发布版中加上.
内容清单:
-----------------
I. 预备工作
II. 假定项目
III. 安装
o Stringbeans Web 应用程序
o Stringbeans Portal 服务绑定 Tomcat
o Stringbeans Portal 服务与 Weblogic Server
o Stringbeans Portal 服务与 JBoss
o Stringbeans Portal 服务未发布的 War 文件
o Stringbeans Web Services
o Stringbeans WSRP 生产者
o Stringbeans WSRP 消费者
IV. 测试安装
V. 发布安装设置
VI. 创建新用户
VII. 数据库设置
VIII. 安全登录
IX. 禁用密码加密
X. SSL (Secure Socket Layer) 设置
XI. 配置日志输出
XII. 增加新主题和重发布 Stringbeans Portal
XIII. 页面布局设置
XIV. 部署成默认应用
XV. 使用 Stringbeans Struts 桥接功能
XVI. 问题解决
I. 预备工作
-----------------
1. JDK 1.5.x 或更新版本必须安装.
2. 设置 JAVA_HOME 环境变量并指向 JDK 安装路径。
3. 必须安装兼容Servlet 2.4 JSP 2.0 的容器.
II. 假定项目
---------------
1. Apache 5.5.x 或更新版本已使用
Stringbeans 已解压并安装后.
简要说明在 Weblogic and JBoss 上的安装 . 如果使用其它容器,会提到这些.
2. $TOMCAT_HOME 参照Tomcat 安装路径.
3. $STRINGBEANS_HOME 参照Stringbeans 安装路径,
4. Tomcat 通过 server.xml 手动配置.
III. 安装
-----------------
Stringbeans Web 应用
---------------------------
1. 下载 stringbeans-webapp-x.x.zip 包.
2. 解压 Stringbeans Web 应用包. 找到stringbeans-webapp-x.x文件夹下
stringbeans.war 文件 INSTALL_README_ZH.doc 和
demo 数字证书, demo.jks (参照 SSL 安装).
3. 复制 stringbeans.war 文件到 Tomcat 的webapps 目录下,
即 $TOMCAT_HOME/webapps 下
4. 启动Tomcat.
Windows 下是 $TOMCAT_HOME/bin/startup.bat
Unix or Linux 下是 $TOMCAT_HOME/bin/startup.sh
您先可以把 Tomcat 作为系统的守护进程或系统服务运行. 查阅Tomcat
的文档,里面有更详细的内容.
提示: 如果 Stringbeans 运行在防火墙或代理服务器下, 在解析URL或RSSPortlet 您会遇到连接方面的问题 . 参照 “问题解决” 部分详细了解.
5. stringbeans.war 文件已经被配置成Tomcat webapps在路径下直接可用 .
在进程实例中默认使用Hypersonic 数据库连接. 日志默认输出到控制台.
在开始使用portal的 “测试”章节前,如果对此配置满意, 可以跳过本章节其它步骤直接阅读“发布安装设置”章节。
6. Tomcat 启动后默认的预先配置项会自动加载Hypersonic数据库.如果使用Hypersonic 数据库,则无需进行配置 。
如使用其它数据库, 您必须在数据库配置文件dbconfig.xml.配置数据源参数,
在配置完成后重启TOMCAT 以使用配置生效.
参照下面的“数据库设置”章节配置其它数据库。
7. 支持 (SSL) ,但必须另外配置.
请对照 SSL (Secure Socket Layer) 配置章节查看更详细信息.
提示:如果WEB服务器上SSL不可用, 在页面上点击安全
URL的图标或使用https 访问页面时,Stringbeans 不会响应.
有些选项和特色功能需要SSL 配置成优先可用,
如: 安全登录.
在设置后,必须重启TOMCAT .
8. Stringbeans 默认设置成存储密码到数据库前进行加密。
.移除此项, 参照下面的 “禁用密码加密”章节.
9. Portal 日志默认输出到控制台.
如果想设置输出到文件, 需要配置 $STRINGBEANS_HOME/WEB-INF/classes/下的
log4j.properties 文件设置日志输出器。
参照下面的“配置日志输出”配置章节查看更详细信息.
10. 将 Stringbeans 安装成默认应用 (即 用户输入http://<server-name> 就能访问
Stringbeans portal , 而不是输入 http://<server-name>/stringbeans ),
解压 the stringbeans.war 文件到 stringbeans 目录 (需要建立这个路径).
参照下面的“部署成默认应用”配置章节查看更详细信息.
Stringbeans 与TOMCAT 的绑定包也可使用。(包名
为 stringbeans-x.x_tomcat-x.x.xx.zip).
Stringbeans在这个安装包中安装为默认应用