ADempiere Virtual Appliance Install

From ADempiere
Revision as of 12:00, 25 September 2009 by Paviles (Talk) (Latest Version)

Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
Your Machine is ready!

Playtime

  • After you have installed one of VMware's products download the AVA package. You can find the AVA packages distributed as zip files on the AVA download page at SourceForge.
  • They are now usually split into 7z files for best download times due to its very big size (1.5g reduced to 310Mb)
  • Read the Ava Documentation Media:AVA.pdf. (You must read the manual first)
  • Read the Release Note at that download section.
  • Look in the "Useful Links" section below for the latest AVA release.

  • Once you have extracted that package to your harddrive you will find that there is a file with the .vmx extension. In windows and some Linuxes just doubleclick it. *Another way is to open VMplayer (there should be menu entry made by installer) and open that .vmx file using VMplayer's user interface. In VMplayer you only have to wait while AVA boots up (Nice blue boot splash screen should appear on the screen). If you are using VMware server you have to click that big green arrow on toolbar to boot up.

  • After some time you should get desktop with ADempiere and browser logo. ADempiere logo opens up ADempiere UI and browser gets you on ADempiere server's default page. If you are totally new with ADempiere and Compiere, but wish to learn ADempiere you have some options:
  1. Just learn by doing and ask questions on Adempiere irc (techie way)
  2. Buy Compiere User Documentation from http://www.compiere.com for USD$50 (paid way)
  3. Use the work in progress User documentation and enhance it while you are discovering new things (the bazaar way)

AVA Notes

Don't worry if you don't understand these:

  • Root user password is "bazaar"
  • adempiere user password is "bazaar"
  • Default user (Adempiere) has sudo rights.
  • Adempiere/Jboss is managed by /etc/init.d/adempiere (start/stop) 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 Version

  • August trunk's 353a.7z only 310Mb by Paul Aviles. Download now from SourceForge - Starting with the 353a release and using the ava_agent utility you will automatically get the latest 354a trunk release.
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.
  • Alternate bigger zipped 436Mb from [1]
  • Watch this flash tutorial http://www.nickelnetworks.com/Virtual
  • Your virtual machine becomes an automatic server and your client desktops can use the Web UI and Java Client right away! All thanks to Paul Aviles from Weston, Florida, USA.
  • This Virtual Appliance contains a small image running CentOS 5.3 with the resources needed to compile and run ADempiere from a client computer.
  • The image 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 adempierehost.com.

*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.

Running on VirtualBox

The other 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).

Installation under VirtualBox

  • Download VirtualBox. Recommended to use the latest version (version 3.0.2). Download here
  • Download Paul Aviles 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.

Usefull Links

Contributors