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.
(Useful Links)
(Added link to hint about ovf import failure)
 
(37 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 +
[[Image:Ava.gif|500px|right|Your Machine is ready!]]
 +
 
==Playtime==
 
==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 [http://sourceforge.net/project/showfiles.php?group_id=176962&package_id=249213 AVA download page at SourceForge]. 
+
* Read the AVA Documentation [[Media:AVA.pdf]]. (Please read the manual first)
*They are now usually split into 7z files for best download times due to its very big size (1.5g reduced to 533Mb) Read the Release Note at that download section.  
+
* Read the Release Note at that download section.  
*Look in the "Useful Links" section below for the latest AVA release.
+
* 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]
*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.
+
* Use the work in progress [[Idalica/End User Work Procedures|User documentation]] and enhance it while you are discovering new things (the bazaar way)
----
+
*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)
+
#Buy Compiere User Documentation from http://www.compiere.com for USD$50 (paid way)
+
#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!
*Jboss is managed by /etc/init.d/jboss (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.
  
==Useful Links==
+
'''*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.'''
* [http://www.nickelnetworks.com/downloads Download latest] [[AVA]] (Version 353a+).
+
*Directly from the link below as one file (compatible with ESX/ESXi 3.5 and 4.0, vCenter 2.5 and 4.0, Server 1.0.6 and 2.0, Workstation 6.5.1, Player 2.0.4 and 2.5)
+
**http://www.nickelnetworks.com/downloads/ava353a.zip
+
**Watch the Virtual Appliance Tutorial Video http://www.nickelnetworks.com/Virtual
+
  
This Virtual Appliance contains a small 492MB image running CentOS 5.3 with the resources to compile ADempiere and to run it from a client computer. The image does not contain X Windows or VNC as it was designed to run ADempiere inside the Virtual Appliance, and to 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
+
==VMware Player Installation Notes ==
Virtual Appliance with the host name of adempierehost.com.<br>
+
* 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.
 +
* 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
 +
   
  
==Previous Version==
+
*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]
* [http://sourceforge.net/project/showfiles.php?group_id=176962&package_id=249213&release_id=630773 Download latest] [[AVA]] (Version 352a+).
+
*Or directly download all the parts listed below.  
+
**http://downloads.sourceforge.net/adempiere/Readme.zip?use_mirror=
+
**http://downloads.sourceforge.net/adempiere/ava352one.zip?use_mirror=
+
**http://downloads.sourceforge.net/adempiere/ava352two.zip?use_mirror=
+
**http://downloads.sourceforge.net/adempiere/ava352three.zip?use_mirror=
+
**http://downloads.sourceforge.net/adempiere/ava352four.zip?use_mirror=
+
**http://downloads.sourceforge.net/adempiere/ava352five.zip?use_mirror=
+
----
+
  
* [http://www.vmware.com/products/player/ Download the VMware player here]
+
==VirtualBox Installation Notes==
* [http://www.vmware.com/products/free_virtualization.html Download VMware Server 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.
 +
* 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'''
 +
* 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 [http://en.wikipedia.org/wiki/Open_Virtualization_Format 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===
 +
* 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==
 +
* Read the AVA Manual [[Media:AVA.pdf]]
 +
* [http://www.vmware.com/products/player/ Download VMware Player]
 +
* [http://www.vmware.com/products/free_virtualization.html Download VMware Server]
 +
* [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)]
  
 
==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: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