Versions Compared

Old Version 177

changes.mady.by.user Karl Horning

Saved on

compared with

New Version 178

changes.mady.by.user Karl Horning

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Small changes for stylistic consistency; small grammatical changes; a couple of changes for sentence clarity


For Video guide - Click on the below link

Widget Connector
width700
urlhttps://www.youtube.com/watch?v=mYVMboSZ9Rs
height200


Panel

On this page:

Table of Contents
maxLevel3
minLevel3
printablefalse



Prerequisite Software   

 NOTE: the software and versions included below are a mandatory prerequisite

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


  •  

    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.

4) Click the link to download the version for your system architecture i.e. Windows x86 for 32bit or Windows x64 for 64bit. 

5) Save the Java installation file to your computer

6) Run and install the Java file.

...

  •  

    Create Environment Variables 

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

2) Create the 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 is: C:\Program Files (x86)\Java\jdk1.8.0_66
    ii - ) Java jdk path "jdk1.8.0_66" may be different on your system as it is dependent on the version you have installedhave installed. 
  • Click the OK button.
3) Edit the PATH variable:
  • In the System Variables section, scroll down to and select the Path variable.
  • Click the Edit button at the bottom of the window.
  • Use your mouse cursor and click inside the 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" may be different on your system as it is dependent on the version you have installed.  

  • Click the OK button  

4) Create the JAVA_OPTS variable: 

  • a. Under the User Variables section, click the New... button again.
  • b. For Variable Name, enter JAVA_OPTS
  • c. For Variable Value, enter the system's memory size, for example: -Xms512m -Xmx1024m

...

  •  

    Download Mifos 

1) Go to http://mifos.org/ from your web browser and navigate to Take Action >> Get Mifos 

2) Click on the "DOWNLOAD IT ON YOUR OWN" link

3) Click on "Download MifosX Now"  


4) Fill out the Mifos Download Form with your information, then click the Next Page button. The download will start automatically.

NOTE: You can skip the form by scrolling to the bottom of the page and clicking on:

No thanks. I would just like to download Mifos without providing additional information.

However, we are able to understand and serve you better if you provide details of your organization.

 

5) You will automatically be redirected to a download page for Mifos on the Sourceforge website. Here you will be prompted to download a ZIP file containing the Mifos application.

NOTE: You can also download other versions directly from:

https://sourceforge.net/projects/mifos/files/Mifos%20X/

 

6) Once you have download the Mifos ZIP file, extract it to a new folder on your computer.  Remember this location, as you will need to refer to it later. 

...

  •  

    Tomcat - Setup

1) Setting up the Lib folder

a) Download the mysql jdbc 5.1.27 jar file from http://central.maven.org/maven2/mysql/mysql-connector-java/5.1.27/mysql-connector-java-5.1.27.jar

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

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

2) Generate keystore

 Generate a new keystore using java the Java keytool :

>> Open command prompt 
>> Go i) Open Command Prompt 
ii) Navigate to the path where your JAVA>>bin folder is located. 
>> iii) Run this command to generate the key: keytool -genkey -alias tomcat -keyalg RSA
>> iv) Then provide the password. 
For example: 

Provide input
Answer the questions and then type in y for after the last question to confirm. 

Note
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 to tomcat>>conf, then right click on the server.xml with notepad file and select Open with>>Notepad:


b) Delete everything in it and copy-paste the following right side entire content of the page code:currently in the server.xml file. Copy and then paste the code to the right that starts with <?xml version='1.0' encoding='utf-8'?> and ends with </Server>.

c) Once content the code is pasted in the server.xml , Below mentioned are file, the following variables need to be modified with respect modified to reflect your system & and settings:
i - ) Key store path should be modified with your key store path location Example:- keystoreFile(for example: keystoreFile="C:/Users/john/.keystore")
ii - ) Key store password (which was provided while creating the key) , should be modified Example:- keystorePassto include your password (for example: keystorePass="xyz123")
iii - ) MYSQL credentials should be modified Example:- usernameto reflect the username and password used in step 4 of the Install MySQL section above (for example: username="root"  & and 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="com.mysql.jdbc.Driver" 
url="jdbc:mysql://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="443" 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 the modified server.xml page

Press Ctrl + S or File>SaveFile>>Save. 

 5) Close Notepad. 


Info
titleNote

If your any of the server port connections are using port number = 443, then you need to change your port number to 8443 , in server.xml here:-

port="443" maxThreads="200" scheme="https" to port="8443" maxThreads="200" scheme="https" 

...