Install on Debian Chinese

From ADempiere
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
Retrieved from "http://www.adempiere.com/index.php5?title=Install_on_Debian_Chinese&oldid=15500"