Difference between revisions of "Windows Installer"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(latest installer with enhancements)
(Updating links and information. Adding windows 32bit installer.)
 
(14 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
[[Category:HowTo]]
 
[[Category:HowTo]]
 
[[Category:Installation]]
 
[[Category:Installation]]
{{Note|Latest version 361Aug contributed by [[User:Red1|Redhuan D. Oon]] based on CarlosRuiz's stable 361 with Fixed Assets, Maintenance and JavaPOS included. [http://sourceforge.net/projects/adempiere/files/WindowsInstaller/ADempiereSUPER1s.pdf/download End-user guide] provided. Thanks to [[User:Cozy|Cozy]] for [[Ja/Windows_Installer|Japanese guide]]. There is also a [[Talk:Windows_Installer|Developer's page]]. }}
 
[[Image:Microsoft-logo.png|thumb|right|Microsoft Windows installer now makes it even easier to setup ADempiere. [http://sourceforge.net/projects/adempiere/files/WindowsInstaller/ Get it] installed within 15 minutes!]]
 
  
[[Image:WindowsInstaller_DownloadPage.png|thumb|300px|Fig.i Download ADempiereInstaller1111.zip]]
+
[https://bintray.com/artifact/download/mckayerp/ADempiere-444-Window-Install-Test/alpha/Adempiere_380LTS_2_win_x64.exe Windows x64 Installer Download]
  
* This installer runs under MS Windows platform and will install everything you need:
+
[https://bintray.com/artifact/download/mckayerp/ADempiere-444-Window-Install-Test/alpha/Adempiere_380LTS_2_win_x32.exe Windows x32 Installer Download]
**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 [http://adempiere.svn.sourceforge.net/viewvc/adempiere/branches/Maintenance/doc/FAM.pdf Fixed Assets, Maintenance], and [http://red1.org/aaa/POSTestGuide.pdf JavaPOS].
+
  
All you need to do after this is just to double-click on the application icon and it runs!
+
{{Note|The Windows installer has been updated to version 380LTS update 2. The installer is in English and French only in Alpha. If you would like to volunteer to translate the few lines into another language, please contact [[User:MJMcKay|MJMcKay]].}}
=Download Installer=
+
[[Image:WindowsInstaller_RunAsAdmin.png|thumb|150px|Fig.ii Right click to Run as administrator]]
+
*Download the latest tested ADempiereInstaller1111.zip from [http://sourceforge.net/projects/adempiere/files/WindowsInstaller/ here]. (Fig.i)
+
*Its size is 270Mb. Full execution on a Windows PC may take as fast as 15 minutes.
+
*Related Sourceforge forum [http://sourceforge.net/forum/forum.php?thread_id=2597860&forum_id=610548 thread].
+
*NOTE: When executing the installer, ensure you have [http://www.petri.co.il/disable_uac_in_windows_vista.htm 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
+
[[Image:WindowsInstaller_Verifying.png|thumb|200px|left|Verification that File is not broken]][[Image:WindowsInstaller_SelectLanguage.png|thumb|200px|centre|Select your language]]
+
  
=Just click ''Next'' and listen to the music=
+
The ADempiere windows installer will install and configure ADempiere and all the necessary supporting software so you can run the client software or use the web user interface easily from the shortcuts in the Windows Start menu.
[[Image:WindowsInstaller_Welcome.png|thumb|left|300px|Screen 1 - 360Trunk/SUPER1S Welcome message]]
+
[[Image:WindowsInstaller_Agreement.png|thumb|centre|300px|Screen 2 - Agreement on where to get warranty. Click on 'I Agree']]
+
[[Image:WindowsInstaller_SaveLocation.png|thumb|left|300px|Screen 3 - Setting locations to save. Click 'Next']]
+
[[Image:WindowsInstaller_StartJava.png|thumb|centre|300px|Screen 4 - Starting Java install. Listen to music]]
+
[[Image:WindowsInstaller_InstallingPG.png|thumb|left|300px|Screen 5 - Now trying to install PostgreSQL]]
+
[[Image:WindowsInstaller_dialogPG.png|thumb|centre|300px|Screen 6 - PostgreSQL DB Install window opens. If it fails, it will rollback]]
+
[[Image:WindowsInstaller_BuildAD.png|thumb|left|300px|Screen 7 - Now trying to build ADempiere]]
+
[[Image:WindowsInstaller_BuildEnding.png|thumb|centre|300px|Screen 8 - Build ending. The only installer that works over 700%]]
+
[[Image:WindowsInstaller_ImportDB.png|thumb|left|300px|Screen 9 - Restoring the Database from ExpDat.dmp]]
+
[[Image:WindowsInstaller_CLOSE.png|thumb|centre|300px|Screen 10 - Completed. The music ends]]
+
  
=Uninstalling=
+
The installer is designed to allow potential users of ADempiere to evaluate the software without the fuss of a manual install. The installation is not intended to represent a proper production implementation. Please see [[Installing ADempiere Manually]] for more information on the installation requirements and [[Installation Steps]] for instructions for a multi-server production implementation.
*Now you have succesfully installed everything as you can see on the screen below. From here you can do uninstall when needed.
+
[[Image:WindowsInstaller_ControlPanel.png|thumb|centre|550px|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'.
+
The installer does the following tasks for you:
*Uninstall in the ADempiere_Home folder only removes the ADempiere binary and its folders and contents but do not remove Java nor Postgres.
+
* Checks your system for the necessary software and provides you the opportunity to choose to use existing compatible versions of Java and Postgres if you already have them installed.
*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.
+
* Collects configuration settings to use to setup the software
 +
* Downloads and installs the ADempiere software
 +
* Downloads and installs other supporting software (if required)(Java Development Kit, PosgtreSQL database)
 +
* Sets up the environment and ADempiere
 +
* Imports and migrates the database
  
=Troubleshooting=
+
The ADempiere application server is installed as a Windows service. A few minutes after the installation is completed, the client software or the web UI can be accessed through the shortcuts in the Windows Start Menu. The service is not installed to start automatically after a reboot so you may need to go to the Control Panel, System and Security, Administrative Tools, Services and start the service or configure it to run automatically.
*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)
+
[[Image:Dosprompt.png|thumb|left|300px|FIG 1 - Going to DOS prompt to run ADempiere]]
+
[[Image:Dos run setup.png|thumb|centre|300px|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
+
[[Image:RUN Setup.PNG|thumb|right|300px|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.
+
[[Image:Login.png|thumb|left|300px|FIG 4 - Click on the Server connection icon]]
+
[[Image:Testconnection.PNG|thumb|centre|300px|FIG 5 - Try some settings and then Test]]
+
  
=How To Upgrade To Latest Version=
+
== Installation Options ==
*With ADempiere you can easily do that.
+
In most cases, the default options presented by the installer will work correctly, making the install process simple.
*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=
+
* Installation Directory (Defaults to c:\).  The installation directory can be changed to any other directory as long as there are no spaces in the full path.  The root directory of a drive is preferred.  Adempiere will be added in a folder "Adempiere" in the installation directory (e.g. c:\Adempiere)
*Then you have to not run ImportAdempiere.bat but just run all the migration scripts since the last version.
+
* Setup options: If you already have a version of PostrgreSQL installed, the installer will attempt to use it. You will be presented with some setup options which you may need to configure for your Postgres install:
 +
** PostgreSQL port, system user and password.  These default to 5432, postgres and postgres respectively.  If an existing install of PostgreSQL is being used, these may need to be updated.
 +
** ADempiere password, web port and SSL port.  These default to adempiere, 8080 and 8443 respectively.  These can be changed if the ports are already in use.
  
=How To Keep Updating to latest from Trunk=
+
== Troubleshooting ==
*You run all the migration scripts from last release
+
If you are having issues, please join the [http://www.adempiere.net/web/guest/chat-on-line ADempiere chat] and ask for assistance.  The installer will leave a number of log files in the installation directory (C:\Adempiere) which may be of help.
*You compile the latest trunk source and replace the newly compiled binary at <ADempiere-Home>
+
*RUN_silentsetup.bat again
+
  
=Guestbook=
+
Common problems include:
Show your appreciation below. Register above, then click on the <nowiki>[edit]</nowiki> button on the right of this topic. At the bottom, below the rest, type your remarks and sign your name by typing 3 tiddles : <nowiki>~~~</nowiki> and it will automatically sign your name there. For example : <br>
+
* Existing installations of JAVA or PostgreSQL that are configured differently than expected.  Either uninstall these applications or proceed with a manual install.
<nowiki>*Good, bon, bien, gut, - ~~~</nowiki>
+
* Ports required by ADempiere are already in use by another system. Different ports should be used in the Options.  Stop the server and delete the adempiere.properties file in the user home directory if it exists.  Rerun the installer and select different ports in the Options page.
 +
* An existing install of the ADempiere server is running
 +
* A file adempiere.properties exists in the user home directory from a previous install using different settings.  This file can be renamed or deleted.

Latest revision as of 14:18, 5 November 2015

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 }} ⇒

Windows x64 Installer Download

Windows x32 Installer Download


Note.gif Note:

The Windows installer has been updated to version 380LTS update 2. The installer is in English and French only in Alpha. If you would like to volunteer to translate the few lines into another language, please contact MJMcKay.

The ADempiere windows installer will install and configure ADempiere and all the necessary supporting software so you can run the client software or use the web user interface easily from the shortcuts in the Windows Start menu.

The installer is designed to allow potential users of ADempiere to evaluate the software without the fuss of a manual install. The installation is not intended to represent a proper production implementation. Please see Installing ADempiere Manually for more information on the installation requirements and Installation Steps for instructions for a multi-server production implementation.

The installer does the following tasks for you:

  • Checks your system for the necessary software and provides you the opportunity to choose to use existing compatible versions of Java and Postgres if you already have them installed.
  • Collects configuration settings to use to setup the software
  • Downloads and installs the ADempiere software
  • Downloads and installs other supporting software (if required)(Java Development Kit, PosgtreSQL database)
  • Sets up the environment and ADempiere
  • Imports and migrates the database

The ADempiere application server is installed as a Windows service. A few minutes after the installation is completed, the client software or the web UI can be accessed through the shortcuts in the Windows Start Menu. The service is not installed to start automatically after a reboot so you may need to go to the Control Panel, System and Security, Administrative Tools, Services and start the service or configure it to run automatically.

Installation Options

In most cases, the default options presented by the installer will work correctly, making the install process simple.

  • Installation Directory (Defaults to c:\). The installation directory can be changed to any other directory as long as there are no spaces in the full path. The root directory of a drive is preferred. Adempiere will be added in a folder "Adempiere" in the installation directory (e.g. c:\Adempiere)
  • Setup options: If you already have a version of PostrgreSQL installed, the installer will attempt to use it. You will be presented with some setup options which you may need to configure for your Postgres install:
    • PostgreSQL port, system user and password. These default to 5432, postgres and postgres respectively. If an existing install of PostgreSQL is being used, these may need to be updated.
    • ADempiere password, web port and SSL port. These default to adempiere, 8080 and 8443 respectively. These can be changed if the ports are already in use.

Troubleshooting

If you are having issues, please join the ADempiere chat and ask for assistance. The installer will leave a number of log files in the installation directory (C:\Adempiere) which may be of help.

Common problems include:

  • Existing installations of JAVA or PostgreSQL that are configured differently than expected. Either uninstall these applications or proceed with a manual install.
  • Ports required by ADempiere are already in use by another system. Different ports should be used in the Options. Stop the server and delete the adempiere.properties file in the user home directory if it exists. Rerun the installer and select different ports in the Options page.
  • An existing install of the ADempiere server is running
  • A file adempiere.properties exists in the user home directory from a previous install using different settings. This file can be renamed or deleted.