Activiti 5.9 的Demo安装

Activiti5.9于2012年3月1日发布，其默认demo的发布脚本只是针对h2数据库，对于其它类型的数据库都需要自己额外的处理。

如下是在 windows 7 32位环境下使用 oracle 数据库的安装实录：

一）安装ant1.8.3和jdk1.6+环境
    主要是设置环境变量ANT_HOME和JAVA_HOME，并将%ANT_HOME%\bin、%JAVA_HOME%\bin设置到path环境变量中。

二）下载 activiti-5.9.zip

三）将activiti-5.9zip解压到指定目录，假设为“D:\activiti”，注意下面提到的路径均是相对于该路径而言

四）修改数据库类型为 oracle
1）打开文件“setup\build.db.properties”修改为如下内容：
# -----------------------------------------------------------
db=oracle
jdbc.driver=oracle.jdbc.driver.OracleDriver
jdbc.url=jdbc:oracle:thin:@localhost:1521:ORACLE
jdbc.username=activiti
jdbc.password=activiti
# -----------------------------------------------------------

五）配置 oracle 数据库
1）创建名称为activiti的空数据库，连接帐号设为activiti，密码也设为activiti
注：如果你创建的数据库及帐号密码有异，请作相应修改，并同时修改上一部中build.db.properties文件中的相应配置。
2）将 oracle 的 jdbc 驱动包复制到 setup\files\dependencies\libs 目录下 (我使用的是 ojdbc14.jar)。
3）修改 setup\build.xml 文件,添加 oracle  的驱动路径：找到 internal.define.jdbc.driver.libs 配置节点,修改内容如下:
  <target name="internal.define.jdbc.driver.libs">
    <fileset id="jdbc.driver.libs" dir="${activiti.home}/setup/files/dependencies/libs">
      <include name="ojdbc*.jar" />
    </fileset>
  </target>
4）更改 setup\files\demo\h2.data.sql 文件名为 setup\files\demo\oracle.data.sql
5）修改文 如下几个文件，将 h2-1.2.132.jar 替换为 ojdbc14.jar ：
setup\files\dependencies\libs.engine.test.txt
setup\files\dependencies\libs.webapp.explorer.txt
setup\files\dependencies\libs.webapp.rest.txt
setup\files\dependencies\libs.engine.runtime.feature.cxf.txt
6）修改文件如下文件，删除 servlet-api-2.5.jar ：
setup\files\dependencies\libs.engine.runtime.feature.cxf.txt
7）删除 setup\files\dependencies\libs\h2-1.2.132.jar、servlet-api-2.5.jar

注：如果要预先创建好数据库，执行 >ant internal.db.create >internal.db.demo.data即可(此操作执行后在install时会报唯一约束错误，建议不做)。

六）预下载一些必需的文件到“C:\downloads”
到 http://tomcat.apache.org/download-60.cgi 下载apache-tomcat-6.0.32.zip  （6.75MB）并放到C:\downloads下

七）build.xml文件的其它节点修改
1）修改浏览器的可执行文件路径
    打开文件“setup\build.xml”修改属性windows.browser的值为浏览器的启动文件对应的位置。如我一直使用chrome，配置如下：
  <property name="windows.browser" value="C:/Users/你的登录帐号名/AppData/Local/Google/Chrome/Application/chrome.exe" />
   修改这个的目的是方便下面的"ant demo.start"结束后自动打开浏览器访问相关演示模块的首页。
2）删除h2数据库的相关处理代码
target:demo.start中的depends删除h2.start；
target:demo.install中删除 <antcall target="h2.install" /><antcall target="h2.start" /><antcall target="h2.stop" />；
target:demo.stop中的depends删除h2.stop；
同时建议修改掉一些description中的H2信息避免造成误会。
3）修改浏览器的相关配置：如下增加"Windows 7"的配置
<macrodef name="open-html-page">
  ......
  <exec executable="cmd" os="Windows Vista, Windows XP,Windows 2000,Windows 98,Windows 7" failifexecutionfails="false" failonerror="false">
   <arg value="/C start &quot;${windows.browser}&quot; &quot;@{url}&quot;" />
  </exec>
  ......
</macrodef>

八）避免tomcat控制台中文乱码的修改
setup\files\webapps\activiti-explorer.war\WEB-INF\classes\logging.properties
setup\files\webapps\activiti-rest.war\WEB-INF\classes\logging.properties
上述两个文件增加如下一行的配置：java.util.logging.ConsoleHandler.encoding = GBK

九）检查一下你的电脑是否已经使用了tomcat服务
如果使用了tomcat服务，得停掉，否测会冲突。顺便检查一下8080端口有没有被占用，否测也会冲突导致安装失败。

十）一切就绪后就可以开始体验了
命令行切换到“setup/"，运行"ant demo.start"，等待整个安装过程自动完成吧，安装完毕后默认会自动打开浏览器访问系统，访问地址默认为：http://localhost:8080/activiti-explorer
Activiti Explorer是流转引擎的用户控制台，用户可以在此开始新的流程实例、分配任务、浏览领取任务等，还可以作为管理员管理Activiti的流转引擎。
默认的演示用户如下：
UserId Password Security roles
kermit kermit admin
gonzo gonzo manager
fozzie fozzie user