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.
m (VMware Player Installation Notes)
(Added link to hint about ovf import failure)
 
(7 intermediate revisions by 4 users not shown)
Line 15: Line 15:
 
* Adempiere Server Monitor user: SuperUser/System
 
* 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
 
* 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 by Paul Aviles from www.nickelnetworks.com. Download now from [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master SourceForge]
+
* Latest trunk release is only 310Mb. Download now from [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master SourceForge]
  
 
  The AVA contains an agent (/root/ava_agent) that will keep your ADempiere Virtual Appliance always updated with the  
 
  The AVA contains an agent (/root/ava_agent) that will keep your ADempiere Virtual Appliance always updated with the  
Line 22: Line 22:
 
* Use the ava353a_OVF10.ovf for adapting to other VM players such as VirtualBox.
 
* Use the ava353a_OVF10.ovf for adapting to other VM players such as VirtualBox.
 
* Download alternate bigger zipped 436Mb from [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.zip?use_mirror=master SourceForge]
 
* Download alternate bigger zipped 436Mb from [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.zip?use_mirror=master SourceForge]
* 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 instantly!
* Your virtual machine becomes an automatic server and your client desktops can use the Web UI and Java Client instantly! All thanks to Paul Aviles from Weston, Florida, USA.
+
 
* 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 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.  
 
* 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.  
Line 34: Line 33:
 
* Download and read the [http://downloads.sourceforge.net/sourceforge/adempiere/AVA.pdf?use_mirror=master AVA.pdf] manual.
 
* 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.
 
* 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 ava353a.vmx (or AVATrunk.vmx) image file.
+
* Launch VMware Player and open the AVATrunk.vmx image file.  This will start the virtual machine.
* Connect using ssh to the AVA server. (Username: root, Password: bazaar)
+
* To proceed, accept the license agreement which will be shown inside the virtual machine.
* As root, execute "./ava_agent update to get the latest andeya script.
+
* The initialization script will continue, ending with an information screen which shows, among other things, the server's IP address.
* As root, execute "./ava_agent install", wait for ADempiere to be installed.
+
* Connect using ssh to the AVA server at the IP address indicated. (Username: root, Password: bazaar)
* Upgrade to the lasted trunk release by typing "./ava_agent upgrade".
+
* 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.
 
* 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. [http://www.nickelnetworks.com/erp/ava_index.php]
  
 
==VirtualBox Installation Notes==
 
==VirtualBox Installation Notes==
 
* Download VirtualBox. Recommended to use the latest version (version 3.0.6). Download [http://www.virtualbox.org/wiki/Downloads here]
 
* Download VirtualBox. Recommended to use the latest version (version 3.0.6). Download [http://www.virtualbox.org/wiki/Downloads here]
* Download Paul Aviles new AVA [http://downloads.sourceforge.net/sourceforge/adempiere/ava353a.7z?use_mirror=master 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==
 
==Running on VirtualBox==
Line 65: Line 74:
 
* [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:Wariola|Wariola]] VirtualBox OVF Guide. Paul did the rest :)
+
*[[User:Wariola|Wariola]] VirtualBox OVF Guide.
*[[User:Paviles|Paul Aviles]] VMWare Virtual Appliance 3.5.3a+, AVA_AGENT, Trunk Auto Builder
+
 
 
*[[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:Fer_luck|Fer_luck]] contributed the 315 version
 
*[[User:Fer_luck|Fer_luck]] contributed the 315 version

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