Blandware AtLeap演示例子的快速启动

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

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

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

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

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表示 。

10.根据说明在build.properties文件里设置针对你的环境的配置。推荐创建atleap-build.properties文件，它将覆盖 build.properties文件里的属性。

数据库配置

配置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卸载、清除和重新发布应用。

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 - 22 May 2005

共同的初始步骤

配置数据库 MySQL配置

配置PostgreSQL

配置Oracle

其它数据库配置

Troubleshooting

共同的初始步骤

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

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

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

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

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

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

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

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

在命令窗口运行命令检查每个文件的正确性。例如，在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表示 。

根据说明在build.properties文件里设置针对你的环境的配置。推荐创建atleap-build.properties文件，它将覆盖 build.properties文件里的属性。

数据库配置

配置MySQL

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

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

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

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

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

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

PostgreSQL配置

确信PostgreSQL在监听 TCP/IP

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

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

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

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

Oracle配置

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

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

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

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

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

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

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

配置其它数据库

下载该数据库的JDBC 驱动。

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

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

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

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

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

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

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

Open http://localhost:8080/atleap in your browser.

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

做下列步骤: Stop tomcat

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

bin/build refresh

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^? - 22 May 2005

Topic InstallationInstructions . { Edit | Ref-By | Printable | Diffs | r1.4 | > | r1.3 | > | r1.2 | More }