Revision as of 02:17, 6 January 2011

⇐ Table of Contents{{#if: Getting Started| | Getting Started }}{{#if: | | [[{{{3}}}]] }}{{#if: | | [[{{{4}}}]] }}{{#if: | | [[{{{5}}}]] }} | Windows Installer{{#if: Launching the ADempiere Application| | Launching the ADempiere Application }} ⇒

Note: The installer is upgraded for version 3.6.0LTS and Trunk latest updated revision 14653 applied So it is brand new for New Year 2011. It is presently maintained by Redhuan D. Oon. For a developer's guide please go to the talk page

Contributed by Kai Schaeffer, based on NSIS. He has even put the source to create the installer in the SVN! Find it there under this path:

contributions/WindowsInstaller/src/ 

• This installer runs under MS Windows platform and will install everything you need:
  • Java JDK
  • Postgres Database
  • ADempiere
  • Import the database dump
  • Create the environment and home settings

All you need to do after this is just to double-click on the application icon and it runs!

Download Installer

• Download here.
• 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.

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

Just Click Next

• Use a simple directory path that has no embedded spaces. Such as D:/ instead of C:/Programs Files/

• Try to use a common password for a start to avoid pesky confusion. I would put in 'adempiere' for now.

Uninstalling

• If you wish to uninstall due to some fault, you can do so from the Control Panel and select 'Remove Programs'.
• Uninstall only removes the ADempiere binary and its folders and contents but do not remove Java nor Postgres.

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

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.

FIG 2- Running Setup from DOS prompt

• • 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 you have to 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