...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Linux Server for Fineract Platform using Java-OpenJDK-15.0.2 - Higher Versions Not Recommended Tomcat server (Minimum v.9.0.48) or above (latest available at https://tomcat.apache.org/download-90.cgi MYSQL server (v.5.7.3x) - Higher versions not tested Keep the passwords in this document as your defaults until after you are done with your first successful installation then you can change the passwords |
Step 1 - Installing System Updates and Prerequisites:
...
| Info |
|---|
mysql passwordOnce the installation is completed, the MySQL service will start automatically. To check whether the MySQL server is running, type: # sudo systemctl status mysql Configure the Port and binding address as shown below using sudo nano command Set the bind address as you wish for example 0.0.0.0 sets it to any IP address across the globe (Strongly not recommended) Run the security script: for proper configurations Follow the prompts and configure you installation to the best of your interests # sudo mysql Next, check which authentication method each of your MySQL user accounts use with the following command: SELECT user,authentication_string,plugin,host FROM mysql.user; Output should look like below Set the password to "mysql" Please note that this is Bad for security, but just to get all installed and instructions on how to change it will be provided later in this guide) Setting password use the command below ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'mysql'; FLUSH PRIVILEGES; SELECT user,authentication_string,plugin,host FROM mysql.user;
|
...
# sudo apt-get install nano
OPTIONAL (date/time settings)
| Code Block |
|---|
Check date: |
# date
| Code Block |
|---|
and if needed update with |
# dpkg-reconfigure tzdata
Step 2 - Tomcat setup
Enabling SSL
...
| Info |
|---|
set keystore passwordset password to: xyz123 (Bad for security, but just to get all installed and instructions on how to change it will be provided later in this guide) This gets stored in /usr/share as tomcat.keystore |
Updating server.xml configuration file
...
# sudo nano /usr/share/tomcat9/conf/server.xml
| Info |
|---|
nano shortcut keysTip: To delete line by line you could use ctrl+k To exit you could use ctrl+x To confirm say yes & you could use y then click on enter button to save |
copy and replace below content into it
<?xml version='1.0' encoding='utf-8'?> <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" /> <Resource <Connector <Engine name="Catalina" defaultHost="localhost"> <Realm className="org.apache.catalina.realm.LockOutRealm"> <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true"> |
...
| Info |
|---|
For latest released code you can download from https://sourceforge.net/projects/mifos/files/latest/download?source=files orIf wget/download fails, this link:- https://github.com/apache/fineract/releases In which you will find the following folders and file
|
...
| Info |
|---|
pentahoReports & upload directoryPentaho Reports If /pentahoReports is not copied into /root/.mifosx, penatoh reports,ex:accounting reports will fail with: Income Statement.prpt","defaultUserMessage":"Unable to create key: No loader was able to handle the given key data: /usr/share/tomcat9/.mifosx/pentahoReports/Income Statement.prpt","userMessageGlobalisationCode":"error.msg.reporting.error","parameterName":null,"value" Upload Directory
|
Start tomcat:
# sudo /etc/init.d/tomcat9 start
...
| Code Block | ||
|---|---|---|
| ||
<Listener className="org.apache.catalina.core.JasperListener" /> |
OPTIONAL:
*in separate terminal you may watch your Mifos(logs) come to life like this:
# sudo tail -f /usr/share/tomcat9/logs/catalina.out
(if all is good, after a while of loading, you should see something like: Root WebApplicationContext: initialization completed in 45876 ms)
| Info |
|---|
It's Done!Congratulations! You could access Mifos X through any internet browser:- @ https://server ip address or if you are using server port number as 8443 then you could access it @ https://localhost:8443 With these credentials:- username: mifos password: password |
...