InstallationInstructions_zh < Projects < TWiki

TWiki . Projects . InstallationInstructions_zh

Blandware AtLeap 安装说明

* MySQL配置
*配置PostgreSQL
*配置Oracle
*其它数据库配置

Troubleshooting

共同的初始步骤

1. 阅读软件安装环境文档并安装你需要的软件。安装Java运行环境或JDK到一个目录名称不带空格的目录。例如C:\Program files\ 这个目录就会有问题，因为它的名称带有空格。

2.设置JAVA_HOME环境变量指向你的JDK安装目录。例如C:\java\jdk1.5.0_02

3.配置 JVM (Java Virtual Machine) 。请参考JavaConfiguration

4. 设置ANT_HOME环境变量指向你的Apache Ant安装目录。例如C:\java\apache-ant-1.6.2

5.设置CATALINA_HOME或RESIN_HOME或JBOSS_HOME环境变量指向你的servlet容器的目录。例如，tomcat的安装目录. C:\java\jakarta-tomcat-5.5.9
AtLeap将以下列的顺序查找容器: Tomcat, Resin, JBoss. 如果你想强制指定容器，你可以在属性文件build.properties里定义。例如resin3=true

6.从网址 https://atleap.dev.java.net/servlets/ProjectDocumentList 下载最新版本的Blandware AtLeap。

7.使用正确的工具解压AtLeap的压缩包。例如，在Windows下使用WinZip解压，在Unix下使用upzip解压。不要把AtLeap解压到目录名太长的目录，否则会导致“input line is too long”的错误。

8.进入你的AtLeap目录，运行下面的命令。

9.在命令窗口运行命令检查每个文件的正确性。例如，在Windows里执行bin\build.bat check-md5，在Unix下执行bin/build.sh check-md5 。 AtLeap提供一个 build.xml文件。你可以直接使用它来执行一些ant命令。例如，ant check-md5a。但是为了避免包含类文件产生问题，AtLeap额外提供了平台依赖的脚本，.bat针对windows，.sh针对Unix。我强烈推荐使用脚本。为了简化下面对于两个平台我用bin/build表示 。

Blandware AtLeap演示例子的快速启动

AtLeap已经嵌入了Hypersonic数据库和Jettyservlet容器。它们被使用来演示。基于性能和稳定的原因，我不推荐你们在产品环境里使用它们。

为了运行AtLeap演示版本，你只需要运行bin/start-demo；
为了关闭AtLeap演示版本，你只需要运行bin/stop-demo；

数据库配置

配置MySQL

1.如果你想使用InnoDB表类型，请在启动mysql时，添加参数 --default-table-type=InnoDB。

2.对于MySQL 4.1你需要在启动时候加参数--default-character-set=utf8

3.如果你有管理员权限， MySQL 提供动态增加数据库的功能。在这里你可以运行bin/build setup，脚本自动帮你做这些事情。否则：

1)请求管理员帮助你创建数据库

2)使用bin/build db-prepare来创建数据表

3)使用 bin/build db-load来加载初始化数据。

4)使用bin/build refresh卸载、清除和重新发布应用。

配置一个支持的应用服务器

为你的应用服务器设置一个全局变量，例如CATALINA_HOME, RESIN_HOME, JBOSS_HOME 。指向你的servlet容器。例如C:\java\jakarta-tomcat-5.5.9
根据build.properties文件里的指示配置属性。推荐创建atleap-build.properties文件，它将覆盖 build.properties文件里的属性。保持build.properties不动。
正确地指定appserver.host。
在Jetty部分，注释掉默认应用服务器Jetty的属性。Comment out the properties of default application server Jetty in Jetty section.
找到自己需要的应用服务器部分，打开你需要的属性。至少你需要打开:
1. appserver.type
2. appserver.http.port
3. appserver.https.port
其它的属性仅仅在特殊环境下才需要打开。

PostgreSQL配置

1.确信PostgreSQL在监听 TCP/IP .

2.手工创建支持 unicode的数据库或向管理员求助。例如，createdb -E UNICODE database_name

3.使用bin/build db-prepare来创建数据表

4.使用 bin/build db-load来加载初始化数据。

5.使用bin/build refresh卸载、清除和重新发布应用。

Oracle配置

1. AtLeap发布包不包括 Oracle的 JDBC驱动，请从 http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html 这里下载它。

2.根据lib目录下lib.properties文件里的说明把 Oracle的 JDBC驱动jar包改名。例如，ojdbc14-10.1.0.jar

3. 把jar包放入lib下合适的目录。例如，lib/ojdbc-10.1.0

4. 创建 Oracle用户和schema ，并且分配所有要求的权限。

5.使用bin/build db-prepare来创建数据表

6.使用 bin/build db-load来加载初始化数据。

7. 使用bin/build refresh卸载、清除和重新发布应用。

配置其它数据库

1.下载该数据库的JDBC 驱动。

2.在lib目录下lib.properties文件里创建一条该JDBC驱动的记录。

3.据lib.properties文件里的设置，把该驱动包放在相对应的目录下。

4.根据该启动文档、Hibernate文档和DBUnit文档在build.properties里创建一条记录。

5.如果它要求，则创建一个数据库

6.使用bin/build db-prepare来创建数据表

7.使用 bin/build db-load来加载初始化数据。

8.使用bin/build refresh卸载、清除和重新发布应用。

在你浏览器里打开 http://localhost:8080/atleap。

Troubleshooting

Tomcat在发布大的war包时有个bug。而 AtLeap恰恰是个大包。所以你在发布AtLeap遇到以下的错误时候，

Missing application web.xml
cannot create JDBC driver of class ' ' for connect URL 'null'
Error deploying application at context path null
or something like

做下列步骤:

1.Stop tomcat

2.Specify deploy.force.unpack=true property in your build.properties file

3. bin/build refresh

4.Start tomcat

Please carefully read documentation and release notes of your servlet container to avoid extra problems. For example Tomcat under Linux recommends to define LD_ASSUME_KERNEL environment variable equal to the kernel version (e.g. 2.4.1).

-- AndreyGrebnev - 27 August 2005 (译者：覃辉)

----- Revision r3 - 28 Aug 2005 - 15:17:53 - Main.qinhui99