adempiere installation
DESCRIPTION
Instalação de ADempiereTRANSCRIPT
![Page 1: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/1.jpg)
ADempiere InstallationContents
[hide]
1 AdempiereERP, JDK and PostgreSQL Step by Step Installation Guide for Windows
2 JDK Installation
3 PostgreSQL Installation
4 ADempiereERP Installation
5 Importing Database
6 Running ADempiereERP as Desktop Application
7 Running ADempiereERP as Web Application
8 See Also
AdempiereERP, JDK and PostgreSQL Step by Step Installation Guide for Windows
contributed by VOSS Com (Virtual University (of Pakistan) Open Source Software Community)
AdempiereERP and its pre-requisites complete installation from Trunk (SVN) (in ppt format)
VOSS Com AdempiereERP installation guide is a complete, comprehensive and sequential installation guide of AdempiereERP and its pre-requisites for
Windows platform. The unique and prominent feature of this installation guide is that it has information to install all components or prerequisites of
AdempiereERP in a single file.
Pre-Requisites
JDK 1.5.*
![Page 2: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/2.jpg)
PostgresSQL
JDK Installation
Download link: http://java.sun.com/javase/downloads/index_jdk5.jsp
![Page 3: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/3.jpg)
Select available version of JDK 5.0 (e.g JDK 5.0 update 17) and click the Download button as displayed above.
Select the above options and click “Continue” button.
![Page 4: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/4.jpg)
Select the link and it will download the file to the system.
![Page 5: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/5.jpg)
When you will run JDK setup above license agreement window will open. Read and select “I accept the terms in the license agreement” and press
next button.
![Page 6: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/6.jpg)
When user will select the next button after accepting the license agreement above ‘Custom Setup’ window will open where user can select different
component which he wants to install, here user will simply press next button.
![Page 7: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/7.jpg)
Above window will open. Here setup will install selected JDK components.
![Page 8: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/8.jpg)
After installing the selected JDK components system will open above window where user can select JRE components which user wants to install. In
our case user will simply select next button.
![Page 9: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/9.jpg)
Setup will open the above window, here user will select the desired options and will press next button.
![Page 10: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/10.jpg)
On this step setup will install the selected JRE components.
![Page 11: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/11.jpg)
After installing the selected JRE components, above setup completion dialog will open. User will press the ‘Finish’ button.
PostgreSQL Installation
Download link: http://downloads.enterprisedb.com/postgresql/postgresql-8.3.7-1-windows.exe
![Page 12: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/12.jpg)
When user will run the PostgreSQL setup above window will open. User will press next button.
![Page 13: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/13.jpg)
When user will select next button above installation Directory window will open. Here user will simply select next button.
![Page 14: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/14.jpg)
After installation directory window system will open data directory window to specify the directory structure for postgresql data.
![Page 15: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/15.jpg)
Now user will enter “postgres” as the password for database super user and service account.
![Page 16: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/16.jpg)
Now user will enter the port number which will be used by the postgresql in our case it will be '5432'.
![Page 17: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/17.jpg)
Now on the “Locale” user make no changes and will select next button.
![Page 18: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/18.jpg)
Now setup is ready to start, simply select next button to install postgresql.
![Page 20: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/20.jpg)
On completion of installation system will open the above window. Here user will simply uncheck “Launch Stack Builder at exit?” checkbox and select
Finish button.
ADempiereERP Installation
Download link: http://adempiere.svn.sourceforge.net/svnroot/adempiere/trunk
![Page 21: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/21.jpg)
Before moving further you have to set the environment variables.
Setting Environment Variables
Right click on 'My Computer' and select properties.
![Page 22: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/22.jpg)
System will open above window, here user will select ‘Advanced’ tab and will select ‘Environment Variables button.
![Page 23: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/23.jpg)
When user will select environment variable button, 'Environment Variables' form will open. Now user will select new button in the 'System variables'
group box.
![Page 24: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/24.jpg)
Add new CLASSPATH variable and update the value '.;C:\Program Files\Java\jdk1.5.0_17\lib;C:\Program Files\Java\jdk1. 5.0_17\jre\lib' as
shown in above window.
![Page 25: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/25.jpg)
Add new JRE_HOME variable and enter the value 'C:\Program Files\Java\jre1.5.0_17' as shown in above window.
![Page 26: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/26.jpg)
Add new JAVA_HOME variable and enter the value 'C:\Program Files\Java\jdk1.5.0_17' as shown in above window.
![Page 27: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/27.jpg)
Edit 'Path' variable and enter the value at the end of the string ';C:\Program Files\Java\jdk1.5.0_17\bin;c:\Program Files\PostgreSQL\8.3\bin' as
shown in above window.
![Page 28: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/28.jpg)
After setting up environment variables user will start postgreSQL service from Start>Programs>PostgreSQL>Start service. Now user will run the
script/file 'RUN_build.bat' fromAdempiere/utils_dev/RUN_build.bat. This process will create installer files in the Adempiere/adempiere folder.
Now run the build script Adempiere/utils_dev/RUN_build.bat. Console window will open and show the build process activities.
![Page 29: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/29.jpg)
When the system will complete the build process it will terminate the console automatically or prompt (press any key to continue) and following files
will be added to the Adempiere/install directory.
Adempiere.tar.gz – gzipped tar for linux installation Adempiere.tar.gz.MD5 – md5 checksum for the gzipped tar file Adempiere.zip – zipped file for windows installation Adempiere.zip.MD5 – md5 checksum for the zipped file.
You can use gzipped, tar or zipped file in any environment by using the appropriate decompressing tool.
![Page 30: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/30.jpg)
Now Uncompress Adempiere.tar.gz or Adempiere.zip to your directory for example 'C:\' and run the C:\Adempiere\RUN_Setup.bat to setup the
Adempiere application server.
When run the setup script the above console window will open to show the server installation progress.
The following server setup window will open for server configuration.
![Page 32: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/32.jpg)
System will open the above window for server configuration.
![Page 34: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/34.jpg)
Here enter 'localhost' in the 'Database Server' field, select 'postgresql' in the 'Database Type' field and enter 'postgres' in 'DB Admin Password' field
and press test button.
![Page 36: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/36.jpg)
When user will select save button after entering server configurations details in the 'Adempiere Server Setup' setup will open 'Key Store Dialog'
window user may just select 'OK' button or will enter the desired details in this window.
Now system will open 'License' window, user will select 'Yes', I understand and accept’ button after reading the details in the window.
![Page 38: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/38.jpg)
When user will accept license system will open 'Adempiere Server Setup' message box indicating that the server setup is completed. User will simply
select ok button.
When user will select ok button of the 'Adempiere Server Setup' message box setup will close the 'Adempiere Server Setup' window and above Install
adempiere Server console window will show the progress.
Importing Database
The next step is importing the data to PostgreSQL database.
User will run 'C:\Adempiere\utils\RUN_ImportAdempiere.bat' to import initial adempiere database schema into the database.
![Page 39: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/39.jpg)
When database schema will fully transferred to the postgresSQL DB, system will show the message 'press any key to continue...' in the console
window.
The Installation of the ADempiereERP is completed.
Running ADempiereERP as Desktop Application
After Completing the Installation successfully, a shortcut icon is placed on the desktop. To run the desktop application double click that icon.
![Page 40: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/40.jpg)
When user run adempiere client first time, license agreement window will open, Read and select ‘Yes, I Understand and accept’ button.
![Page 41: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/41.jpg)
When user will accept the license above window will open. Now user will select 'PostgreSQL' in the 'Database Type' field and enter localhost in the
'Database Host' field and left the remaining field as they are and click 'Test Database'. If connection is successful then select 'ok' button.
![Page 42: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/42.jpg)
When user will select ok button system will open the above 'Adempiere Login' window, here user will enter UserID 'GardenAdmin' and Password
'GardenAdmin' and select 'ok' button.
![Page 43: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/43.jpg)
When user will select ok button of the 'Adempiere Login' window, system will open the above window where user will simply select the Role and other
information and click 'Ok' button.
![Page 45: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/45.jpg)
Now system will open the AdempiereERP application home page as shown above.
![Page 47: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/47.jpg)
Now to view the menu items user will select the 'Menu' tab of the AdempiereERP application window.
Running ADempiereERP as Web Application
Firstly run ADempiere server C:\Adempiere\utils\RUN_Server2.bat.
When user will run adempier server system will open the above window.
![Page 48: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/48.jpg)
When server is started system will show the time taken to start server. Now user can run ADempiereERP web application.
To run the Adempiere as a web application type http://RO4/admin in your browser. At the place of 'RO4' use your own computer name.
![Page 49: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/49.jpg)
![Page 51: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/51.jpg)
Then select the Adempiere ZK webUI link.
Enter the default user ID “SuperUser” and password “System” and click the button.
![Page 52: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/52.jpg)
Select your role, client and organization and click OK button.
![Page 53: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/53.jpg)
![Page 55: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/55.jpg)
Above is the Home page of the project and through left side menu user can perform all kind of tasks.
Windows Installer
⇐ Table of Contents | Getting Started | Windows Installer | Launching the ADempiere Application ⇒Note:
Latest version 361Aug installer contributed by Redhuan D. Oon/Kai Schaeffer based on CarlosRuiz's stable 361 with Fixed Assets, Maintenance and JavaPOS included. End-user guide
to Cozy for Japanese guide. There is also a Developer's page.
Microsoft Windows installer now makes it even easier to setup ADempiere. Get it installed within 15 minutes!
![Page 56: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/56.jpg)
Fig.i Download ADempiereInstaller1111.zip
This installer runs under MS Windows platform and will install everything you need:
Java JDK (version 1.6.0.130)
Postgres Database (version 8.3)
ADempiere (release 360Trunk/SUPER1s)
Setup ADempiere's environment and home settings
Import the latest migrated from CarlosRuiz's maintained version of August 15th 2011 database dump
Includes latest upgraded Fixed Assets, Maintenance, and JavaPOS.
All you need to do after this is just to double-click on the application icon and it runs!
Contents
[hide]
1 Download Installer
2 Just click Next and listen to the music
3 Uninstalling
![Page 57: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/57.jpg)
4 Troubleshooting
o 4.1 Run Setup
o 4.2 Connection Test
5 How To Upgrade To Latest Version
6 How Not To Overwrite Your Previous Version
7 How To Keep Updating to latest from Trunk
8 Upgrade
Download Installer
Fig.ii Right click to Run as administrator
Download the latest tested ADempiereInstaller1111.zip from here. (Fig.i)
Its size is 270Mb. Full execution on a Windows PC may take as fast as 15 minutes.
Related Sourceforge forum thread.
NOTE: When executing the installer, ensure you have UAC (User Account Control - needed in Vista) off and Run as administrator. (Fig.ii)
![Page 58: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/58.jpg)
This installer has been tested many times to work quite easily. If you should hit an error, just Windows Uninstall the option concerned, ensure clean delete
of old files and run the installer again.
Opening screen
Verification that File is not broken
Select your language
Just click Next and listen to the music
![Page 59: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/59.jpg)
Screen 1 - 360Trunk/SUPER1S Welcome message
Screen 2 - Agreement on where to get warranty. Click on 'I Agree'
![Page 60: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/60.jpg)
Screen 3 - Setting locations to save. Click 'Next'
Screen 4 - Starting Java install. Listen to music
![Page 61: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/61.jpg)
Screen 5 - Now trying to install PostgreSQL
Screen 6 - PostgreSQL DB Install window opens. If it fails, it will rollback
![Page 62: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/62.jpg)
Screen 7 - Now trying to build ADempiere
Screen 8 - Build ending. The only installer that works over 700%
![Page 63: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/63.jpg)
Screen 9 - Restoring the Database from ExpDat.dmp
Screen 10 - Completed. The music ends
Uninstalling
![Page 64: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/64.jpg)
Now you have succesfully installed everything as you can see on the screen below. From here you can do uninstall when needed.
Control Panel shows what you have installed which is Java 6.0.13, Postgres 8.3 and ADempiere
If you wish to uninstall due to some fault, you can do so from the Control Panel and select 'Uninstall Programs'.
Uninstall in the ADempiere_Home folder only removes the ADempiere binary and its folders and contents but do not remove Java nor Postgres.
You have to delete the folder of the packages you uninstalled to ensure it is cleanly removed. Otherwise a reinstall won't guarantee to work.
Troubleshooting
If ADempiere cannot launch at all.
Go to the DOS prompt and cd to your adempiere_home to launch adempiere. I.e. D:/Adempiere/RUN_Adempiere.bat
Note the prompt lines to tell you what are the errors for your further action. (see FiG 1)
![Page 65: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/65.jpg)
FIG 1 - Going to DOS prompt to run ADempiere
FIG 2- Running Setup from DOS prompt
Run Setup
One way is to RUN_setup again to make sure all the settings are right. You can run this many times and it does not disrupt your database. See FIG 2.
D:/Adempiere/RUN_setup.bat FIG 3 will appear.
Put localhost as your Database Server name
![Page 66: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/66.jpg)
FIG 3 - Setup Settings window
Click on TEST and on success click on SAVE.
Connection Test
If it launches but cannot connect to database.
Click on the Server connection icon. See FIG 4.
Select Postgres as database
Put localhost as your Database Server name.
Put 'adempiere' (or what you gave above) as password
Press the Test Database button only. All these refers to FIG 5.
If it turns green then only go to the Application Server.
![Page 67: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/67.jpg)
FIG 4 - Click on the Server connection icon
FIG 5 - Try some settings and then Test
How To Upgrade To Latest Version
With ADempiere you can easily do that.
First you have to download the latest binary with data dump
Then you go and replace the binary in your home directory, and place the Adempiere.dmp in /data folder.
Then go to and run <ADempiere-Home>/RUN_Setup.bat or better still RUN_silentsetup.bat.
Then execute <ADempiere-Home>/utils/RUN_ImportAdempiere.bat
![Page 68: ADempiere Installation](https://reader035.vdocuments.site/reader035/viewer/2022081511/563dbb88550346aa9aadfd6c/html5/thumbnails/68.jpg)
How Not To Overwrite Your Previous Version
Then do not run ImportAdempiere.bat but just run all the migration scripts since the last version.
How To Keep Updating to latest from Trunk
You run all the migration scripts from last release
You compile the latest trunk source and replace the newly compiled binary at <ADempiere-Home>
RUN_silentsetup.bat again
Upgrade
The installer development has moved to OSGi version.
There a constant new migration scripts upgrade installer is in development to handle any changes without the need to do it manually.