Launching platform server locally from the command line

Launching platform server locally from the command line

Command line usage

Open up a terminal/command prompt.

On terminal, move into the mifosng-provider directory and execute ./gradlew clean tomcatRunWar

If all has gone well, the platform should be available at: https://localhost:8443/mifosng-provider/api/v1/offices?tenantIdentifier=default

The server part of application logs to: mifosng-provider\build\tmp\tomcatRunWar\logs\mifos-platform.log

You should be able to log into platform with Username: mifos and Password: password.

For client applications built on top of the platform see:

1. Community UI Application https://github.com/openMF/community-app
2. Individual Lending Client Application https://github.com/openMF/mifosx-community-apps/wiki

Choosing Authentication Mechanism

The Platform uses Basic Authentication by default. For enabling Oauth 2, add the environment variable "-Psecurity=oauth" to the gradle build

Ex:

./gradlew clean tomcatRunWar -Psecurity=oauth

Out Of Memory Error or Perm Gen Error

If you get an OutOfMemory Error, or a Perm Gen Error, then you can increate the JVM memory, and Perm Gen memory settings. In gradle.properties file (inside mifosng-provider folder), make an entry:

org.gradle.jvmargs=-Xms512m -Xmx1024m -XX:MaxPermSize=512m

If Using Different MySQL User/Password than what is configured

Note: When launching the platform from the command line for developement, the user/password used for the database is root/mysql. If your root user password for mysql is different, you should change the password in the file mifosng-provider/src/test/resources/META-INF/context.xml

Also, see MySQL database setup which also requires some actions if using a user/password different to root/mysql.