/isanteplus_installation

this repository contain all the process to install isanteplus

Primary LanguageShell

iSantePlus Installation

Setup

Install Git

apt-get install git-all
git clone https://github.com/IsantePlus/isanteplus_installation.git
cd isanteplus_installation

sudo chmod 777 utils/legacy/isanteplus-1.sh
sudo chmod 777 utils/legacy/isanteplus-2.sh
sudo chmod 777 utils/legacy/isanteplus-3.sh

Option 1: Legacy Approach

this repository contain all the process to install isanteplus

isanteplus is set to work on a linux enviroment

Step 1: Install tomcat 7 and mysql 5.6

sh utils/legacy/isanteplus-1.sh

This command will reboot the system when finished

Execute the following command to verify the status of the mysql

sudo /etc/init.d/mysql.server start
sudo /etc/init.d/mysql.server status
sudo update-rc.d -f mysql.server defaults
sudo reboot

Step 2: Install openmrs war

sh utils/legacy/isanteplus-2.sh

Navigate to http://localhost:8080/openmrs to continue the installation

Step 3: Install openmrs concept and isanteplus modules

sh utils/legacy/isanteplus-3.sh

Option 2: Github Repo Distro Approach

  1. Create a new Github Personal Access Token if you do not have one already.

  2. Run the first setup script, which will cause a reboot.

    export MYSQL_ROOT_PASSWORD=<your-desired-root-password>
    sh ./utils/github-package/isanteplus-1.sh
  3. Verify mysql installation.

    sudo /etc/init.d/mysql.server start
    sudo /etc/init.d/mysql.server status
    sudo update-rc.d -f mysql.server defaults
    sudo reboot
    
  4. Set a couple necessary temporary env variables to hold the Personal Access Token from step 1 and the desired iSantePlus distro version. You can see the available versions here.

    export GITHUB_USERNAME=<your-github-username>
    export GITHUB_TOKEN=<your-token-from-step-1>
    export ISANTEPLUS_VERSION=2.6.0
  5. Run the second setup script.

    sh ./utils/github-package/isanteplus-2.sh
    
  6. Navigate to http://localhost:8080/openmrs to continue the installation.

Option 3: Docker-based Setup

  1. Install docker server on the system. See https://docs.docker.com/engine/install/ for installation steps.

  2. Install docker-compose on the system. See https://docs.docker.com/compose/install/

  3. Boot up images:

    docker-compose up -d
    

MySQL Docker Image

Note: in order to make sure we prevent perfomance issues involved with running MySQL through docker, the docker-based MySQL setup needs to be set up correctly. See https://mysqlserverteam.com/mysql-with-docker-performance-characteristics/ and other posts discussing dockerized vs. native MySQL perfomance. It seems like perfomance should not be negatively

If the iSantePlus database is running on a dedicated server, or you