Installation/Appliance/Launch appliance

Installation

Select virtualization software

Install software

Launch Appliance

Work with Openbravo / Configure appliance

Contents 1 Openbravo Appliance for testing 1.1 Launch VMware appliance 1.2 Launch VirtualBox appliance 2 Openbravo Appliance for production 2.1 Select architecture and download 2.2 Install Openbravo with the ISO 3 Openbravo login and ssh connection 3.1 Configuration of ssh for production machines

Openbravo Appliance for testing

Once VMware or VirtualBox is installed and ready to be used, the next step is to download the Openbravo Appliance. You can do get it from the Openbravo downloads page.

The file will look something like this:

• openbravo-3.0MP23-vmware-i386.zip (Valid for VMWare and VirtualBox)

You can now extract the files somewhere in your machine.

Launch VMware appliance

1. Run VM Player.
2. Click on File -> Open Virtual Machine and select the vmx file you have uncompressed.
3. After boot you can login in the testing appliance

This is a typical image of the appliance while booting:

Launch VirtualBox appliance

1. Run VirtualBox
2. Click on New to open the wizard.
3. Set a name for the virtual machine, for example Openbravo Appliance. Select Linux as the Operating system and and Ubuntu as the Version.
   
4. Next, set at least 1536MB of memory to the virtual machine.
   
5. Afterwards select as the disk the .vmdk file you have previously uncompressed.
   
6. And that's it! You can now finish the wizard. Before we can start the virtual machine there's a network related setting we have to tweak. Select the virtual machine and click on Settings. Then select Network at the left navigation panel and set the Attached to combo box to Bridged Adapter.
   
7. And that's all. You can close the Settings page and Start the virtual machine.
8. After the boot process finish, you can login in Openbravo or connect to the appliance by ssh.

Openbravo Appliance for production

The recommended form of installation for production is using the ISO-image (either 32 or 64 bits) which can be used to install on:

• Physical Machines
• VMware
• Virtualbox
• Others.

The Openbravo Appliance is based on the Ubuntu Server 12.04 LTS (Long Term Support) release, which means that it should work wherever Ubuntu Server does.

Select architecture and download

As a general rule for production the 64 bits architecture should be used. The exception are servers with few RAM (2-4 GB) that optionally can select the 32 bits architecture.

The next step is to download the Openbravo Appliance, you can get it from the Openbravo downloads page.

The file will look something like this, depending on the option you've chosen:

• openbravo-3.0MP23-amd64.iso

NOTE: The ISO image is too big to fit on a standard CD-ROM. If you cannot use the file directly a DVD-ROM maybe required.

Install Openbravo with the ISO

1. Optional: burn the ISO into a DVD-ROM or a USB stick
2. Boot the system using the ISO.
3. At the boot prompt you will be asked to select a language.
4. Optional: Check the CD-ROM for defects, this will check that the ISO was downloaded without errors and the CD-ROM created correctly.
5. Select 'Install Openbravo Appliance'.
6. The installer asks for which language it should use for the to be installed system. Afterwards, you are asked to select your location.
7. Next, the installation process begins by asking for your keyboard layout. You can ask the installer to attempt auto-detecting it, or you can select it manually from a list.
8. The installer then discovers your hardware configuration, and configures the network settings using DHCP. If you do not wish to use DHCP at the next screen choose "Go Back", and you have the option to "Configure the network manually".
9. Next, the installer asks for the system's hostname and Time Zone.
10. You can then choose from several options to configure the hard drive layout. In case of doubt, keep the default options here. For advanced disk options see Advanced Installation.
11. The Ubuntu base system including the Openbravo ERP is then installed.
12. Select where to install grub, In most cases leave the default.

Openbravo login and ssh connection

The following message is displayed at the end of the boot process:

Welcome to Openbravo Appliance

Openbravo URL http://<IP_ADDRESS>
Openbravo login Openbravo/openbravo

Ubuntu login openbravo/openbravo

Ubuntu login:

For access to Openbravo you can point your web browser to http://<IP_ADDRESS>, the default user is 'Openbravo' and default password 'openbravo'.

For connecting by ssh to the appliance follow this guide.

NOTE: The username is Openbravo, with an uppercase O. The password is openbravo, with a lowercase o. The system is case-sensitive, and you need to type both data elements correctly to access it.

NOTE: Have you got "http://" without an IP address? This tutorial assumes there's DHCP in your local network. If there's not see the how to configure an IP manually.

Configuration of ssh for production machines

Access by ssh with user and password is ok if the machine is on a local network or if it is a testing instance. But for production this authentication method is not secure enough.

It is highly recommended that for production servers you reconfigure your server to only allow ssh access with public key authentication.

To do this you need to create a key, then add it to your machine, test that it works and then disable that the password authentication.

Categories: WorkInProgress | Installation