Versions Compared

Old Version 2

changes.mady.by.user Sangamesh Nadagoudar

Saved on

compared with

New Version Current

changes.mady.by.user Mulyowa Joet

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Prerequisite Software's   

 Note:- Below are mandatory prerequisite softwares with mentioned versions only

  • JAVA DEVELOPMENT KIT >> VERSION 1.8.0_65 & above                                
  • MYSQL SERVER >> Version 5.5 or 5.6
  • GITHUB 


Panel

On this page:

Table of Contents
maxLevel3
minLevel3
printablefalse



  •  

    Install Java 

1) Before beginning, uninstall any existing versions of Java currently on your computer. 

2) In your web browser, go to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html, to download JAVA 1.8.

3) Oracle requires that you read the license agreement, then click the button labeled Accept License Agreement.
Image Modified

4) Click the link to download with respect to you system architect i.e Windows x86 for 32bit or Windows x64 for 64bit. 

Image Modified

5) Save the Java installation file to your computer

6) Run & install the Java file.


  •  

    Install MySQL  

 

1) In your web browser, go to http://dev.mysql.com/downloads/mysql/5.5.html#downloads.To download MYSQL server 5.5v.

Click on download button with respect to

you

your system architect i.e Windows x86 for 32bit or Windows x64 for 64bit.

Image Modified

2) You can skip this option by clicking the link at the bottom of the page that

says 

says "No thanks, just start my download".  

&

Click on

the

Save file to your system.

 Image Modified                                                                                                                               

 3) Run the MySQL installation file. Click on Typical button and click on Next button. 

 Image Modified

4) During MySQL installation, use Advanced Configuration > Show Advanced Options

&

and set the MySQL ROOT Password to mysql. Then click on Save button.So your

user name

username will be root and password will be mysql. 

Image Modified


  •  

Install Tomcat

1) In your web browser, go to http://tomcat.apache.org/download-70.cgi to download tomcat 7. 

 >> Under the section Binary Distributions>>Core, click on the link 32-bit windows zip or 64-bit windows zip( with respect to your system architect) to download.

Image Removed 

2) Extract apache-tomcat-7.0.68.zip:- 

                   

Image Removed

  4) Folder: apache-tomcat-7.0.68, gets extracted:-      

 

Image Removed

5) Copy & Paste apache-tomcat-7.0.68 folder to c:\(drive) then Rename it to tomcat 

Image Removed

  • Create Environment Variables 

1) Open your Environment Variables:
Start Menu > Control Panel > System and Security > System > Advanced System Settings >Environment Variables.

Image Modified

2) Create JAVA_HOME variable:
  • Click on the New button, under the User Variables section.
  • For Variable Name, enter JAVA_HOME
  • For Variable Value,Provide the Java path for example:-C:\Program Files\Java\jdk1.8.0_66
    NOTE: 
    i - If you are running 32-bit Windows, then the path would be ex:- C:\Program Files (x86)\Java\jdk1.8.0_66
    ii - Java jdk path "jdk1.8.0_66" will be with respect to the installed version and it may not be the same as mentioned in the above example.  
    Image Modified
  • Click the OK button.
3) Edit PATH variable:
  • In the System Variables section, scroll down to and select the Path variable.
  • Click the Edit button just below.
    Image Modified
  • Click your mouse cursor into Variable Value box. 
    Using your keyboard's right-arrow or End key, move all the way to the far right of the current text in Variable Value.
  • Add the following text onto the end of the existing Variable Value text: 
    - For Java path example:- ;C:\Program Files\Java\jdk1.8.0_66\bin 
    - For Mysql server path example:- ;C:\Program Files\MySQL\MySQL Server 5.5\bin

    NOTE: 
    i - There must be exactly one semi-colon between whatever is already in your PATH variable, and the new C:\Program Files\Java\jdk1.8.0_66\bin – don't add a semi-colon if your previous PATH already ended with a semi-colon.
    ii - Java jdk path "jdk1.8.0_66" will be with respect to the installed version and it may not be the same as mentioned in the above example. 

    Image Modified
  • Click the OK button  

4) Create JAVA_OPTS variable: 

  • a. Click the New... button again, under the User Variables section.
  • b. For Variable Name, enter JAVA_OPTS
  • c. For Variable Value, example -Xms512m -Xmx1024m 
    Note: Variable value example can be changed with respect to the system memory size for example: -Xms512m -Xmx1024m 

Image Modified


  •  

    Download

Fineract 

  • Fineract-platform

1) Create new directory ex: fineract 

Image Modified

 


2) Open git bash, through git bash  

>> Go inside the created folder(ex-fineract) then execute, this will download platform code:-   

git clone https://github.com/apache/incubator-fineract.git

Image Modified

 


Wait for download completion and move to next step once it's done.

3) Go to, incubator-fineract>>fineract-provider

then execute below command

gradle clean dist

Image Modified

 once successful move to next step

 4) Go to incubator-fineract\fineract-provider\build\distributions>>then unzip fineract-platform

Image Modified


  •  Initialize MySQL data 

1) Download HEIDISQL from:- http://www.heidisql.com/download.php

 & Save

and save the installation file to your computer.

Image Modified

2) Run the Heidisql installation file & setup Heidisql: 

i) For local - Provide mysql password as mysql. 

ii) Click on Save button.

iii) Click on open button. 

Image Modified                                                                                                                           

4) Copy the following database command and paste it into the large white box titled Query 
create database `mifosplatform-tenants`; create database `mifostenant-default`; use `mifosplatform-tenants`;

Image Modified


5) Click on Run button to Execute the query. . 

 
Image Modified

6) On heidisql, click on File>>Load SQL file..

Image Modified

7) Through Load SQL file window,

  • Navigate to the location where you extracted the Mifos application files.
  • Navigate to the database folder, inside that location. (Ex:- fineract>>incubator-fineract>>fineract-db)
  • Select the file mifospltaform-tenants-first-time-install.sql and click Open.

Run the first-time-install script, by clicking Run Query button

&

and once

its

it's successful close heidisql application.


  •  

Tomcat

  • Download community-

Setup

  • app

1)

Setting up Lib folder

a) Download drizzle jdbc 1.3 jar file from http://www.drizzle.org/content/download

b) Once it's downloaded copy & paste it to libfolder, Go to Tomcat>>lib folder. 

Note: If tomcat-jdbc.jar file is not available in the tomcat>>lib folder then you could download and paste it from:http://www.java2s.com/Code/JarDownload/tomcat-jdbc/tomcat-jdbc.jar.zip

2) Generate keystore

 Generate a new keystore using java keytool :

>> Open command prompt 
>> Go to the path where your JAVA>>bin folder is located. 
>> Run this command to generate the key: keytool -genkey -alias tomcat -keyalg RSA
>> Then provide the password. 
For example: 
Image Removed
Provide input and type in y for the last question to confirm. 
Image Removed
Note: Once the keystore is created, it should be placed in your home directory. For Example:C:/Users/john/.keystore

3) Configure server.xml page,

a) Go to  tomcat>>conf>>open server.xml with notepad:

Image Removed

b) Delete everything in it and copy-paste the following right side entire content of the page code:
c) Once content is pasted in server.xml,Below mentioned are to be modified with respect to your system & settings:
i - Key store path should be modified with your key store path location Example:- keystoreFile="C:/Users/john/.keystore"
ii - Key store password (which was provided while creating the key), should be modified Example:- keystorePass="xyz123"
iii - MYSQL credentials should be modified
Example:- username="root" & password="mysql"                                                                                                     

<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml"
/>

<Resource type="javax.sql.DataSource"
name="jdbc/mifosplatform-tenants"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
driverClassName="org.drizzle.jdbc.DrizzleDriver" 
url="jdbc:mysql:thin://localhost:3306/mifosplatform-tenants"
username="root"
password="mysql"
initialSize="3"
maxActive="10"
maxIdle="6"
minIdle="3"
validationQuery="SELECT 1"
testOnBorrow="true"
testOnReturn="true"
testWhileIdle="true"
timeBetweenEvictionRunsMillis="30000"
minEvictableIdleTimeMillis="60000"
logAbandoned="true"
suspectTimeout="60"
/>
</GlobalNamingResources>

<Service name="Catalina">

<Connector protocol="org.apache.coyote.http11.Http11Protocol"
port="8443" maxThreads="200" scheme="https"
secure="true" SSLEnabled="true"
keystoreFile="C:/Users/john/.keystore"
keystorePass="xyz123"
clientAuth="false" sslProtocol="TLS"
URIEncoding="UTF-8"
compression="force"
compressableMimeType="text/html,text/xml,text/plain,text/javascript,text/css"/>

<Engine name="Catalina" defaultHost="localhost">

<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
</Realm>

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".log"
pattern="%h %l %u %t &quot;%r&quot; %s %b" />
</Host>
</Engine>
</Service>
</Server>

 

4) Save modified server.xml page

Press Ctrl + S or File>Save. 

 5) Close Notepad. 

  •  

    Drop Fineract into Tomcat folder

1) fineract-provider.war to tomcat>>webapps folder

 Copy "fineract-provider.war" file from unziped folder, C:\fineract\incubator-fineract\fineract-provider\build\distributions\fineractplatform-16.01.2.RELEASE

        Image Removed

  

2) Paste it to tomcat\webapps folder

 Image Removed                

  •  

    Start Fineract-platform

1) Go to "C:\tomcat\bin" folder, Run "startup.bat" by clicking it.

    Image Removed

Note: You can create a shortcut  of "startup.bat" on your desktop and rename it as start mifosx.  

2) Application gets started

 Image Removed

3) Once server starts, will display as "Server startup in xxxxx ms"

   Image Removed

4) Open below mentioned url in internet broswer and authenticate(for the first time).

 Open git bash, through git bash  

>> Go inside the created folder(ex-fineract) then execute, this will download community-app:-   

git clone https://github.com/openMF/community-app.git

Image Added

Wait for download completion and move to next step once it's done.

2) Go inside the created community-app folder then execute

npm install -g bower

Image Added 

bower install

Image Added

npm install

Image Added

grunt serve

Image Added

3) Open new git bash, then go inside the folder and execute "fineract>>incubator-fineract>>fineract-provider"
    gradle clean tomcatRunwar
Image Added


  •  

    Start community-app

Once the server gets started, you could access it from Mozilla firefox - internet browser: 
2) Go to fineract folder >>community-app>>app>>and open index.html, this will run in your internet browser. 
ex:- file:///F:/fineract/community-app/app/index.html
3) Now extend below mentioned url infront of index.html line as mentioned below:- 
ex:- file:///F:/fineract/community-app/app/index.html?baseApiUrl=https://localhost:8443/fineract-provider/api/v1?tenantIdentifier=default#/home
Image Added
And for other internet browser apart from firefox, you should run grunt server to access i.e:- 
Through git bash, go to fineract>>community-app
grunt serve 
This will open:- 
replace baseApiUrl like shown below: 
/clients

Image Removed

5) Fineract-platform is ready to be used. You could pass the api requests by following our api documents available in the path: C:\fineract\incubator-fineract\fineract-provider\build\distributions\fineractplatform-16.01.2.RELEASE >> api docs. For info on using rest client refer Using rest client for passing api requests

 

 

 

 

 

 

 

 

Warning
titleKey Error Messages

 

info


For second & future run:-  
Go to fineract>>incubator-fineract
To know the updates done in the latest code:- 
git fetch origin
To get the latest code into your system:- 
git rebase origin/develop 

Then, start server:- 
Go to fineract>>incubator-fineract>>fineract-provider, then execute through gitbash
gradlew clean tomcatRunwar 


Warning
titleKey Error Messages



Info
Below mentioned commands are shown with examples only. 

Create new branch - test1 

git branch test1(new branch name) origin/develop 

Switching to different branch - test2
git checkout test2 
Create branch - test3 and switch to new branch -test3
git checkout -b test3 origin/develop 
To know which branch
git status
To know the information of latest branch 
git fetch upstream/develop 
To download latest code 
git rebase upstream/develop 
To delete the branch
git branch -d test1 
To see the branches available
git branch
Note - 
1) upstream or origin is called as remote, 
2) While creating branch if nothing is specified then it will create as origin. 
3) develop or master are called as branches.

Filter by label (Content by label)
showLabelsfalse
max5
spacesdocs
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "installation" , "through" , "mifos" , "x" , "of" , "github" ) and type = "page" and space = "docs"
labelsInstallation of Mifos X through github