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.