Versions Compared

Old Version 204

changes.mady.by.user Hassan S. COnteh

Saved on

compared with

New Version Current

changes.mady.by.user Hassan S. COnteh

Saved on

Key

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


Info
titleRefer New Document for latest version Installation

To Install/Upgrade to the latest version of Mifos (21.07.01) Refer below document

Mifos X 21.07 Installation Guide (with Pentaho plugin)

...

Prerequisite Software   


Info
titleNote

the software and versions included below are a mandatory prerequisite

  • JAVA DEVELOPMENT KIT >> VERSION 1.8.0_231 & above                                
  • MYSQL SERVER >> Version 5.5 or 5.6 only - Any version above or below is not recommended in a live production environment  unless you have tested it your self
  • TOMCAT >> Version 7.0.109.0 & above (version 7.0.xx.xx)


  •  

    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.

...

  •  

    Tomcat - Setup

1) Setting up the Lib folder

a) Download the mysql jdbc 5.1.49 jar file from https://downloads.mysql.com/archives/get/p/3/file/mysql-connector-java-5.1.49.zip 

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

Info
titleNote

If the tomcat-jdbc.jar file is not available in the tomcat>>lib folder 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 the Java keytool :

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 -keysize 2048
iv) Then provide the password. 
For example: 


Answer the questions and then type y after the last question to confirm. 


Info
titleNote

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


b) Delete everything 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 the code is pasted in the server.xml file, the following variables need to be modified to reflect your system and settings:
i) Key store path should be modified with your key store path location (for example: keystoreFile="C:/Users/john/.keystore")
ii) Key store password (which was provided while creating the key) should be modified to include your password (for example: keystorePass="xyz123")
iii) MYSQL credentials should be modified to 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>>Save. 

 5) Close Notepad. 

...