Openbravo Installation on Ubuntu Documentation

Documentation for installation of OpenBravo ERP on Ubuntu Step-1 First Download and install Eclipse under sr2 versions. To do that use the link below http://www.eclipse.org/downloads/packages/release/galileo/sr2 Step-2 check whether the server plugin/view is available or not if available go to Step-4 or else you need to install WTP follow the below steps as it is In Eclipse go to help--->Install new software-->click add In name field enter In location field enter the link below save .

: WTP : http://download.eclipse.org/webtools/updates and then

Step-3 Eclipse will search for available softwares then select the latest SDK and web platform tools and wizard will appear select i agree and install it. Then restart eclipse now server view should be there. Step-4 We need to set up environment to do this follow the link below http://wiki.openbravo.com/wiki/ERP/2.50/Openbravo_environment_installation Step-5 we need to setup the development stack to do that we use mercurial follow the link below to do that http://wiki.openbravo.com/wiki/Development_Stack_Setup Don;'t forget to download and keep apache tomcat for Ubuntu and keeping it in $home/servers/tomcat and also mentioning the path in eclipse. Step-6 Openbravo installation The Openbravo ERP installation is performed in several steps. Configure the properties So, first of all you have to configure the Openbravo ERP by specifying some general properties, e.g. Tomcat installation directory, database connection details, etc. This can (and in fact must) be done

via a special GUI application which has to be downloaded first. For that, go to the directory with the working clone of the repository (home/src/openbravo/erp/devel/main) through terminal and execute ant setup Step-7 The invocation of this ant target will download an executable file called setup-propertieslinux.bin in config subdirectory. Move into this subdirectory and launch the executable file to start the GUI configuration application. By going through the wizard pages provide all requested information and click Finish to apply the changes and close the application. As a result of these actions a new file Openbravo.properties, containing specified settings, will be created in config subdirectory. More about the properties can be found at Openbravo properties. Now the Openbravo ERP is ready to be installed. ( note:To run setup-properties-linux.bin in ubuntu go to config directory of main project and excute the command below sudo ./setup-properties-linux.bin ) Step-7 In order to install the Openbravo ERP three main procedures have to be accomplished: a)the Openbravo ERP database has to be created and populated with some initial values. b)sources have to be generated. c)all sources have to compiled to binaries which later can be executed on a WEB server (Tomcat). All this is done by invoking ant install.source from the root of the working clone (home/src/openbravo/erp/devel/main). This process can take quite long time (up to 25 min) depending on hardware configuration. It's always a good idea to redirect the output of the task execution to a log file which then can be analyzed or sent to the support team in case of problems. After the task has completed the log should not contain any error or exception massages as well as it should have BUILD SUCCESSFUL message at the end of the file. (if you are under Linux use grep command to check whether the file contains any exceptions). After successful installation the next step can be taken - importing to Eclipse IDE. Step-8 Import into Eclipse IDE Launch Eclipse. After Eclipse has started go to Project menu and disable Build Automatically option there. Now 4 projects need to be imported in the workspace (by menu File=>Import..., Existing Projects into Workspace). Here they are:

openbravo OpenbravoCore OpenbravoTrl OpenbravoWAD

home/src/openbravo/erp/devel/main/ home/src/openbravo/erp/devel/main/src-core home/src/openbravo/erp/devel/main/src-trl home/src/openbravo/erp/devel/main/src-wad

Step-9 Then open Servers view and create a new instance of Tomcat server:

Step-10 While going through the wizard select openbravo and add it to configured resources. Then click "Finish". The created instance should appear in the view. Double click on it to change its settings in the form depicted on the picture below:

Set : • in General Information • click on Open launch configuration • add the following line at the end of VM arguments -Djava.awt.headless=true -Xms384M -Xmx512M -XX:MaxPermSize=256M

• in Server options • check the Serve modules without publishing • in Timeouts • set start and stop timeouts to 120 seconds After changing all, save your server configuration.

Step-11 The next step is to set the standard preferences used in the development of Openbravo. • Import workspace preferences clicking on File > Import, then select General > Preferences and click on Next button. • The preferences file is located in config/eclipse folder of main project.

• Browse to openbravo-eclipse-prefs.epf file, select Import all radio button and click on Finish button.

Once finished, select all the projects, refresh them, and rebuild them. You should get warnings, but not errors.

Step-12 Launch from Eclipse Now start the Tomcat server by right-clicking on the server instance in the Servers view and choosing Start option in the popup menu. Wait until the server is started (can take up to 2 minutes) and visit http://localhost:8080/openbravo/ in your Internet browser. If everything was configured and installed properly you will get to the Openbravo ERP log in page. Use these credentials to log in: • username - Openbravo • password - openbravo both are case sensitive. That's it, the core installation is over!