Wikiadmin: /* Create the Tomcat Server */

2018-10-22T09:43:17Z

‎Create the Tomcat Server

Wikiadmin: /* Create the Tomcat Server */

2018-10-22T09:41:33Z

‎Create the Tomcat Server

Wikiadmin: /* Create the Tomcat Server */

2018-10-22T09:40:35Z

‎Create the Tomcat Server

Wikiadmin: Created page with "{{Languages|How_to_setup_Eclipse_IDE}} == Preparing development environment == First of all you need to install and configure different components of the Openbravo ERP envir..."

2018-10-14T13:13:24Z

Created page with "{{Languages|How_to_setup_Eclipse_IDE}} == Preparing development environment == First of all you need to install and configure different components of the Openbravo ERP envir..."

New page

{{Languages|How_to_setup_Eclipse_IDE}}

== Preparing development environment ==

First of all you need to install and configure different components of the Openbravo ERP environment as it's described in [[Installation/Custom | Custom Installation]] guide. In order to comply to development requirements some of those components have to be additionally adjusted according to [[Development_Stack_Setup|Development Stack Setup]].
{{(!)|'''Double check''' that you have read and followed the [[Development_Stack_Setup|Development Stack Setup]] article}}

After completing all of the steps in the aforementioned guides, please make sure that:
* Your OS user has read/write access to your tomcat installation home directory (CATALINA_BASE).
* Environment variables (e.g. ANT_OPTS, CATALINA_OPTS, JAVA_HOME, ANT_OPTS, etc) are declared in the proper categories (i.e. System/User variables) (windows only)
* You have downloaded the [http://www.eclipse.org/downloads/eclipse-packages/ latest '''Eclipse IDE for Java EE Developers''' release ].

== Download source code ==

The source code can be checked out using any '''Mercurial''' client. There is no any restrictions on the read access so you wouldn't need any credentials to access the repository. The detailed procedure of the source code check out is described in [http://wiki.openbravo.com/wiki/Mercurial_Manual_for_Openbravo_Developers Mercurial Manual for Openbravo Developers]. As it's explained in the guide it's normally considered as a good practice to have a ''pristine'' clone and ''working'' one, so we would strongly encourage you to follow that 'rule'. It is also highly advisable to clone the repository into a destination directory which is outside of Eclipse workspace.

If you want to build the latest stable release:

<currentversion type="link"><pre>$ hg clone https://code.openbravo.com/erp/devel/main openbravo
$ cd openbravo
$ hg up #version#</pre></currentversion>

For Openbravo developers, you should work with the '''pi''' repository:
<source lang="bash">hg clone https://code.openbravo.com/erp/devel/pi
$ cd pi
</source>

== 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 console application which has to be compile first. For that, go to the directory with the working clone of the repository and execute:
<source lang="bash">ant setup</source>
The invocation of this ant target will compile and execute automatically a console application.By going through the console application provide all requested information and at the end, select <code>Accept</code> to apply the changes and close the application.

'''Note:''' More about setup ant task can be found at [[Openbravo.properties#Edition]].

As a result of these actions a new file <code>Openbravo.properties</code>, containing specified settings, will be created in config subdirectory.

{{(!)| While going through the console application, DO NOT change the ''default context name'' which is openbravo. This guide assumes that it will be left this way. }}

More about the properties can be found at [[Openbravo.properties]]. Now the Openbravo ERP is ready to be installed.

=== Install from sources ===
In order to install the Openbravo ERP three main procedures have to be accomplished:
* the Openbravo ERP database has to be created and populated with some initial values
* sources have to be generated
* all sources have to compiled to binaries which later can be executed on a WEB server (Tomcat).
All this is done by invoking from the root of the working clone (XXX\opensource\openbravo\erp\devel\main\).
<pre>ant install.source</pre>

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 <code>BUILD SUCCESSFUL</code> message at the end of the file. (if you are under Linux use <code>grep</code> command to check whether the file contains any exceptions). After successful installation the next step can be taken - importing to Eclipse IDE.
{{(!)|You can save the install.source log using [http://en.wikipedia.org/wiki/Tee_%28command%29 tee] in Linux or [http://www.commandline.co.uk/mtee/ mtee] in Windows}}

=== Problems running install.source ===
If you find problems running install.source, check the [[Installation/Troubleshooting]] article

== 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'' and then ''General''=>''Existing Projects into Workspace''). Here they are:
<pre>
openbravo XXX\opensource\openbravo\erp\devel\main\
OpenbravoCore XXX\opensource\openbravo\erp\devel\main\src-core
OpenbravoTrl XXX\opensource\openbravo\erp\devel\main\src-trl
OpenbravoWAD XXX\opensource\openbravo\erp\devel\main\src-wad
</pre>

== Create the Tomcat Server ==
Then open ''Servers'' view and create a new instance of Tomcat server:

[[Image:Tomcat.server.JPG|center|300px]]

While going through the wizard select <code>openbravo</code> and add it to <code>configured</code> 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:

[[Image:Tomcat.server.2.JPG|center|500px]]

* Check the flag "Serve modules without publishing".
* In the modules tab edit openbravo module and uncheck the "Auto reloading enabled" flag.

=== Change VM arguments settings ===
* in '''General Information'''
** click on '''Open launch configuration''' link
** switch to '''Arguments''' tab
** add the following line at the end of '''VM arguments''' input:
<pre> -server -Djava.awt.headless=true -Xms384M -Xmx1536M -XX:MaxPermSize=256M </pre>
* 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 (press Ctrl+S).

=== Renaming server ===
When creating a new server, by default is is named "Tomcat v7.0 Server at localhost". This name can be changed to something custom, both at creation time or later by editing it in server window.

In this case, it is necessary to bind the Server Library with the actual server. To do so:

* In Project Explorer view, right click on openbravo project and select Properties.
* Select Java Build Path left menu item.
* Select Libraries tab, there you should see Server library is marked as unbound.
* Click Edit button.
* Select your server.

[[Image:Eclipse_bind_tomcat.png|center|500px]]

== Import Preferences ==
The next step is to set the standard preferences used in the development of Openbravo.

* The preference file is located in the openbravo/config/eclipse folder in the development project
* Import workspace preferences clicking on ''File > Import'', then select ''General > Preferences'' and click on ''Next'' button.

[[Image:ImportPreferences1.jpg|center|300px]]

* Browse to openbravo/config/eclipse/openbravo-eclipse-prefs.epf file, select Import all radio button and click on '''Finish''' button.

[[Image:ImportPreferences2.jpg|center|300px]]

Once finished, select all the projects, refresh them, and rebuild them (right click on one or more projects and you will find the Refresh and the Rebuild options). You should get warnings, but not errors.

{{(!)|Latest Eclipse releases starting from ''Mars'' do different Java formatting than previous ones. In order to maintain the same formatting, it is necessary to install old formatter as plugin. Read [http://eclipse-n-mati.blogspot.com.es/2015/06/eclipse-mars-how-to-switch-back-to.html here] more details on how to do it.}}

== 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/ 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 installation is over and you're ready to start developing.

{{(!) | If your system has enough resources (memory/processor) then you can try enabling the ''Build Automatically'' option in the ''Project'' menu. Enabling it will give you direct feedback while developing.}}

[[Category:HowTo]]

== Upgrading old workspaces to >=PR17Q1 ==

Starting from [[Release_Notes/3.0PR17Q1|PR17Q1]], the minimum [[System Requirements]] for Openbravo were increased to Java 7 and Tomcat 7. For worskpaces created in older versions, some upgrade might be required.

* JDK >=7 and Tomcat >= 7 need to be installed in the system
* Eclipse must be at least in [https://en.wikipedia.org/wiki/Eclipse_(software)#Releases Indigo release], though latest version is recommended

Once updated to a newer version on a recent stack, it will be automatically allowed to write Java 7 compliant code.

If Tomcat 6 was used, the server needs to be removed and a new Tomcat >=7 needs to be created, after it, a rebuild will be required, see [[#Create_the_Tomcat_Server|how here]].

{{(warn!)|If you are developing modules compatible with older Openbravo versions or creating code to be backported to those, the code needs to be still compatible with Java 6. In these cases it is recommended to use workspace with older (previous to 3.0PR17Q1) Openbravo sources.}}

== Upgrading old workspaces to >=PR18Q4 ==

Starting from [[Release_Notes/3.0PR18Q4|PR18Q4]], the minimum [[System Requirements|JDK]] required for Openbravo was increased to Java 8. For worskpaces created in older versions, some upgrade might be required.

* JDK >=8 need to be installed in the system
* Eclipse must be at least in [https://en.wikipedia.org/wiki/Eclipse_(software)#Releases Luna release], though latest version is recommended

Once updated to a newer version on a recent stack, it will be automatically allowed to write Java 8 compliant code.

{{(warn!)|If you are developing modules compatible with older Openbravo versions or creating code to be backported to those, the code needs to be still compatible with Java 7. In these cases it is recommended to use workspace with older (previous to 3.0PR18Q4) Openbravo sources.}}

@@ Line 74: / Line 74: @@
 Then open ''Servers'' view and create a new instance of Tomcat server:
-[[Image:Tomcat-server.png|center|300px]]
+[[File:Tomcat-server.png|center|300px]]
 While going through the wizard select <code>openbravo</code> and add it to <code>configured</code> resources. Then click "Finish".

@@ Line 79: / Line 79: @@
 The created instance should appear in the view. Double click on it to change its settings in the form depicted on the picture below:
-[[Image:Tomcat.server.2.JPG|center|500px]]
+[[File:Tomcat.server.2.png|center|500px]]
 * Check the flag "Serve modules without publishing".

How to setup Eclipse IDE - Revision history

Wikiadmin: /* Create the Tomcat Server */

Wikiadmin: /* Create the Tomcat Server */

Wikiadmin: /* Create the Tomcat Server */

Wikiadmin: Created page with "{{Languages|How_to_setup_Eclipse_IDE}} == Preparing development environment == First of all you need to install and configure different components of the Openbravo ERP envir..."