Start With ImCMS as a Developer

In this article:

Required things

There are some additional requirements if you want to develop ImCMS:

  • git
  • Maven 3+
  • Your favorite IDE, text editor or even only terminal

Download sources

At first you need to clone ImCMS from github by this link: https://github.com/imCodePartnerAB/imcms.git

Building application

Maven is used as a build tool so run next command from project root after sources downloaded:

mvn clean

Success execution means that all was done right.

Then package it:

mvn clean package

Your first package should fail with this message:

Warning

build.properties file was just created, fill in required properties and run execution again

Open this file (it is located in project root directory) build.properties. Besides a lot of defaults, find this:

db-host = localhost
db-name = imcms
db-user = root
db-pass =

And write down your database host, name, user and password.

It’s not the end! There are a lot of tests that should be executed on maven’s package phase. Test DB is needed for this purposes. Go to src/test/resources/test.server.properties and write down correct values for next properties:

JdbcDriver = com.mysql.jdbc.Driver
JdbcUrl = jdbc:mysql://localhost:3306/imcms_test?characterEncoding=utf8&useSSL=false
User = root
Password = root

Pay attention to JdbcUrl property - there is a DB name after localhost:3306/, by default it is imcms_test, so you can create DB with such name (just like in Before You Start section) or with another name - then simply put this name into test.server.properties file instead of default DB name.

Since you’ve done, execute maven clean package again:

mvn clean package

All tests should be executed successfully, application built and ready to use. Deploy it to Tomcat and run.