按照官方教程整合Apache+Tomcat+OpenCms
按照下面的文档做了配置,在自己机器上很简单就OK了.先写出来,还有 配置方法.
实现环境:XP+Apache2.2.8+Tomcat5.5+OpenCms7.0.4+Mysql4.1
[ 王毅原创,转载注明]
使用 Apache 的 mod_proxy 模块来去除站点url中的两个"/opencms/opencms"
以下内容介绍如何集成 Apache httpd, Apache Tomcat 和 OpenCms 7 来实现如下效果:
- 所有静态资源 (e.g. images or binaries) 直接由 Apache 服务器处理响应
- OpenCms 中的动态内容通过 Tomcat 处理响应
- 可以去掉OpenCms站点 url 中通常出现的 /opencms/opencms/ 前缀
以下配置在下面环境中测试通过:
- Apache httpd 2.0.54 (基本上大部分稳定版本的Apache httpd 2.0 以及2.2[譬如最新的2.2.8]都可以正常工作, 1.3 及其更低的版本就不行了)
- Apache Tomcat 5.5.7 (其他支持 CoyoteConnector 连接器的都应该可以正常运行)
- OpenCms 7(最新7.0.4完全没有问题)
请注意: 安装之前确定所用的域名可以在机器上正确解析.否则可能配置不成功.
本文档假设安装环境如下:
- OpenCms 服务器域名为 www.wangyi.com
- Tomcat的安装目录为 D:\Tomcat5.5
- Tomcat 和 Apache 安装在一个硬件机器上
请注意: 请在自己测试的时候将域名和安装目录做正确替换.
请注意: 本文不涉及OpenCms的静态导出设置,需要请参考另外的文档.
步骤 1: 安装OpenCms
在 D:\Tomcat5.5\webapps\ 目录下以 ROOT 安装OpenCms. .
重要: 确保Tomcat下没有名为 opencms/ 的项目.
- 删除或者重命名 Tomcat 默认 web 应用 ROOT/.
- 修改 opencms.war 为 ROOT.war
- 重启 Tomcat ,然后开始基本安装.
譬如在这里可以在浏览器输入 http://www.wangyi.com:8080/setup 来进行安装.
这一步完成以后,可以正确安装并能登录OpenCms系统. 但是你会发现一些图片或者CSS等静态资源可能丢失.不要紧, 可以在下一步中解决这个问题.
步骤 2: 配置 OpenCms
在 D:\Tomcat5.5\webapps\ROOT\WEB-INF\config\opencms-importexport.xml 配制文件中,找到 staticexport/rendersettings/..prefix 节点,并除去其中的 ${SERVLET_NAME} 变量. 经过编辑,内容应该如下:
<rendersettings>
<rfs-prefix>${CONTEXT_NAME}/export</rfs-prefix>
<vfs-prefix>${CONTEXT_NAME}</vfs-prefix>
<userelativelinks>false</userelativelinks>
<exporturl>http://127.0.0.1:8080${CONTEXT_NAME}/handle404</exporturl>
...
</rendersettings>
在 D:\Tomcat5.5\webapps\ROOT\WEB-INF\config\opencms-system.xml 配制文件中, 找到 system/sites 节点并配置站点如下:
<sites>
<workplace-server>http://www.wangyi.com<workplace-server>
<default-uri>/sites/default/</default-uri>
<site server="http://www.wangyi.com" uri="/sites/default/"/>
</sites>
在 OpenCms 配置中要做的就只有这两部分了,其他的需要交给Apache和Tomcat了.
注意: 尽管作出了上述修改, 但是经过配置 Tomcat 和 Apache 以后,整个站点才能正确运行.
指定 Aliases
当然,如果又多个域名指向一个站点,可以添加 alias 节点. 注意的是,每个域名只能是唯一的指向一个站点. 譬如,如果我要让域名 www.lixiaoyan.com 以及 www.myopencms.cn 也指向这个站点,那么只要这几个域名都可以正确解析,就都可以访问同一个站点:
<site server="http://www.wangyi.com" uri="/sites/mysite/">
<alias server="http://www.lixiaoyan.com"/>
<alias server="http://www.myopencms.cn"/>
</site>
步骤 3: 配置 Tomcat
打开 D:\Tomcat5.5\conf\ 目录下的文件 server.xml . 建议修改之前做备份.
修改之后,内容应该如下:
<Server port="8005" shutdown="SHUTDOWN" debug="0">
<Service name="Tomcat-Standalone">
<!-- Define a connector for the "public visible" server name -->
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
port="8081" minProcessors="5" maxProcessors="75"
proxyName="www.wangyi.com" proxyPort="80"
useBodyEncodingForURI="true" enableLookups="true" redirectPort="8443"
acceptCount="100" debug="0" connectionTimeout="20000"
useURIValidationHack="false" disableUploadTimeout="true" URIEncoding="utf-8" />
<Engine name="Standalone" defaultHost="localhost" debug="0">
<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">
<!-- You can change "unpackWARs" and "autoDeploy" to false after the installation is finished -->
<Logger className="org.apache.catalina.logger.FileLogger"
directory="logs" prefix="localhost_log." suffix=".txt"
timestamp="true"/>
</Host>
</Engine>
</Service>
</Server>
你可以修改你的 server.xml 时候,把这段代码复制过去,把 www.wangyi.com 修改为你的站点名称.
以上就是 Tomcat 做的全部配置.这里需要注意的地方有三处:
1.建议设置 useBodyEncodingForURI 为utf-8. 否则, 页面传参使用默认 ISO-8859-1 编码,可能会导致某些时候乱码.
2.Service的name 属性的值变成了"Tomcat-Standalone"
3.8080端口的 Connector 增加了 className="org.apache.coyote.tomcat4.CoyoteConnector"属性.
注意: You must first finish the Apache configuration described in the next step to check if Tomcat and OpenCms work correctly.
步骤 4: 配置 Apache
在我的Apache配置目录 D:\Apache2\conf\ 下找到 httpd.conf (当然也可能是其他配置文件,关键是配置你这个OpenCms站点的文件). 同样,修改之前建议备份.
首先,确认以下三个模块被加载.
LoadModule alias_module modules/mod_alias.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
然后配置 <VirtualHost> . 在这个例子中增加如下 <VirtualHost> 节点:
<VirtualHost *:80>
<Directory "D:\Tomcat5.5\webapps\ROOT\">
Order allow,deny
Allow from all
</Directory>
ServerName www.wangyi.com
ServerAdmin [email protected]
DocumentRoot "D:\Tomcat5.5\webapps\ROOT\"
ErrorLog logs\error.log
# Log only non-redirect requests in "normal" log file
SetEnvIf Request_URI "\/opencms\/*" redirect
CustomLog logs/localhost-access.log common env=!redirect
ProxyPass /opencms/ !
RedirectPermanent /opencms/ http://www.wangyi.com/
ProxyPass /resources/ !
ProxyPass /export/ !
ProxyPass / http://localhost:8081/opencms/
ProxyPassReverse / http://localhost:8081/opencms/
</VirtualHost>
同样,你用的时候也要正确修改域名和 DocumentRoot !
启动 Tomcat 和 Apache 就可以登录OpenCms系统了.就象下面的截图一样:
怎么样?要不您也来试试吧?
2008-04-03 | 按照官方教程整合Apache+Tomcat+OpenCms
2007-10-16 | Apache Tomcat Connection and Failover-Cluster
2007-03-23 | [转]OpenCms for MySql 安装图解
2007-03-23 | [转][图文]OpenCms VFS plugin for Eclipse 安装与使用
2008-03-21 | OpenCms的官方在线演示站点
2008-03-21 | <cms:contentload>标签的使用
2008-03-18 | 来自 Alkacon Software GmbH 的邮件
2008-02-05 | 在OpenSuse下安装OpenCms的时候如何去掉路径中的opencms
2007-12-14 | <cms:editable>标签的使用
2007-12-13 | <cms:contentshow>标签的使用
2007-12-12 | <cms:contentloop> 标签的使用
2007-12-11 | <cms:contentinfo>标签的使用
2007-12-10 | <cms:contentcheck>标签的使用