Virtual appliances

Introduction

A virtual appliance is a minimalist preinstalled and preconfigured application and operating system, designed to run under VMware, Xen or any other virtualization technology. The Openbravo ERP project provides virtual appliances to simplify the evaluation process. To facilitate the evaluation process, these appliances include a sample database called BigBazaar.

The appliance images are available in the SourceForge download area.

General information

Included software

The appliances include the following software:

• Openbravo ERP 2.35 MP5.
• PostgreSQL 8.2.7.
• Sun JDK 1.5.0_15.
• Apache Ant 1.7.0.
• Apache httpd 2.0.61.
• Apache Tomcat 5.5.26.
• mod_jk 1.2.26.
• OpenSSH 4.9p1 (client and server).

Minimum requirements

VMware appliance

VMWare Player 1.x, 2.x, VMware Server, VMware WorkStation or VMware Fusion.

Xen appliance

Xen 3.0.03 or higher.

Image details

VMware appliance

Allocated free space: 3GB. Allocated RAM memory: 384MB. Allocated swap space: 128MB. Networking: bridged.

Xen appliance

Allocated free space: 3GB. Allocated swap space: 128MB.

Openbravo ERP login information

Enter the IP address indicated at the end of the boot process. To log into Openbravo ERP:

username: Openbravo

password: openbravo

Note that both are case sensitive.

Linux passwords

• root access: passwordless, login as root and set the password with 'passwd'. One cannot ssh as root until this password is set.
• SSH access: username openbravo and password openbravo. This user automatically logins in the /opt/AppsOpenbravo directory.

Note that these passwords are not used to login in Openbravo ERP, but in Linux.

Misc

• The tomcat context is located in /var/lib/tomcat/webapps/openbravo.

Installation

Use VMware Player (freeware) to run pre-built virtual machines on your desktop. To get the Openbravo appliance running, follow these steps:

• Download and install VMware Player. There are versions for Microsoft Windows and Linux. On Macs, VMware Fusion needs to be downloaded and installed.

• Download the latest version of the Openbravo VMware image.

• Unpack the image using tar in Linux or any other unpacker in Windows.

• Run the VMware Player (or VMware Fusion on a Mac) and select the decompressed .vmx file.

• If there is DHCP on your network, no further steps are required. The final boot message within the virtual machine play window will indicate the URL to access Openbravo from your browser:

Welcome to Openbravo ERP Community Appliance, version 2.35 MP5
Enter http://<IP_ADDRESS> into your browser to start using Openbravo ERP

In case there is no DHCP you have two options:

1. Change the networking option within the VMware player to NAT and restart the virtual machine. This will create an internal subnet within your computer through which you will be able to access the virtual machine. Note that this way, Openbravo will not have access to the internet.
2. Or login as root (passwordless) and type the following commands to set a specific ip IP_ADDRESS and a gateway IP_GATEWAY:

commandline$ ifconfig eth0 IP_ADDRESS netmask 255.255.255.0 up
commandline$ route add default gw IP_GATEWAY

Finally to make it available to the internet, assign some DNS servers to it:

commandline$ echo "nameserver IP_DNS1" >> /etc/resolv.conf
commandline$ echo "nameserver IP_DNS2" >> /etc/resolv.conf

Once the IP address is set, open http://<IP_ADDRESS> to access Openbravo ERP in a web browser (see above).

In the login page, enter Openbravo as the user name and openbravo as the password. Note that both the login and the password are case sensitive.

Xen appliance

Xen is an open source and free virtualization software. To get the Openbravo appliance running, follow these steps.

Changelog

Version 2.35 MP5

• Openbravo ERP: upgrade to 2.35 Maintenance Pack 5. Add delay to init script to avoid errors on low memory systems.
• Conary: upgrade to 2.0.16.
• Cyrus-SASL: upgrade to 2.1.21.
• distro-release: update strings to "2.35 MP5".

Version 2.35 MP4

• Openbravo ERP: upgrade to 2.35 Maintenance Pack 4. Create initial database from a dump file with demo data. Include database structure XML files in database directory.
• PostgreSQL: upgrade to 8.2.7. Fix autovacuum issue.
• Apache Tomcat: upgrade to 5.5.26.
• Sun JDK: upgrade to 1.5.0_15.
• Include only apr and apr-util 0.9.x. Apache 2.0.x doesn't support apr 1.2.x and tomcat-native anyway.
• Linux kernel: upgrade to 2.6.24.7.
• Open VMware Tools: upgrade to 2008.05.02_90473.
• Conary: upgrade to 2.0.14.
• OpenSSH: upgrade to 4.9p1.
• distro-release: update strings to "2.35 MP4". Modify welcome message.

Version 2.35 MP1

• Openbravo ERP: upgrade to 2.35 Maintenance Pack 1. Create initial database from XML files.
• PostgreSQL: upgrade to 8.2.6. Enable autovacuum.
• Apache Tomcat: decrease maximum memory allocation to 384MB. Add the tmptomcat hourly cron script to prevent the deletion of /var/tmp/tomcat by tmpwatch.
• distro-release: update strings to "2.35 MP1".
• iptables: accept external PostgreSQL connections, port 5432.
• mod_jk: upgrade to 1.2.26.
• apr: upgrade to 1.2.12.
• apr-util: upgrade to 1.2.12.
• Add lftp.
• Add slocate.
• Add rsync.
• Add two branches to installLabelPath: conary.rpath.com@rpl:1 and addons.rpath.com@rpl:1.
• Linux kernel: upgrade to 2.6.22.16.

Version 2.35

Initial VMware and Xen virtual images:

• Openbravo ERP 2.35.
• Apache Tomcat 5.5.25.
• Apache httpd 2.0.61.
• PostgreSQL 8.2.5.
• Apache Ant 1.7.0.
• Linux kernel: upgrade to 2.6.22.13.
• mod_jk 1.2.23.
• apr 1.2.8.
• apr-util 1.2.8.
• VMware appliance: Open VMware Tools 2007.10.08.

Support

For any questions or doubts about the virtual appliances, post your questions in the Help forum. Or join the #openbravo IRC channel in freenode.

If you think you've found a bug, report it through issues.openbravo.com.