### Activiti 5.9 PostgreSQL 安装指南
#### 一、环境准备
为了确保Activiti 5.9能够正常运行在PostgreSQL环境下,首先需要完成以下基础软件的安装与配置:
1. **Apache Ant 1.8.4**:Ant是一种基于Java的构建工具,用于自动化软件编译、测试等过程。需要安装Apache Ant 1.8.4版本,并设置`ANT_HOME`环境变量指向安装目录。此外,还需要将`%ANT_HOME%\bin`添加到系统PATH环境变量中。
2. **JDK 1.6+**:Activiti支持JDK 1.6及更高版本,因此需要安装JDK 1.6或更高版本,并设置`JAVA_HOME`环境变量指向JDK安装目录。同样地,将`%JAVA_HOME%\bin`添加到系统PATH环境变量中。
#### 二、下载并解压缩Activiti 5.9
- **下载Activiti 5.9**:从官方网站或其他可信源下载Activiti 5.9的ZIP包。
- **解压缩**:将下载好的`activiti-5.9.zip`文件解压缩到自定义目录,例如`D:\activiti`。本教程中的所有路径都是相对于此目录进行的。
#### 三、配置数据库
接下来需要配置Activiti以使用PostgreSQL作为数据库。
1. **修改数据库配置**:编辑文件`setup\build.db.properties`,将其修改为如下内容:
```
#-----------------------------------------------------------
db=activiti
jdbc.driver=org.postgresql.Driver
jdbc.url=jdbc:postgresql://localhost:5432/activiti
jdbc.username=postgres
jdbc.password=uboss
#-----------------------------------------------------------
```
注意检查并根据实际情况修改数据库用户名和密码。
2. **创建数据库**:在PostgreSQL环境中创建一个名为`activiti`的空数据库,并确保连接用户为`postgres`,密码为`uboss`。如果使用不同的数据库名或用户名/密码,请同步更新`build.db.properties`文件中的配置。
3. **添加JDBC驱动**:将PostgreSQL的JDBC驱动包(例如`postgresql-9.1-902.jdbc4.jar`)复制到`setup\files\dependencies\libs`目录下。如果使用JDK 1.6及以上版本,请选择带有`jdbc4`的JAR包;如果使用JDK 1.5,则应选择带有`jdbc3`的版本。
4. **配置JDBC驱动路径**:编辑`setup\build.xml`文件,在`internal.define.jdbc.driver.libs`节点中添加对PostgreSQL驱动的支持:
```xml
<target name="internal.define.jdbc.driver.libs">
<fileset id="jdbc.driver.libs" dir="${activiti.home}/setup/files/dependencies/libs">
<include name="postgresql-*.jar"/>
</fileset>
</target>
```
5. **重命名数据脚本文件**:将`setup\files\demo\h2.data.sql`文件重命名为`setup\files\demo\activiti.data.sql`。
6. **替换H2驱动文件**:将以下文件中的`h2-1.2.132.jar`替换为`postgresql-9.1-902.jdbc4.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`
7. **预先创建数据库**:(可选)如果希望在安装前就创建好数据库,可以通过命令`>ant internal.db.create >internal.db.demo.data`来实现。但请注意,这一步可能会导致后续安装过程中出现唯一性约束错误。
#### 四、预下载文件
为了避免安装过程中网络问题导致的中断,建议提前下载以下文件并保存到`C:\downloads`目录:
- **Apache Tomcat 6.0.32**:从Apache官方网站下载`apache-tomcat-6.0.32.zip`文件。
#### 五、其他配置
- **浏览器路径**:(可选)如果希望安装完成后自动打开浏览器访问相关演示模块,可以在`setup\build.xml`文件中修改`windows.browser`属性为浏览器的启动文件路径:
```xml
<property name="windows.browser" value="C:/Users/你的登录帐号名/AppData/Local/Google/Chrome/Application/chrome.exe"/>
```
- **删除H2数据库相关代码**:(可选)如果不需要使用H2数据库,可以在`build.xml`中移除与H2相关的处理代码。
通过以上步骤,可以顺利完成Activiti 5.9与PostgreSQL数据库的安装配置工作。这些步骤确保了开发环境的正确搭建,为进一步使用Activiti进行流程管理和开发提供了坚实的基础。