Axelor Open Suite reduces the complexity and improve responsiveness of business processes. Thanks to its modularity, you can start with few features and then activate other modules when needed.

Axelor Open Suite includes the following modules :

• Customer Relationship Management
• Sales management
• Financial and cost management
• Human Resource Management
• Project Management
• Inventory and Supply Chain Management
• Production Management
• Multi-company, multi-currency and multi-lingual

Axelor Open Suite is built on top of Axelor Open Platform

Tools

• Git
• Open JDK8
• Docker
• Eclipse IDE for Enterprise Java and Web Developers
  • Configured to use Open JDK8, so that the Gradle scripts will run
• Apache Tomcat 8.5

To compile and run from source, you will need to clone Axelor Open Suite modules, which is a git submodule repository, using following commands:

$ git clone [email protected]:axelor/open-suite-webapp.git
$ cd open-suite-webapp
$ git checkout master
$ git submodule init
$ git submodule update
$ git submodule foreach git checkout master
$ git submodule foreach git pull origin master

You can find more detailed installation instructions on our documentation.

1. Import the project as an existing gradle project, ensuring that the module metadata is recognised and the dependencies resolved
2. Add a Server using a Tomcat 8.5 installation with Open JDK8
3. Add the project to the server
4. Using the Servers view increase the startup timeout delay by a significant factor (initial startup may take ~10mins) and take note of the modules path e.g /axelor-erp

1. Update the database environment variables in the docker-compose file and/or the application.properties file to match
2. Start the Postgres database using docker-compose up
3. Run the Application on the Server using Eclipse
4. Navigate to http:https://localhost:8080/axelor-erp/ which will render the login page (or alternative path based on the configured modules path)

Notes:

• First start may take ~10mins to bootstrap the DB state
• There may be an NIO Accessor error on startup; seems to not be a problem, let it continue, may not occur on subsequent starts

The application can be run in debug mode using an embedded Tomcat and connected to from Eclipse

1. Run the application using ./gradlew --no-daemon run --debug-jvm which will start the application using an embedded tomcat with JVM in debug mode. Expect to see something like the following logged

> Task :run
Listening for transport dt_socket at address: 5005

2. Use Eclipse as a debugger, connecting it to the running axelor instance

3. Select Run → Debug Configurations….

4. Select Remote Java Applications.

5. Select New launch configuration.

6. Set the following config

Connection Type Standard (Socket Attach)
Host localhost
Port 5005 (or as output by the gradle script)

3. Run the debug config. Expect to see the Debug perspective with the Remote Java Application running. Once Eclipse connects to the application THEN it will continue starting up
4. Set breakpoints in Source in Eclipse
5. Exercise the application at http:https://localhost:8080/axelor-erp/