Adempiere安装使用说明.doc

Adempiere安装使用说明本文第0部分是讲的adempiere的下载；第1部分是讲的adempiere的安装；第2部分是讲的补丁及汉化包；第3部分是用户使用。请根据自己的需要，确定从哪部分开始阅读。0、下载Adempiere的部署版本：在/projects/adempiere/files/ADempiere%20Official%20Release/中选择360LTS版本（或者先进入/projects/adempiere/files/，然后选择Adempiere Official Release。如果是下Windows Installer版本，则在此选择WindowsInstaller）。顺带说一下，Adempiere的源码在/svnroot/adempiere/ 下载。但据/index.php/Chinese的报道，“(01-14)ADempiere 代码开发正在由SVN迁移至Mercurial! 在此阅读迁移时间表 - 2011年01月14日”。1、安装Windows Installer版本（自带PostgreSQL数据库）的Adempiere，或者分别安装adempiere和oracle数据库。注意，adempiere最好安装在C:adempiere下，否则，若安装路径中有空格，在配置服务器时会出错。而数据库可按默认路径安装。之后，需按照以下步骤进行配置和启动：A）配置数据库、应用服务器参考：/index.php/InstallServer。操作步骤： 先找到RUN_Setup并运行，然后出来配置界面，这里需要注意的是：不一定是按照介绍文档上面的进行配置，比如我的机子就是这么配置就通过测试的：（建议 按照原始的配置直接测试一下，如果通过就不再修改；如果没有通过，再按照说明文档上的内容进行修改）Adempiere+postgres数据库的设置界面Adempiere+Oracle数据库的配置界面相关说明：1）当测试时，各项内容后面如果显示对勾 则表示该项内容正确。其中内容为adempiere的Database Name一项可能不会显示对勾，但不影响后续操作。同样，数据库账号与数据库口令若是在这里新设，也不会显示对勾，但不影响后续操作。2）应用服务器的地址最好设成，以侦听本地的所有地址（而不仅是），这样才能通过另外的机器访问到服务器。3）如果要在另外一台机器连接服务器的数据库，分两种情况处理：1）安装的oracle数据库。则必须使oracle数据库端口1521通过防火墙，必须在服务器防火墙中配置例外以允许1521端口，或者关闭防火墙。2）若使用postgres数据库，必须在pg_hba.conf配置文件中加上对外部ip的支持，否则默认只支持的IP。例如，/8就表示支持IP为10.*.*.*的机器；/24就表示支持IP为10.21.1.*的机器。另外，也需要在防火墙中配置例外以允许访问postgresql端口（我的机子设置的是5432端口）（具体步骤：网上邻居-本地连接右键-属性-高级-设置 即出现防火墙设置窗口，选择 例外选项卡，添加端口 -应用 即可）配置后 可以测试一下：telnet 0（某机IP） 5432B）数据库导入参考：/index.php/Initialize_the_ADempiere_Database操作步骤：在安装目录的data文件夹下找Adempiere_pg.dmp文件（如果是PostgreSQL数据库就是Adempiere_pg.dmp文件；如果是oracle数据库就是Adempiere.dmp文件），该文件是数据库初始导入文件。若没有找到，则将该目录下默认有的ExpDat.dmp更名为相应的*.dmp文件。然后找到RUN_ImportAdempiere (.bat or .sh).文件并运行，最后会出现如下界面：相关说明：若是postgresql数据库，最终是显示revoke revoke grant grant，和说明文档中的不同，但也应没有关系。C）启动服务器参考：/index.php/InstallComplete。操作步骤：先找到安装目录下的RUN_Server2运行（我的机子里是在C:ADempiereutils下面），以启动服务器，待运行后出现以下界面 即为启动ok。相关说明：启动时，会提示有些ERROR，但也似不影响结果；D）在客户端中访问访问地址：http:/主机名: 8080/admin/ 比如我的机子就是http:/sdxx-3710n-fyr:8080/admin/相关说明：注意，若第A）步配置服务器地址时填入的是计算机名，则此时访问也必须写成计算机地址。写成localhost或是都不行。因此，建议配置服务器地址时，填为.相关的帮助文档为：/index.php/Launching_the_ADempiere_Application。2、安装Adempiere的补丁及汉化包A）补丁安装Adempiere的补丁很多，例如，360LTS就有自己的补丁；Libero HR&Payroll模块也有自己的补丁。Adempiere的所有补丁包都可以在这里下到：/projects/adempiere/files/Adempiere%20Packages//projects/adempiere/files/ADempiere%20Patches/并且点击进入相应的页面，就有相应的说明，告诉如何进行补丁。这里就以HR的补丁安装为例进行说明。其他的类似。参考：HR模块的更新：/index.php/Sponsored_Development:_Libero_HR_%26_PayrollCosting Engine的更新：/projects/adempiere/files/Adempiere%20Packages/Libero%20Costing%20Engine/Smart Browser的更新：/projects/adempiere/files/Adempiere%20Packages/Libero%20Smart%20Browser/Warehouse Management的更新：/projects/adempiere/files/Adempiere%20Packages/Libero%20Warehouse%20Management/生产制造模块的更新：/projects/adempiere/files/Adempiere%20Packages/Libero%20Manufacturing/操作步骤：1）先打开postgreSQL或者pl/sql developer，运行HR_migration_script中的5个脚本2）通过命令行或者文件系统，进入Adempiere安装目录。3）把liberoHR.jar文件复制到 C:ADempierepackagesliberoHRlib文件夹下面。4）把liberozkHR.jar文件复制到C:ADempierezkpackagesliberoHRlib文件夹下面。若没有该文件夹，自己先建立文件夹。5）把patches.jar文件复制到C:ADempierelib文件夹下面。注意，由于不同的模块都有自己的patch，并且都命名为patches.jar，因此，需要先用winRAR、jar等工具，将它们合并成一个patches.jar，再复制到该文件夹下面。具体做法是：用winRAR解压各个patches.jar，并将它们合并。假设合并后的顶级文件夹org位于c:temp下，则通过命令行进行c:temp，然后运行“jar cvf patches.jar C . .”，表示把当前目录下的所有内容（即org文件夹）加入patches.jar中。6）运行RUN_setup.sh或者RUN_silentsetup.sh，重新部署adempiere到jboss上。7）以SuperUser的身份登录，密码System。System Admin - General Rules - Security - Role Access Update然后退出 以GardenAdmin身份登录。密码GardenAdmin。再执行一遍System Admin - General Rules - Security - Role Access Update即可。B）汉化注意，必须先打补丁，再汉化。否则可能出现一些问题。安装汉化包的方法请参见：/index.php/Language_Pack_Installation3、使用AdempiereA）登录/index.php/Logging_In_to_the_Client。具体步骤：访问上面的网址http:/主机名: 8080/admin/，显示如下：点击右上角的，接下来会出现登陆对话框，如图所示：先点击第一行，即主机所对应的那行，图中红色显示部分，弹出连机的窗口：点击测试应用服务器和测试数据库按钮进行测试（有可能出现这样的情况：应用服务器连接失败，而数据库连接成功，这种情况不会有问题，不会影响后续操作），即如下图所示也可：点击绿勾，连机对话框中红色部分会变为白色，即如图所示：再点击绿勾，出现：点击绿勾，进入软件界面即可：B）具体使用/index.php/Finding_Your_Way_Around。C）Fields和Buttons的介绍/index.php/Entering_Data_-_Fields_and_Buttons。D）总目录/index.php/Table_of_Contents。包含了业务功能介绍、系统管理员介绍、开发者指南等内容。E）帮助文档中搜索：/index.php/Special:Search。F）开发最佳实践：/index.php/ADempiere_Best_Practices。G）Manual：/index.php/Manual。可看到哪一项功能所对应的代码、表、处理过程是哪些H）Manuals：算是手册的汇总，但很多内容目前都不全，需待wiki进一步补充/index.php/Functional_User_Manual#Purchase_Processes。I）/index.php/How_to_Activate_Document_Approval_Workflow讲述了如何在一个已有的Requisition工作流中增加一个Approval节点的功能。其中提到的“2.Go to Workflow”位于Menu-System Admin-General Rules-Workflow目录中的workflow。而/index.php/ManPageW_Workflow讲述了如何创建一个全新的workflow，其实与上面的例子是类似的。J）FAQ的URL：/index.php/FAQ_AccountingK) 中文帮助1：/index.php/Chinese；点其中的案例02-ADempiere生产制造模块团队学习，进到/index.php/ZH/Case-Study-02，里面有制造模块的相关资源，包括：1、/index.php/A_Step_by_Step_Guide_to_Libero_Manufacturing2、UserManualPartC-en_Manufacture.pdf3、/index.php/Sponsored_Development:_Libero_Manufacturing_Work_Shop#Product_2中文帮助2：/index.php/ZH/List_StartL) 中文语言包的安装：/index.php/Language_Pack_InstallationM）adempiere的基础功能是进销存，libero为adempiere增加了HR、cost、manufactur