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.*

PostgresSQL

JDK Installation

Download link: http://java.sun.com/javase/downloads/index_jdk5.jsp

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.

Select the link and it will download the file to the system.

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.

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.

Above window will open. Here setup will install selected JDK components.

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.

Setup will open the above window, here user will select the desired options and will press next button.

On this step setup will install the selected JRE components.

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

When user will run the PostgreSQL setup above window will open. User will press next button.

When user will select next button above installation Directory window will open. Here user will simply select next button.

After installation directory window system will open data directory window to specify the directory structure for postgresql data.

Now user will enter “postgres” as the password for database super user and service account.

Now user will enter the port number which will be used by the postgresql in our case it will be '5432'.

Now on the “Locale” user make no changes and will select next button.

Now setup is ready to start, simply select next button to install postgresql.

Installation started.

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

Before moving further you have to set the environment variables.

Setting Environment Variables

Right click on 'My Computer' and select properties.

System will open above window, here user will select ‘Advanced’ tab and will select ‘Environment Variables button.

When user will select environment variable button, 'Environment Variables' form will open. Now user will select new button in the 'System variables'

group box.

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.

Add new JRE_HOME variable and enter the value 'C:\Program Files\Java\jre1.5.0_17' as shown in above window.

Add new JAVA_HOME variable and enter the value 'C:\Program Files\Java\jdk1.5.0_17' as shown in above window.

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.

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.

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.

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.

http://www.adempiere.com/File:Server_conf.PNG

System will open the above window for server configuration.

http://www.adempiere.com/File:Server_conf2.PNG

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.

http://www.adempiere.com/File:Server_conf3.PNG

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.

http://www.adempiere.com/File:Server_conf5.PNG

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.

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.

When user run adempiere client first time, license agreement window will open, Read and select ‘Yes, I Understand and accept’ button.

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.

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.

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.

http://www.adempiere.com/File:Home.PNG

Now system will open the AdempiereERP application home page as shown above.

http://www.adempiere.com/File:Main_menu.PNG

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.

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.

http://www.adempiere.com/File:Web_admin.PNG

Then select the Adempiere ZK webUI link.

Enter the default user ID “SuperUser” and password “System” and click the button.

Select your role, client and organization and click OK button.

http://www.adempiere.com/File:Web_home.PNG

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!

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

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)

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

Screen 1 - 360Trunk/SUPER1S Welcome message

Screen 2 - Agreement on where to get warranty. Click on 'I Agree'

Screen 3 - Setting locations to save. Click 'Next'

Screen 4 - Starting Java install. Listen to music

Screen 5 - Now trying to install PostgreSQL

Screen 6 - PostgreSQL DB Install window opens. If it fails, it will rollback

Screen 7 - Now trying to build ADempiere

Screen 8 - Build ending. The only installer that works over 700%

Screen 9 - Restoring the Database from ExpDat.dmp

Screen 10 - Completed. The music ends

Uninstalling

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)

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

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.

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

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.