OpenCms 6安装
本页提供如何使用
Tomcat 和
MySql来安装opencms的信息. 所有组件的安装被单步描述. 请确保每步安装都成功.
1. 安装JDK(版本为 1.4或更高）
安装JDK(版本为 1.4或更高） (从SUN http://java.sun.com/products/j2se/公司获得). 关于如何在你的操作系统安装这些组件的细节，请参考sun提供的相关文档。. 你应该确认安装 Java的SDK, 而不是同样可以从SUN获得的 JRE (JAVA 运行时环境). JRE不能 满足OpenCms的运行!
重点: OpenCms 6 仅仅在JDK1.4和JDK5.0中测试通过.一些属性不能从JDK1.4以前版本的JDK中获得.
提示: FreeBSD用户 应该需要安装最新的资源以便系统使用rndcontrol功能. 否则的话，安装将会中断. 例如, 在一台网卡暂用IRQs 9的机器上, 你可以执行
rndcontrol -s 9
2. 安装 Tomcat
OpenCms 6.0 需要一种兼容Servlet 2.3 / JSP 1.2标准的容器. Tomcat 4 是这种标准的参考实现. 本发布版在Tomcat 4.1.x, Tomcat 5.0.x 和 Tomcat 5.5.x下测试通过. 对于Tomcat不支持新标准的更老的版本 (3.x以前) 不能够使用OpenCms 6.0. Tomcat 4.0.x 没有测试,但是应该能够工作.
从http://jakarta.apache.org/tomcat/index.html 下载Tomcat并安装到你选择的文件夹中. 这就是 CATALINA_HOME 指定的文件夹. 不要忘记设置环境变量CATALINA_HOME 和 JAVA_HOME.
通过在standalone模式下运行Tomcat并检测实例来测试Tomcat的安装. 提示: Tomcat在standalone模式下使用8080端口. 如果你愿意,你可以将servlet引擎和web服务器结合，像Apache Web Server http://www.apache.org/httpd.html . 如何和servlet引擎结合，请参考webserver文档.
提示: 你可以从opencms.org一份额外的文档来知道如何使用mod_proxy在Apache httpd和Tomcat上安装OpenCms。
提示: 旧版本的OpenCms需要设置Java文件编码使用 -dfile.encoding=.... . 对于OpenCms 6已经不再需要了.
3.安装 MySQL
从http://www.mysql.com/downloads/index.html 下载安装MySQL。(参考MySQL在线文档 http://www.mysql.com/documentation/index.html ). MySQL Windows版被安装到 C:\盘，应该使用 %MYSQL_HOME%/bin/mysqld -install注册Windows服务.
OpenCms能够使用MySQL 3.2, 4.0和4.1.由于效率原因我们推荐MySQL 4.1,或者最少4.0.
通过运行服务(WIN32下)或者执行 %MYSQL_HOME%/bin/mysqld(UNIX)启动MySQL服务器.
在继续前请通过启动MySQL监视器 (在MySQL安装目录的bin文件夹下执行 mysql)测试MySQL正常运行. 数据库正常工作如果执行monitor后出现MySQL提示符 . 键入exit退出MySQL监视器，继续下一步.
重点: 你应该增加MySQL配置文件(通常为my.ini)中配置变量max_allowed_packet的值. 对于OpenCms, limit应该尽可能的高, 推荐设置：max_allowed_packet=16M。
4. 部署opencms.war文件
从下载的二进制压缩包ZIP文件中拷贝opencms.war文件到CATALINA_HOME/webapps/目录下. 使用Tomcat的真实安装路径替换CATALINA_HOME变量.
启动(或重启)Tomcat. Tomcat现在将部署应用OpenCms.
重点:确保OpenCms的War包的完整性 *.war . OpenCms只能以War的方式部署. 确定Tomcat解包war文件并且创建CATALINA_HOME/webapps/opencms/目录, 并将OpenCms文件拷贝到这个目录. 你的Servlet容器默认的配置 / 环境不能解包*.war文件.如果这样请手动解包. 对于解压缩工具, *.war文件和*.zip文件只是扩展名不同而已.如果没有解包*.war文件，OpenCms安装向导将显示一个警告并不允许你继续。
5. 使用安装向导安装OpenCms
在浏览器中键入以下地址 http://localhost:8080/opencms/setup开始安装. 依赖于你的配置, 你可以替换 localhost 为你的服务名. 端口8080仅仅在以standalone模式启动Tomcat时使用.
遵循OpenCms的安装想到提示,使用“标准”安装. 它将建立OpenCms数据库并倒入所有能够获得 的模块到系统zho能够. 对于正常的Mysql和Tomcat安装在一台服务器上的情况，所有的默认设置都将满足你的需求.
重点: Make sure you disable all popup blockers for the server URL you installed OpenCms on. Otherwise you will not be able to log in to the OpenCms Workplace.
6. 现在你的系统已经就绪
现在你的系统可以使用了. 你可以使用用户名: Admin 和密码: admin登陆了. 请尽可能快地更改密码. OpenCms默认的登陆URL: http://localhost:8080/opencms/opencms/system/login/
7. 安全提示
在成功安装OpenCms后，你应该检查一下安全方面的设置.
首先通过用户设置（Workplace主窗口中“checkbox”图标）更改OpenCms用户Admin的密码.
然后给Mysql数据库添加一个密码.在Mysql命令行下敲入如下命令.
use mysql;
insert into user values ('localhost', 'opencmsuser', password('XXXXX'),\
'N','N','N','N','N','N','N','N','N','N','N','N','N','N');
insert into db values ('localhost', 'opencms', 'opencmsuser',\
'Y','Y','Y','Y','Y','Y','Y','Y','Y','Y');
flush privileges;
确认替换opencmsuser 和 opencms 以及数据库你在安装时设置.
不要忘记opencms.properties文件中添加新的用户名和密码. . 只有新的用户能够连接大盘OpenCms表.更多的信息请参阅MySQL文档.