Versions Compared

Key

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

 


Panel

On this page:

Table of Contents
maxLevel3
minLevel3
printablefalse


Step 1)

Stop running tomcat server

If you have installed tomcat as service then, stop Apache tomcat service. 

or

If you have installed tomcat manually, you could use ctrl+c and stop the server.

Step 2)

Uninstall Java7 

You could go to control panel and uninstall Java7 Java

Step 3)  

Install Java 

You could follow the link:- http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html, to download JAVA 1.8 & install.  

Update Environmental variables for Java  

  •  

    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.

Step 4) 

Uninstall existing Tomcat 

If you have installed tomcat as service, then you could uninstall tomcat service. 

Or 

If you have installed tomcat manually, then you could delete all the tomcat directories.  

Step 5) 

Install tomact : 

  •  

    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-bitwindows zip or 64-bit windows zip( with respect to your system architect) to download.

Image Modified  

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

                   

Image Modified

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

 

Image Modified

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

Image Modified

Step 6) 

 

  •  

    Tomcat - Setup

1) Setting up Lib folder

a) Download drizzle jdbc 1.3 jar file from http://central.maven.org/maven2/org/drizzle/jdbc/drizzle-jdbc/1.3/drizzle-jdbc-1.3.jar

b) Once it's downloaded copy & paste it to lib folder, Go toTomcat>>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 Modified

Provide input and type in y for the last question to confirm. 
Image Modified

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 Modified


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="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 modified server.xml page

Press Ctrl + S or File>Save. 

 5) Close Notepad. 


Step 7) 

 

  •  

    Download Mifos 

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. 

Image Modified

Step 8) 

  •  

    Drop Mifos into Tomcat folder

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

1-a) Copy "fineract-provider.war" file from downloaded fineract-platform folder 

        Image Modified

  

1-b) Paste it to tomcat\webapps folder

 Image Modified                

2) Community-app to tomcat>>webapps folder

2-a) Copy "community-app" folder from downloaded Mifos-platform>>apps folder: 

       Image Modified

2-b) Paste it to tomcat\webapps

 

2-c) Rename existing ROOT folder to OLDROOT under tomcat\webapps\

2-d) Rename community-app folder to ROOT

 

 

3) api-docs to tomcat>>webapps>>ROOT folder

3-a) Copy "api-docs" folder from downloaded Mifos-platform>>api-docs folder: 

Image Modified                 

 

3-b) Paste it to tomcat\webapps\ROOT folder

 

4) Copy & replace pentaho folder into .mifosx folder 

 Step 9) 

  •  

    Start Mifos   

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

    Image Modified

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

2) Application gets started

 Image Modified

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

   Image Modified

4) You could access through any internet browser:- 

https://localhost 

 

 5) For the first time access it will display as shown below, please click on proceed:- 

         Image Modified

6) Login into Mifos, by providing your credentials

Image Removed
Image Added

 


Info
titleNote

Important  

You could access Mifos X through any internet browser:- 

https://server ip address  with you earlier credentails

Note: Since in this instruction page, we have provided port number as 443 in server.xml page so need to provide port number. Since we have renamed community-app as ROOT no need to provide /community-app

 

 

Related articles

Filter by label (Content by label)
showLabelsfalse
max5
spacesdocs
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("mifos","on","up-gradation","x","windows","of") and type = "page" and space = "docs"
labelsUp-gradation of Mifos X on windows