Install on Debian Chinese

From ADempiere
Revision as of 23:12, 18 November 2010 by Peanutblake (Talk) (2. 第二步:导入数据)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.

<返回英文首页> <返回中文首页>

ADempiere安装手册

Debian+Postgres

第一部分

一.说明

1.关于本手册

本手册介绍ADempiere在Debian操作系统和Postgres数据库环境下的的安装方法。ADempiere是一款优秀的开源自由ERP系统。ADempiere支持跨平台安装运行,可运行于Windows/Linux操作系统,支持Oracle/Postgres数据库。

本手册介绍了Java运行环境、Postgres数据库安装、ADempiere系统安装的全过程。

如果你需要在虚拟机上安装ADempiere,请参阅网上资料,文档:VirtualBox安装指南_Debian、VirtualBox虚拟安装Debian简要指南。

如有任何意见或建议,欢迎联系 Peanut Blake

3.安装环境

操作系统
Debian Lenny/Stable i386
运行环境
java-6-sun-1.6.0.12
数据库
PostgreSQL 8.3

4.安装建议

建议初次接触ADempiere的朋友选择稳定版本安装。

Debian操作系统建议目前的稳定版本是Lenny,尽可能不要选择目前的测试版Squeeze/Testing。

ADempiere建议选择目前的稳定版本3.4.2s,尽可能不要选择目前的测试版本:3.5.4a。

第二部分 ADempiere系统安装

二.安装步骤

1. 总体安装步骤。

  1. 设置并检查网络连接。
  2. 安装Java及Postgres。
  3. 安装ADempiere。
  • 设置ADempiere;
  • 导入数据;
  • 运行服务器。

2. 安装前的准备。

1) 检查看更新源是否已经可以正常使用。

首先,以root用户登录。

$ su - root

然后,更新源列表:

# apt-get update

备注:以下命令行中,凡是以“#”开头的,都表示需要以root用户登录操作。

2) 检查浏览器能否正常浏览网页。

启动FireFox或者IceWeasel,输入网址:www.adempiere.com。

3) 下载ADempiere安装包

下载地址:http://sourceforge.net/projects/adempiere/

本示例下载的是ADempiere_342s.tar.gz。

三、Java环境及数据库Postgres安装

1. 安装Java开发环境

# apt-get install sun-java6-jdk

2. 安装Postgres数据库

# apt-get install postgresql-8.3 postgresql-server-dev-8.3 postgresql-8.3-pljava-gcj

说明:如果你准备运行版本号大于或等于3.5.2a的ADempiere ERP,就不必安装PLJava了。另外,目前Debian更新源里还没有postgresql-8.4-pljava-gcj。详情请见:PLJAVA

3. 创建adempiere运行目录。

$ mkdir /home/user/adempiere

"user"是指你的用户名。你也可以指定其它目录安装。

4. 把安装包解压缩,放在运行目录下。

# cd /home/user/adempiere
# tar -xvzf /home/user/ADempiere_342s.tar.gz

5. 修改profile文件,设置运行环境路径。

# sudo gedit /etc/profile
export JAVA_HOME=/usr/lib/jvm/java-6-sun/ 
export ADEMPIERE_HOME=/home/user/adempiere/

在/etc/profile文件里设置环境变量。JAVA的路径一般位于/usr/lib/jvm/下面,需要亲自查找确认。Adempiere的路径就是你所创建的adempiere运行目录。

注意:注销用户并重新登录后,这些设置才能生效

另外,看到有些安装指引提到要设置LD_LIBRARY_PATH,而且安装完成RUN_Setup.sh后,也提示要设置“You chould also have set LD_LIBRARY_PATH”。如果你把JDK安装在"/usr/lib"目录下,一般不需要额外设置LD_LIBRARY_PATH。因为LD_LIBRARY_PATH是用于到"/usr/lib"之外的目录下查找软件运行环境。


四、 数据库Postgres设置

1. 设置数据库Postgres的信任声明

1.1. 修改pg_hba.conf文件:

# sudo gedit /etc/postgresql/8.3/main/pg_hba.conf

目的是使ADempiere能顺利连接和登录Postgres数据库。最省事的方法是把文件中的"md5"、"indent"之类的文字都改为"trust"。pg_hba.conf文件详细设置方法请参照官方文档:PostgreSQL 8.3 Documentation

1.2. 修改完成后,重新启动数据库,使信任声明生效:

# /etc/init.d/postgresql-8.3 restart

另一种方式是不用重新启动数据库,只需要重新读一下pg_hba.conf文件就行了。

# /etc/init.d/postgresql-8.3 reload

2. 修改用户postgres的密码。

# passwd postgres
*******
*******

这个密码一定要记住,在后面的“设置ADempiere”会用到。


接下来的操作有两种方法:

3. 方法一:使用图形化数据库客户端pgAdminIII

  1. 安装pgAdminIII
# apt-get install pgadmin3
  1. 启动pgAdmin,连接postgres数据库。这里要填写登录密码。如果连接不上,说明前面的Postgres的信任声明没有设置好。
  2. 创建用户adempiere。把所有的权限都选上。
  3. 创建名为adempiere的数据库。选择UTF-8编码,拥有者(主人)设为adempiere。
  4. 断开数据库连接。

4. 方法二:使用命令行

4.1.以用户postgres登录

$ su - postgres

4.2. 创建用户adempiere:

Shell命令:

$ createuser -sdrlIPE adempiere

或者SQL命令:

CREATE ROLE adempiere WITH PASSWORD 'adempiere'
SUPERUSER NOINHERIT CREATEDB CREATEROLE
VALID UNTIL 'infinity';
UPDATE pg_authid SET rolcatupdate=true WHERE rolname='adempiere';

4.3. 创建名为adempiere的数据库

$ createdb --encoding='UTF8' --owner='adempiere' adempiere

4.4. 退出postgres

$ exit


五、安装ADempiere ERP

1.第一步:设置ADempiere

这一步用于设置ADempiere的基本运行环境。

# cd /home/usr/adempiere
# sh RUN_Setup.sh

接下来会出现ADempiere Server Setup窗口。把相关数据设置好,点击测试Test后,测试通过的会在小方框打勾。没有Mail Server的话可以暂时不设置。没有通过的测试的要解决,否则下一步无法进行。


KeyStore Password:不需要要修改。
Database Type:Postgres


对于设置有疑问可以点击帮助,在窗口下方的问号(?)按钮。

所有测试通过后,点击“Save“保存,接着程序会自动进行后续操作,


如果出现错误,一定要解决,否则无法进行下一步。

如果成功完成,会出现以下提示:

-----------------------
setup: 
BUILD SUCCESSFUL 
Total time: 3 minutes 19 seconds 
*** 2009-11-11 03:04:05.441 ADempiere Log (CLogConsole) ***
-----------------------

2. 第二步:导入数据

这一步是把数据结构及基础数据导入数据库。

# cd /home/usr/adempiere/utils
# sh RUN_ImportAdempiere.sh

导入成功后,最后几行显示:

-----------------------
… ...
REVOKE 
REVOKE 
GRANT 
GRANT
-----------------------

如果出现错误提示,一定要解决错误后,才能进行下一步。

备注:我个人认为导入数据这一步应当在RUN_setup.sh/bat之前。原因是如果你将补丁放入./lib目录下进行RUN_setup.sh/bat时,会有一个更新数据库版本信息的动作。例如20101111_patches_360_14470.jar,会进行UPDATE AD_TABLE之类动作的,而这时数据库并不存在AD_TABLE这个表格,会出现错误提示。这是我的个人看法,请大家多多指教!

3.第三步:运行ADempiere服务

经过前两步,ADempiere已经安装完毕了。这一步用于启动ADempiere服务。

# sh /home/usr/adempiere/utils/RUN_Server2.sh

如果运行成功,会出现以下提示:

-----------------------
… ...
03:09:27,628 INFO [ChannelSocket] JK: ajp13 listening on debian/127.0.1.1:8009 
03:09:27,661 INFO [JkMain] Jk running ID=0 time=0/102 config=null 
03:09:27,770 INFO [Http11Protocol] Starting Coyote HTTP/1.1 on http-debian%2F127.0.1.1-443 
03:09:27,857 INFO [Server] JBoss (MX MicroKernel) [4.0.2 (build: CVSTag=JBoss_4_0_2 date=200505022023)] Started in 1m:5s:927ms 
-----------------------

4. 登录ADempiere ERP。

在客户机用浏览器,输入http://127.0.0.1/admin,即可看到ADempiere ERP的芳容了。如果无法访问,打开文件/etc/hosts,查看里面的域名设置,改用里面的IP或域名登录。

另外,也可以用Java客户机登录ADempiere ERP。

$ sh /home/usr/adempiere/RUN_Adempiere.sh

5. 停止ADempiere服务

如果需要停止ADempiere服务,可以执行以下命令。

$ sh /home/usr/adempiere/utils/RUN_Server2Stop.sh


第三部分 附录

附录一. 参考文献

  • Debian Reference (version 2)
  • PostgreSQL 8.3.8 Documentation. From: The PostgreSQL Global Development Group
  • MasterERPSetupOperation.pdf. From: Redhuan D. Oon , ADempiere Community

附录二. 网络资源

ADempiere Wiki http://www.adempiere.com
SourceForge http://sourceforge.net
Java JDK http://java.sun.com/javase/downloads/index.jsp