Configuring IDE from a clean Eclipse

We recommend using our OpenKM Portable Development IDE rather than configuring your own.

You can also use IntelliJ IDEA or other development Java tools like NetBeans.

Requirements

Software:

  • Eclipse
  • OpenJDK 11

Your eclipse must have support for:

  • Maven
  • Subversion ( recommended )

Hardware:

Suggested minimum hardware configuration:

  • 2 CPU's
  • 4GB of ram
  • 64 bits architecture

Download eclipse

We suggest downloading the latest stable version of Eclipse. Eclipse comes in several versions, you should download the "Eclipse IDE for Java EE Developers" for your computer architecture ( 64 bits ).

More information at https://eclipse.org/downloads/.

Configure Java

You must have Java installed on your server otherwise go to https://learn.microsoft.com/en-us/java/openjdk/download and download the latest OpenJDK 11 version according to your OS and hardware architecture. Execute the Java installer and follow the installation wizard.

Go to Window / Preferences / Java / Installed JRE. You must have OpenJDK 11 defined here:  

Configure tomcat server

Go to "servers" tab. Click on right click mouse button and from the contextual menu choose "Add / server". From the list choose "Tomcat 7 server":

Configure a new Run time server environment:

Choose the "Workbench default JRE" when your default JRE is "OpenJDK 11" or choose "OpenJDK 11" from JRE list of installed JREs.

Check box Use Tomcat installation ( takes control of tomcat installation ).

Increment start and stop timeouts ( for example to 180 and 120 seconds respectively ).

 

Edit launch configuration: Add memory parameters - we suggest 4GB - and utf-8 file encoding at VM arguments field:

-Xms1024m -Xmx4096m -Djava.awt.headless=true -Dfile.encoding=utf-8

Add your OpenKM project at source tab:

Add CATALINA_PID at environment variables:

CATALINA_PID=$CATALINA_HOME/catalina.pid

or

CATALINA_PID=$CATALINA_HOME/catalina.pid

Maven support for Eclipse

The Eclipse version comes by default with maven support plugins yet installed.