Difference between revisions of "ADempiere Virtual Appliance Install"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(AVA Notes)
(Added link to hint about ovf import failure)
 
(23 intermediate revisions by 8 users not shown)
Line 1: Line 1:
==Playtime==
+
[[Image:Ava.gif|500px|right|Your Machine is ready!]]
*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 [http://sourceforge.net/project/showfiles.php?group_id=176962&package_id=249213 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 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:
+
  
#Just learn by doing and ask questions on Adempiere irc (techie way)
+
==Playtime==
#Buy Compiere User Documentation from http://www.compiere.com for USD$50 (paid way)
+
* Read the AVA Documentation [[Media:AVA.pdf]]. (Please read the manual first)
#Use the work in progress [[Idalica/End User Work Procedures|User documentation]] and enhance it while you are discovering new things (the bazaar way)
+
* 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 [http://webchat.freenode.net/?channels=adempiere Adempiere IRC]
 +
* Use the work in progress [[Idalica/End User Work Procedures|User documentation]] and enhance it while you are discovering new things (the bazaar way)
  
 
==AVA Notes==  
 
==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 [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master SourceForge]
  
''Don't worry if you don't understand these:''
+
The AVA contains an agent (/root/ava_agent) that will keep your ADempiere Virtual Appliance always updated with the
 +
latest ADempiere Trunk release.
  
*Root user password is "bazaar"
+
* Use the ava353a_OVF10.ovf for adapting to other VM players such as VirtualBox.
*adempiere user password is "bazaar"
+
* Download alternate bigger zipped 436Mb from [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.zip?use_mirror=master SourceForge]
*Default user (Adempiere) has sudo rights.
+
* Your virtual machine becomes an automatic server and your client desktops can use the Web UI and Java Client instantly!
*Adempiere/Jboss is managed by /etc/init.d/adempiere (start/stop) script
+
* The Virtual Appliance contains a small, but powerfull image running CentOS 5.3 with the software needed to compile and run ADempiere.
*Adempiere Server Monitor user: SuperUser/System
+
* 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 adempierehost.com.
  
==Latest Version==
 
* August trunk's 353a.7z only 310Mb by Paul Aviles. Download now from [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master SourceForge]
 
The August Trunk release contains an agent (/root/ava_agent) that will keep your ADempiere Virtual Appliance always updated with the
 
latest Trunk, Libero and Migration scripts.
 
*Use the ava353a_OVF10.ovf for adapting to other VM players such as VirtualBox.
 
*Alternate bigger zipped 436Mb from http://www.nickelnetworks.com/downloads/ava353a.zip
 
*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.<br>
 
 
'''*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.'''
 
'''*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==
+
==VMware Player Installation Notes ==
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.
+
* Download and install VMware Player-2.5.2-156735.exe from [http://www.vmware.com/download/player]
 
+
* Download and read the [http://downloads.sourceforge.net/sourceforge/adempiere/AVA.pdf?use_mirror=master AVA.pdf] manual.
[http://www.virtualbox.org 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).
+
* Download and expand the AVA files [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master 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
 +
   
  
==Installation under VirtualBox==
+
*Note: ADempiere v 3.5.4a Alpha Release CentOS 5.3+PG uses 353a trunk and upgrades to 354a with all migration scripts. [http://www.nickelnetworks.com/erp/ava_index.php]
  
* Download VirtualBox. Recommended to use the latest version (version 3.0.2). Download [http://www.virtualbox.org/wiki/Downloads here]
+
==VirtualBox Installation Notes==
* Download Paul Aviles new AVA [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master here]
+
* Download VirtualBox. Recommended to use the latest version (version 3.0.6). Download [http://www.virtualbox.org/wiki/Downloads here]
 +
* Download new AVA [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master here]
 
* Unzip the AVA. Take note of the file location.
 
* Unzip the AVA. Take note of the file location.
 
* Download the OVF File Format [https://sourceforge.net/projects/adempiere/files/AVA%20-%20Virtual%20Appliances%20%20/ava353a_OVF10.ovf/download here] and put it in the '''same folder with your AVA file'''
 
* Download the OVF File Format [https://sourceforge.net/projects/adempiere/files/AVA%20-%20Virtual%20Appliances%20%20/ava353a_OVF10.ovf/download here] and put it in the '''same folder with your AVA file'''
Line 53: Line 59:
 
* Just maintain the default setup and click "OK"
 
* Just maintain the default setup and click "OK"
 
* Sit back and enjoy the installation.
 
* Sit back and enjoy the installation.
 +
 +
===In case the OVF import fails===
 +
* see here: [[ADempiere_Virtual_Appliance#In_case_the_ovf_file_does_not_work]]
 +
 +
==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.
 +
 +
[http://www.virtualbox.org 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==
 
==Usefull Links==
 +
* Read the AVA Manual [[Media:AVA.pdf]]
 
* [http://www.vmware.com/products/player/ Download VMware Player]
 
* [http://www.vmware.com/products/player/ Download VMware Player]
 
* [http://www.vmware.com/products/free_virtualization.html Download VMware Server]
 
* [http://www.vmware.com/products/free_virtualization.html Download VMware Server]
 
* [http://www.virtualbox.org/wiki/Downloads Download VirtualBox]
 
* [http://www.virtualbox.org/wiki/Downloads Download VirtualBox]
 
* [http://sourceforge.net/forum/forum.php?thread_id=1616344&forum_id=610546 A relevant thread in Sourceforge to help you with troubleshooting]
 
* [http://sourceforge.net/forum/forum.php?thread_id=1616344&forum_id=610546 A relevant thread in Sourceforge to help you with troubleshooting]
 +
* [[Activating AVA upgrades]]
 
* [http://en.wikipedia.org/wiki/Open_Virtualization_Format Open Virtualization Format (OVF)]
 
* [http://en.wikipedia.org/wiki/Open_Virtualization_Format Open Virtualization Format (OVF)]
  
 
==Contributors==
 
==Contributors==
*[[User:Kontro|Timo Kontro]] contributed the first AVA.
+
*[[User:Wariola|Wariola]] VirtualBox OVF Guide.
*[[User:Fer_luck|Fer_luck]] contributed the 315 version
+
 
 
*[[User:Red1|Red1]] does some upgrades when he learnt [[Howto Create AVA]].  
 
*[[User:Red1|Red1]] does some upgrades when he learnt [[Howto Create AVA]].  
*[[User:Paviles|Paul Aviles]] Virtual Appliance 3.5.3a+
+
*[[User:Fer_luck|Fer_luck]] contributed the 315 version
*[[User:Wariola|Wariola]] VirtualBox OVF Guide. Paul do the rest :)
+
*[[User:Kontro|Timo Kontro]] contributed the first AVA.
 +
 
  
 
[[Category:Developer documentation]]
 
[[Category:Developer documentation]]
 
[[Category:ADempiere Virtual Appliance]]
 
[[Category:ADempiere Virtual Appliance]]

Latest revision as of 02:50, 11 July 2011

Your Machine is ready!

Playtime

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

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

Contributors