傻瓜式ejbca安装过程

### 傻瓜式EJBCA安装过程详解 #### 一、背景介绍 本文将详细介绍如何在Windows XP环境下安装EJBCA 3.6.3系统，并配置其与MySQL及OpenLDAP协同工作。EJBCA是一款开源的企业级证书管理平台，广泛应用于数字证书的签发和管理。本次安装的目标是为了搭建一个可以正常运行的EJBCA环境，包括必要的软件配置和环境变量设置。 #### 二、所需软件及其版本 - **EJBCA**：版本为3.6.3。 - **JDK**：版本为1.6.0_10。 - **Apache Ant**：版本为1.7.0。 - **JBoss**：版本为4.2.2.GA。 - **MySQL**：版本为5.0.27。 - **OpenLDAP**：未指定版本，假设使用的是最新稳定版。 - **MySQL Connector/J**：版本为3.1.12。 #### 三、安装步骤详解 ##### 1. 安装JDK - 下载并安装JDK 1.6.0_10，安装路径为`G:\Program Files\Java\jdk1.6.0_10`。 - 注意：确保JDK的安装过程中没有勾选“添加到环境变量”选项，后续将手动设置环境变量。 ##### 2. 解压缩EJBCA - 解压缩`ejbca_3_6_3.zip`至`D:\ejbca\ejbca_3_6_3`。 - 这一步是为后续的配置做好准备。 ##### 3. 解压缩Apache Ant - 解压缩`apache-ant-1.7.0-bin.zip`至`D:\ejbca\apache-ant-1.7.0`。 - Apache Ant用于自动化构建过程，例如部署EJBCA等。 ##### 4. 解压缩JBoss - 解压缩`jboss-4.2.2.GA.zip`至`D:\ejbca\jboss-4.2.2.GA`。 - JBoss作为应用服务器，用于承载EJBCA。 ##### 5. 安装JCE Policy - 解压缩`jce_policy-6.zip`至当前文件夹。 - 将`local_policy.jar`和`us_export_policy.jar`复制到`C:\Program Files\Java\jdk1.6.0_10\jre\lib\security`，替换原有文件。 - 这样做是为了扩展JDK的安全策略限制。 ##### 6. 安装MySQL - 安装MySQL 5.0.27到`C:\Program Files\MySQL`。 - 安装MySQL GUI工具至`C:\Program Files\MySQL`。 - 设置管理员名为`root`，密码为`root`。 - 创建数据库`create database ejbca`。 - 下载并安装MySQL Connector/J `mysql-connector-java-3.1.12-bin.jar`至`JBOSS_HOME/server/default/lib`。 ##### 7. 配置环境变量 - `JAVA_HOME`：`C:\Program Files\Java\jdk1.6.0_10` - `JBOSS_HOME`：`D:\ejbca\jboss-4.2.2.GA` - `ANT_HOME`：`D:\ejbca\apache-ant-1.7.0` - `CLASSPATH`：`C:\Program Files\Java\jdk1.6.0_10\jre\lib\security;C:\Program Files\Java\jdk1.6.0_10\lib;D:\ejbca\jboss-4.2.2.GA\server\default\lib` - `PATH`：`%JAVA_HOME%\bin;%ANT_HOME%\bin;%JBOSS_HOME%\bin;D:\ejbca\openldap` - `ANT_OPTS`：`-Xmx512m` - MySQL的环境变量在安装MySQL时会自动添加。 ##### 8. 启动JBoss - 在命令行中切换到`JBOSS_HOME/bin`目录，执行`run.bat`。 - 在浏览器中访问`http://localhost:8080`检查JBoss是否启动成功。 ##### 9. 展开EJBCA - 在命令行中切换到EJBCA所在文件夹下，执行`ant bootstrap`。 - 此命令将在JBoss下创建初始的`ejbca.ear`部署文件和数据源文件`ejbca-ds.xml`以及邮件配置文件`ejbca-mail-service.xml`。 ##### 10. 修改配置文件 - 将`D:\ejbca\ejbca_3_6_3\conf`目录下的`ejbca.properties.sample`文件复制并重命名为`ejbca.properties`。 - 修改`ejbca.properties`文件中的部分内容： - `ca.name=CNGI-AdminCA` - `ca.dn=CN=CNGI-AdminCA,O=CNGI,C=CN` - `httpsserver.dn=CN=localhost,O=CNGI,C=CN` - `database.name=mysql` - `datasource.mapping=mySQL` - `database.url=jdbc:mysql://127.0.0.1:3306/ejbcas` - `database.driver=com.mysql.jdbc.Driver` - `database.username=root` - 数据库口令保持为空。 #### 四、常见问题及解决方案 在安装过程中可能会遇到一些问题，比如数据库配置修改后导致的异常。根据文章描述，在尝试更改数据库配置后，虽然能够通过安装和部署，但在打开网页编辑证书时会出现编译错误。解决这个问题的方法是确保已经将`mysql-connector-java`正确地拷贝到了`JBOSS_HOME/server/default/lib`目录下。 #### 五、总结 通过以上步骤，可以在Windows XP环境下成功安装EJBCA 3.6.3，并与MySQL和OpenLDAP配合使用。需要注意的是，环境变量的正确配置对整个安装过程至关重要。此外，在修改配置文件时应格外小心，避免因配置错误而导致的问题。