Windows Installer

From ADempiere
Revision as of 18:02, 5 January 2011 by Red1 (Talk)

Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
Note.gif 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.

Contributed by Kai Schaeffer, Germany 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.
  • Related Sourceforge forum thread.
  • NOTE: When executing the installer, ensure you have UAC (User Account Control - only applicable in Vista) off and Run As Administrator. See here a web-page to help you [1]. Been tested many times to work quite easily in training class by Red1. If hit error, just Windows Uninstall and reinstall again.
  • Opening screen

Installer1.gif

Just Click Next

Installer2.gif Installer3.gif

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

Installer4.gif

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

Installer5.gif Installer6.gif Installer7.gif Installer8.gif Installer9.gif Installer10.gif

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