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文檔.