安装并配置OCEE

安装并配置OCEE

取得OCEE下载包后解压，可以看到目录结构如下：

config\       ------ 放了一些OCEE的配置信息，在配置时可以从这里复制
docs\         ------ 各模块PDF详细文档
lib\            ------ 各模块的JAR文件，安装时会从这里复制
modules\   ------ 对应各种jar的各路modules，可以从后台import
mysql\       ------ 有convert_innodb.sql 一个文件，需要把DB转换成innodb格式
setup.zip    ------ 可以和OpenCms中的setup文件放在一起，和OpenCms一起安装（也可以先安装OpenCms再import OCEE）
cluster-quick-start.pdf   ------快速开始的一个文档
history.txt  ------ OpenCms的各种版本的升级历史

这里我们主要介绍下OpenCms已经安装成功后如何import OCEE

Step1: 通过 http://localhost:8080/opencms/opencms/system/login/ 登录到后台,并切换到Administrator 视图，打开 Module Management，点击 Import Module with HTTP，依次选择modules目录里的zip文件并自动安装，官方推荐安装顺序是

org.opencms.ocee.base
org.opencms.ocee.cache
org.opencms.ocee.transaction
org.opencms.ocee.vfsdoctor
org.opencms.ocee.ldap
org.opencms.ocee.cluster
org.opencms.ocee.replication

其实，只要注意的是安装org.opencms.ocee.replication_3.5.1.zip前先要安装org.opencms.ocee.transaction_3.5.1.zip就可以了

如果某一个module你不想安装就不用import，比如org.opencms.ocee.ldap，你目前还不想和ldap集成就可以不import，假如你安装了，但你没有集成OpenCms在启动服务和登录会有点慢，会去连接默认配置中的ldap server： my.ldap.server:389，但实际是不存在的，就是慢点，不会影响使用

安装效果如下图

 

Step2：

 2.1 复制所有的 sample-config/ocee-*.xml到 ${OPENCMS_HOME}/WEB-INF/config

需要注意的是如果你是在WINDOWS下配置的就要删除ocee-vfsdoctor.unix文件，并把ocee-vfsdoctor.win.xml重命名成ocee-vfsdoctor.xml

 2.2 把sample-config/opencms.xml.part所有的内容复制到${OPENCMS_HOME}/WEB-INF/config/opencms.xml里面,内容如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE opencms SYSTEM "http://www.opencms.org/dtd/6.0/opencms-configuration.dtd">

<opencms>
    <configuration>
        <config class="org.opencms.configuration.CmsSystemConfiguration" />
        <config class="org.opencms.configuration.CmsVfsConfiguration" />
        <config class="org.opencms.configuration.CmsWorkplaceConfiguration" />
        <config class="org.opencms.configuration.CmsImportExportConfiguration" />
        <config class="org.opencms.configuration.CmsSearchConfiguration" />
        <config class="org.opencms.configuration.CmsModuleConfiguration" />
        
        <config class="org.opencms.ocee.license.CmsLicenseConfiguration"/>    
        <config class="org.opencms.ocee.ldap.CmsLdapConfiguration"/>    
        <config class="org.opencms.ocee.cache.CmsCacheConfiguration"/>    
        <config class="org.opencms.ocee.vfsdoctor.CmsVfsDoctorConfiguration"/>    
        <config class="org.opencms.ocee.cluster.CmsClusterConfiguration"/>    
        <config class="org.opencms.ocee.replication.CmsReplicationConfiguration"/>    
        
    </configuration>
</opencms>

  2.3 替换 sample-config/opencms-system.xml.part 里的内容到 ${OPENCMS_HOME}/WEB-INF/config/opencms-system.xml

<opencms>
    <system>
        ...
        <requesthandlers>
            <requesthandler class="org.opencms.ocee.cluster.CmsClusterRequestHandler"/>
        </requesthandlers>
        ...
        <validationhandler class="org.opencms.ocee.ldap.CmsLdapValidationHandler" />
        ...
        <runtimeclasses>
            <runtimeinfo class="org.opencms.ocee.db.transaction.CmsTransactionDbContextFactory"/>
        </runtimeclasses>
        ...
        <memorymonitor class="org.opencms.ocee.cluster.CmsClusterMemoryMonitor">
        ...
    </system>
</opencms>

 2.4 增加或者替换 sample-config/opencms.properties.part 到 ${OPENCMS_HOME}/WEB-INF/config/opencms.properties

这里要注意的是opencms.properties.part默认用的是oracle作为driver manager，我们这里用的mysql，所以要把org.opencms.ocee.db.oracle.CmsSqlManager 改成 org.opencms.ocee.db.mysql.CmsSqlManager

opencms.properties.part中默认已经配置了replication的一些信息，比如

db.pool.replication.jdbcUrl=jdbc:mysql://10.0.9.91:3306/opencms，但10.0.9.91这样的机器还并不存在，我们会用其他的篇幅介绍如何配置slave replication，如果你没有配置的话启动会超级慢，大概启动服务有10分钟左右，登录也超级慢，他会一直尝试去连接这台机器，但能登录进去，也能看到所有已经安装的OCEE的菜单，就是慢

觉见的db的driver manager有以下几种：

MsSql 2005:  org.opencms.ocee.db.mssql.CmsSqlManager
MySql 3:    org.opencms.ocee.db.mysql3.CmsSqlManager
MySql 4/5:    org.opencms.ocee.db.mysql.CmsSqlManager
Oracle 8:    org.opencms.ocee.db.oracle8.CmsSqlManager
Oracle 9/10:   org.opencms.ocee.db.oracle.CmsSqlManager
PostgreSql 8:  org.opencms.ocee.db.postgresql.CmsSqlManager

 2.5 打开 ocee-license.xml 文件，填入你得到的license key，如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE opencms SYSTEM "http://www.alkacon.com/dtd/6.0/ocee-license.dtd">

<opencms>
    <license>
        <name>xxxxxx</name>
        <key>xxxxx-xxxxx-xxxxx-xxxxx-xxxxx</key>
    </license>
</opencms>

2.6 转换数据库类型为InnoDb，如果你的数据类型已经是这个可以忽略，如果你不清楚的话运行下mysql/convert_innodb.sql文件可以转换下

不转换也能用，目前我还不知道会带来什么影响

2.7 非常重要，注意名称一致

在opencms.properties中有 server.name=Master

在ocee-cluster.xml中有

<servers>
            <server>
                <name>Master</name>
                <url>http://localhost:8080/opencms/opencms/handleCluster</url>
                <ip>127.0.0.1</ip>
                <event-source>true</event-source>
            </server>
            <server>
                <name>Replication</name>
                <url>http://10.0.9.91:8080/opencms/opencms/handleCluster</url>
                <ip>10.0.9.91</ip>
            </server>
        </servers>
<wp-server>Master</wp-server>

高亮Master必须一致， Replication必须和你即将安装的slave replication中的 opencms.properties的server.name=Replication一致

2.8 查看OCEE是否安装成功，Alkacon OCEE所有图标都是可以用的