ADempiere Virtual Appliance Install

From ADempiere
Revision as of 02:50, 11 July 2011 by TheRab (Talk) (Added link to hint about ovf import failure)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
Your Machine is ready!


  • Read the AVA Documentation Media:AVA.pdf. (Please read the manual first)
  • Read the Release Note at that download section.
  • Look in the "Useful Links" section below for the latest AVA release.
  • Just learn by doing and asking questions on the Adempiere IRC
  • Use the work in progress User documentation and enhance it while you are discovering new things (the bazaar way)

AVA Notes

  • root user password is "bazaar"
  • adempiere user password is "bazaar"
  • The adempiere user has sudo rights.
  • Adempiere/Jboss is managed by /etc/init.d/adempiere (start/stop/status) script
  • Adempiere Server Monitor user: SuperUser/System
  • Upon boot the AVA sends and email with the IP address location of the server for usage tracking reference purposes only
  • Latest trunk release is only 310Mb. Download now from SourceForge
The AVA contains an agent (/root/ava_agent) that will keep your ADempiere Virtual Appliance always updated with the 
latest ADempiere Trunk release. 
  • Use the ava353a_OVF10.ovf for adapting to other VM players such as VirtualBox.
  • Download alternate bigger zipped 436Mb from SourceForge
  • Your virtual machine becomes an automatic server and your client desktops can use the Web UI and Java Client instantly!
  • The Virtual Appliance contains a small, but powerfull image running CentOS 5.3 with the software needed to compile and run ADempiere.
  • The Virtual Appliance does not contain X Windows or VNC as it was designed to run ADempiere as a service for both Java and HTML clients so that you can run the ADempiere client from a remote desktop computer using either a Web Browser or the Java client.
  • If you use the Java client you must have a DNS entry pointing to the IP address of the Virtual Appliance with the host name of

*If you downloaded the AVA before 07/15/2009 make sure that you login as root and update the time on the server by doing # date -s "07/14/2009 12:48:00" for example. Match your current date and time or the server will not post transactions correctly. The August release fixes this issue.

VMware Player Installation Notes

  • Download and install VMware Player-2.5.2-156735.exe from [1]
  • Download and read the AVA.pdf manual.
  • Download and expand the AVA files SourceForge on the computer running VMware Player.
  • Launch VMware Player and open the AVATrunk.vmx image file. This will start the virtual machine.
  • To proceed, accept the license agreement which will be shown inside the virtual machine.
  • The initialization script will continue, ending with an information screen which shows, among other things, the server's IP address.
  • Connect using ssh to the AVA server at the IP address indicated. (Username: root, Password: bazaar)
  • As root, execute "/root/ava_agent install", wait for ADempiere to be installed.
  • As root, execute "/root/ava_agent update" to get the latest andeya script.
  • Upgrade to the lasted trunk release by typing "/root/ava_agent upgrade".
  • Start the ADempiere server by running "service adempiere start". From then on ADempiere will start automatically on every boot.
  • Now follow the instructions on the information screen in the Virtual Machine:
   * Create a host entry in the client computer as indicated
  • Note: ADempiere v 3.5.4a Alpha Release CentOS 5.3+PG uses 353a trunk and upgrades to 354a with all migration scripts. [2]

VirtualBox Installation Notes

  • Download VirtualBox. Recommended to use the latest version (version 3.0.6). Download here
  • Download new AVA here
  • Unzip the AVA. Take note of the file location.
  • Download the OVF File Format here and put it in the same folder with your AVA file
  • OVF is just an xml to point the Virtual Appliance resource e.g. hard disk, network etc to maintain interop between different virtual machine technology. More info regarding OVF here
  • Open your VirtualBox
  • Go to file > Import Appliance
  • Import your ava353a_OVF10.ovf file
  • Click "Agree" on the subsequent screen
  • Just maintain the default setup and click "OK"
  • Sit back and enjoy the installation.

In case the OVF import fails

Running on VirtualBox

The Open Source alternative to run AVA is to use VirtualBox. This is made possible due to the open format of Virtual Machine using the OVF standards.

VirtualBox is a powerful x86 virtualization product for enterprise as well as home use. Not only is VirtualBox an extremely feature rich, high performance product for enterprise customers, it is also the only professional solution that is freely available as Open Source Software under the terms of the GNU General Public License (GPL).

Usefull Links