Introduction

A virtual appliance is a minimally 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. For that purpose, these appliances include a sample database client called BigBazaar.

Parallels appliance

VirtualBox appliance

Supported versions: VirtualBox or VirtualBox-OSE.

File name: OpenbravoERP-3.0PR19Q3-x86.virtualbox.zip.

Allocated free space: 2GB.

Allocated swap space: 128MB.

Login into Openbravo ERP

At the end of the boot process, a message appears indicating the IP address you need to launch Openbravo ERP. In your chosen web browser, type that IP address into the address box. The login screen appears.

In the Username box, type Openbravo

In the Password box, type openbravo

Both the username and password are case sensitive.

Linux passwords

root access: passwordless, log in 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.

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

Direct database access

Open the PostgreSQL client (e.g. PgAdmin3), specify the following connection settings and click OK:

Name: OpenbravoERP

Host: appliance-ip-address

Port: 5432

Username: tad

Password: tad

Misc

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

Web Services can be installed by login-in as the openbravo SSH user and running:

$ ant installWebService

The Tomcat manager URL is the following one: http://<ip_address>/manager/html

The Manager username is admin and the password openbravo.

Installation and usage

Common steps

In general, the process of running Openbravo ERP on a virtual appliance are as follows:

Download a virtualization program. See below for specific instructions on VMware, Xen, QEMU, Parallels and VirtualBox.

Download the virtual appliance and open it with the virtualization program.

The following message is shown at the end of the boot process, indicating the URL to access Openbravo ERP with your web browser:

Welcome to Openbravo ERP Community

To login to Openbravo ERP use your web browser to go to http://<IP_ADDRESS>

VMware

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

Download and install VMware Player. There are versions for Microsoft Windows and Linux. VMware Fusion is the Macintosh version.

Download the latest version of the Openbravo VMware image and unpack the files.

Run VMware Player (or VMware Fusion on a Mac).

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 show the URL to access Openbravo ERP from your browser.

If your network does not have DHCP you can either:

Create an internal subnet. Through which you will be able to access the virtual machine. Openbravo ERP cannot access the Internet via an internal subnet.

Specify a fixed IP address and gateway.

To create an internal subnet:

Launch the VMware player.

Change the network adapter options from Bridged to NAT.

Restart the virtual machine.

To set a fixed IP address and gateway:

Log in as root (passwordless)

Type the following commands to set a specific ip IP_ADDRESS and a gateway IP_GATEWAY:

$ /sbin/ifconfig eth0 IP_ADDRESS netmask 255.255.255.0 up

$ /sbin/route add default gw IP_GATEWAY

Finally to make the IP address available to the Internet, assign some DNS servers to it:

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

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

To launch Openbravo ERP, launch your chosen web browser and type 'http://<IP_ADDRESS>' into the address box, where 'IP_ADDRESS' is the IP address you specified in step 2.

Parallels appliance

Open Parallels. Click on Create New Virtual Machine.
Install from "continue Without disc".

Choose "Other Linux" as operating system.

Choose a name for your virtual machine and click on "Customize settings before installation".

Click on the Hardware tab, and the Hard Disk 1 menu. Then in the source field, choose the .hdd file decompressed from OpenbravoERP-3.0PR19Q3-x86.qemu-parallels.gz

Click on OK and let the virtual machine run.

VirtualBox appliance

Decompress OpenbravoERP-3.0PR19Q3-x86.virtualbox.gz, this will result in the OpenbravoERP-3.0PR19Q3-x86.virtualbox.vdi file.

Open VirtualBox and click on Machine -> New. Enter Openbravo ERP Community in the Name and select Linux 2.6 in OS Type. Click on Next.

Select 1024MB of Base Memory Size. Click on Next.

Click on Existing to add the image. Then Add, and browse to select the OpenbravoERP-3.0PR19Q3-x86.virtualbox.vdi file. Click on Select, then on Next and finally in Finish.

In order to use Openbravo ERP it is necessary to access the virtual appliance through the network. There are two options here:

Use VirtualBox version 2.2 or higher, edit the preferences of the virtualmachine you just created and select Bridge in the network settings. This is the recommended method.

Forward (NAT) the http port (80) from the virtual appliance to a random port (8000) in the host machine. This is easier to do than the previous method, and it is recommended for testing. Run the following commands: