Difference between revisions of "Windows Installer"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(tidying up)
(Updating links and information. Adding windows 32bit installer.)
 
(43 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
[[Category:Projects and Tools]]
 
[[Category:Projects and Tools]]
 
[[Category:HowTo]]
 
[[Category:HowTo]]
[[Category:Installation]]{{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 [[User:Red1|Redhuan D. Oon]]. For a developer's guide please go to the [[Talk:Windows_Installer|talk page]]}}
+
[[Category:Installation]]
Contributed by [http://www.schaeffer-ag.de Kai Schaeffer], based on [http://nsis.sourceforge.net/Main_Page 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=
+
[https://bintray.com/artifact/download/mckayerp/ADempiere-444-Window-Install-Test/alpha/Adempiere_380LTS_2_win_x64.exe Windows x64 Installer Download]
*Download [http://sourceforge.net/projects/adempiere/files/WindowsInstaller/ here].
+
*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'''.
+
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:Installer1.gif]]
+
  
=Just Click Next=
+
[https://bintray.com/artifact/download/mckayerp/ADempiere-444-Window-Install-Test/alpha/Adempiere_380LTS_2_win_x32.exe Windows x32 Installer Download]
[[Image:Installer2.gif]]
+
[[Image:Installer3.gif]]
+
*Use a simple directory path that has no embedded spaces. Such as D:/ instead of C:/Programs Files/
+
[[Image:Installer4.gif]]
+
*Try to use a common password for a start to avoid pesky confusion. I would put in 'adempiere' for now.
+
[[Image:Installer5.gif]]
+
[[Image:Installer6.gif]]
+
[[Image:Installer7.gif]]
+
[[Image:Installer8.gif]]
+
[[Image:Installer9.gif]]
+
[[Image:Installer10.gif]]
+
  
=Uninstalling=
+
{{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]].}}
*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=
+
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.
*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|400px|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.
+
[[Image:Dos run setup.png|thumb|400px|FIG 2- Running Setup from DOS prompt]]
+
**D:/Adempiere/RUN_setup.bat FIG 3 will appear.
+
**Put localhost as your Database Server name
+
[[Image:RUN Setup.PNG|thumb|400px|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|400px|FIG 4 - Click on the Server connection icon]]
+
[[Image:Testconnection.PNG|thumb|400px|FIG 5 - Try some settings and then Test]]
+
  
=How To Upgrade To Latest Version=
+
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.
*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=
+
The installer does the following tasks for you:
*Then you have to not run ImportAdempiere.bat but just run all the migration scripts since the last version.
+
* 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
  
=How To Keep Updating to latest from Trunk=
+
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.
*You run all the migration scripts from last release
+
 
*You compile the latest trunk source and replace the newly compiled binary at <ADempiere-Home>
+
== Installation Options ==
*RUN_silentsetup.bat again
+
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 [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.
 +
 
 +
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.

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.