View source | View content page | Page history | Printable version   

Projects:Openbravo Appliance/Functional Specs

Bulbgraph.png   This is and old project document and is most likely not what you are looking for.
  • For the appliances entry page, go here.



This document contains the functional specifications for the Openbravo Appliance. At the time of writing this document the product is already developed and implemented. So even though it might look crazy to write the design after the product is already on production, the main purpose is to retrofit it from the product itself, so that it is clear what needs to be tested during the QA cycles.

Requirements/ Scope


As someone interested in Openbravo i want to easily try out Openbravo without going through any complicated installation process

TODO: decide if done now or added later: TODO: decide if that should be improved (vdi file or even complete vbox machine definition)


In both cases:

As a system integrator I want install the Professional Appliance for the first time

Depending on the chosen appliance flavor the deployment will be different:

When not using EC2: additionally the SSH access should be reconfigured to only allow public key authentication.

As a system integrator I want to update the operating system stack to the latest version inside the same Ubuntu LTS release

The installation of stack updates needs to be managed by the standard Ubuntu mechanism for this. Documentation needs to be provided by Openbravo to help the user to do this.

As a system integrator I want to update the operating system stack next Ubuntu LTS release (when such is available)

Such an upgrade is only possible when the new LTS release is supported already by Openbravo. If this is not the case the upgrade must not be done as it will very likely break the system.

When the new LTS version is supported by Openbravo specific upgrade instructions will be written which are needed to be followed to ensure a working upgrade.

Alternatively a new system can be installed cleanly with the new LTS version and a Openbravo Appliance backup can be imported to move all th data from the older system.

As a system integrator I want to update Openbravo ERP to the latest version

The ERP is managed by using the Module Management Console (MMC), this is completely isolated from the stack updates.

As a system integrator I want to back up the Openbravo Installation

The appliance includes a backup mechanism that includes the following items:

It is possible to run a backup at any time manually, and also to schedule regular backups on a daily, weekly a monthly basis.

The backup system needs to be configured using the commandline interface.

The backups will always be stored locally. It is possible to select the number of backups to be kept.

The backup systems also support the following mechanisms to support copying the backups additionally to some other location

Documentation will be provided for the advanced admin on how to write such a custom backup sync method.

As a system integrator I want to restore Openbravo ERP from a backup

Restoring Openbravo ERP from a previous backup is possible by calling the openbravo-restore script from the commandline.

As a parameter any of the backup files created by the backup mechanism needs to be provided.

That backup-file needs to be available in any location on the local system.

Retrieving the backup-file from any remote location and placing it in the local system is out of the scope here.

The restore script with stop the current installation, delete all current source-files, attachements & the database. After this it will proceed to restore the ERP from the backup and start the ERP again.

As a system integrator I want to customize the ERP

The ERP customization is out of the scope of the appliance. Starting from version 2.50 the ERP manages the customizations through modules, so this is the methiod that should be used by system integrators.

As a system integrator I want to clone the production system into a testing system

This can be achieves by using the backup mechanism. That is, by installing the appliance in the second system and restoring the backup there.

It should be noted that the backup only contains the ERP and no system configuration, so if needed any configuration of the stack (networking, backup, postgresql configuration) needs to be transferred manually.

As a system integrator I want to securely access the machine through a terminal session

On Amazon EC2: When starting an appliance for the first time in EC2 an ssh public-key can be added to the appliance. After that secure remote access via ssh using the openbravo username is possible.

Using the ISO/vmware images: After a new installatio the system allows remote ssh using the openbravo username and the standard openbravo password. For security reasons this should be directly change in one of the following two ways:

As a system integrator I want to manage public-keys to allow secure access to the machine through a terminal session

First remote access to the system is provided as described in the previous section.

Additional authorized ssh public-keys can be managed using the standard linux mechanism.

That is by editing the /home/openbravo/.ssh/authorized_keys file and by adding 1 new line per authorized key in there.

The folder & file will be existing by default with the correct permissions so that the user does not need to create/adjust this.

As a system integrator I want to install a SSL certificate for Openbravo ERP

Documentation will be provided by Openbravo to aid the user to do the necessary configuration.

As a system integrator I want to access the system and ERP logs

Those log files are present in the usual location of a ubuntu system.

To aid the user in easy access of the typically needed logfiles the folder '/var/log/openbravo' is created and links to the mainly needed logfiles are placed within.

As a system integrator I want to access the database remotely and in a secure manner

No direct database is provided. The system is configued to only allow local acces from the server to the database. So a SSH tunnel should be used to forward the database port from the appliance to the system integrator's machine. So that the system integrator is able to access it as if it was local.

I am a user of the old rPath Appliance and want to migrate to the new Openbravo Appliance

First the usual process of doing any migration should be followed.

The migration should be first done in a test environment and the new system should be thoroughly tested. Only after this is ensured the real migration of the system should be done.

Comparison with the old rPath Appliance

Retrieved from ""

This page has been accessed 3,307 times. This page was last modified on 20 April 2015, at 17:01. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.