You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Step-by-step guide

Step 1 - Installing System Updates and Prerequisites:

Install Brew : 

Usually this comes installed with your default Mac OS. You can verify this by typing the following command in the terminal.


~ brew --version


You should expect something similar to the output below - else install and upgrade brew here https://brew.sh/

Homebrew 2.0.4

Homebrew/homebrew-core (git revision c9a5; last commit 2019-03-11)

Homebrew/homebrew-cask (git revision 75af4; last commit 2019-03-12)

Install Java : 

Download Java 8 (Java SE Development Kit 8u201) from here - https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Simply running the dmg file and following the instructions should work. Go to System Preferences  and ensure you have the Java icon below.


Switching Java versions :

You can switch between java versions if you don't want to downgrade your default Java installed on your Mac. This can be done by following the steps below:

Check how many java versions installed

/usr/libexec/java_home -V

Switch between Java X and Java 8 (the latter installed above) by adding this to your .bash_profile  and running source ~/.bash_profile afterwards

# Java 8
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_201.jdk/Contents/Home


Insatlling Java 8 using brew :

Similarly you can install java using brew by typing the following commands into a terminal and switching the default java version as stated above

brew cask install java
brew tap caskroom/versions
brew cask install java8

Install mysql-server : (Only version 5.5 or version 5.6)

Download and install mysql-server from here - https://dev.mysql.com/downloads/mysql/ NB: Make sure to choose between the 5.5 and 5.6 only as higher version won't work for fineract 1.x

Similarly you should see the mysql icon on the System Preferences as shown in the image above.

You should consider adding alias for running mysql and mysqladmin commands via terminal. See below

alias mysql=/usr/local/mysql/bin/mysql 
alias mysqladmin=/usr/local/mysql/bin/mysqladmin


Install tomact : 

Download and install the core binary from the original website here https://tomcat.apache.org/download-70.cgi 
  • Unzip the file downloaded
  • Run the following commands. 
sudo mkdir -p /Library/Tomcat

sudo mv ~/PATH-TO-UNZIPED-TOMCAT/apache-tomcat-7.X.XX /Library/Tomcat

  • Make all scripts executable
sudo chmod +x /Library/Tomcat/apache-tomcat-7.X.XX/bin/*.sh

  • Starting Tomcat

  • No labels