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 |
...
Info | ||
---|---|---|
| ||
Once 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; On completion of java installation,one could verify the installed version by & should be 5.7 or above # mysql --version |
Install tomact :
Info | ||
---|---|---|
| ||
The latest tomcat release will change and the link below may become invalid. If wget fails, get the correct link by going to https://tomcat.apache.org/download-90.cgi and under the core section, selecting the link to the tar.gz file. Use it for wget below:- |
...
# sudo apt-get install nano
OPTIONAL (date/time settings)
Check date:
# date
and if needed update with
# dpkg-reconfigure tzdata
Step 2 - Tomcat setup
Enabling SSL
...
# sudo keytool -genkey -keyalg RSA -keysize 2048 -alias tomcat -keystore /usr/share/tomcat.keystore
in case you have the error below
Sudo: keytool: command not found
run the commands below to install and set the keytool path
sudo update-alternatives --install /usr/bin/keytool keytool /usr/lib/jvm/jdk-15.0.2/bin/keytool 1
sudo update-alternatives --set keytool /usr/lib/jvm/jdk-15.0.2/bin/keytoolthen re-run the command
# sudo keytool -genkey -keyalg RSA -keysize 2048 -alias tomcat -keystore /usr/share/tomcat.keystore
Info | ||
---|---|---|
| ||
set 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
...
Info | ||
---|---|---|
| ||
Tip: 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"> |
...
Download and extract Fineract platform::
Info |
---|
For latest released code you can download from https://sourceforge.net/projects/mifos/files/latest/download?source=files or If wget/download fails, this link:- https://github.com/apache/fineract/releases In which you will find the following folders and file
|
...
Info | ||
---|---|---|
| ||
Pentaho 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 | ||
---|---|---|
| ||
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 |
...