DHIS2 Installation on Windows Local Server
Installing DHIS2 is not a very difficult task. There are a few things you need to be aware of. Before installing, you need to know which version of DHIS2 works perfectly with Tomcat and PostgresSQL easily. Let's see the step by step DHIS2 installation process.
The WAR file requires you to install a Java servlet container (like Tomcat or Jetty) and a relational database (PostgreSQL, MySQL and H2 are supported), and is recommended for server setups and environments with high volumes of data and traffic. The latest version is maintained with bug-fixes and minor improvements. You can always get the latest stable release at stable.dhis2.org. Check out the installation guide for Ubuntu Linux here. For the bleeding edge build check out the continuous integration server. WAR files are copied from our continuous integration server where you can find revision number and build time.
Step-01: Necessary Software Installation: You need to ensure the below softwares are running in your machine.
DHIS2 Version upto 2.32, Download full package
Note: Don’t start the tomcat in this step.
Step-02: Environment Variables Setup: Go to → My Computer (Right Click) → Properties → Advanced system settings → Environmental Variables
2.1 Under “System variables”, click on the “New” button and add the following:
Variable Name: DHIS2_HOMEValue: C:\DHIS2
2.2 Add JAVA_OPT as below:
Variable Name: JAVA_OPTSValue: -Xms1024m -Xmx2048m -XX:PermSize=256m -XX:MaxPermSize=1024m
2.3 JDK Path Variable: Add the path variable into the system variables: C:\Program Files (x86)\Java\jdk1.8.0_31\bin
Step-3: Create Database: Open the Pg-Admin and follow the below steps:
3.1 Login to Pg-Admin-4: Please enter your master password that you set during installation
3.2 Right click “Login/Group Roles” and create new login role “dhis”
Don’t forget to allow login privilege:
3.3 Create password as `dhis` and then save:
3.4 Database Creation: Right click on `Databases` and create new database as “dhis2” & set owner as “dhis”
3.5 Create PostGIS extension: Right click on `Extensions` and select extension name as `postgis`
Step-04: Create “dhis.conf” file: Create a folder ”C:\DHIS2” in the below path that already you have added in your environment variable:
You can download from here Download now
Step-05: Open the “dhis.conf” file and paste the below lines:
# Hibernate SQL dialect connection.dialect = org.hibernate.dialect.PostgreSQLDialect # JDBC driver class connection.driver_class = org.postgresql.Driver # Database connection URL connection.url = jdbc:postgresql:dhis2 # Database username connection.username = dhis # Database password connection.password = dhis # Database schema behavior, can be validate, update, create, create-drop connection.schema = update # Encryption password (sensitive) encryption.password = abcd
Step-06: Download the latest war file from: https://www.dhis2.org/downloads
Download: https://www.dhis2.org/downloads
Step-07: Copy the war file to your tomcat “webapps” folder as below:
C:\Program Files (x86)\Apache Software Foundation\Tomcat 9.0\webapps
Step-08: Run “Tomcat9.exe” as below:
Location: C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin
Step-09: Close the above window and run “Tomcat9w.exe” then click on the “start” button
Step-10: Go to the web browser and browse the server: http://localhost:8080/dhis/
http://localhost:8080/dhis Username: admin Password: district
Step-11: You can upload sample data from the below link:
https://www.dhis2.org/downloads
If you face errors like `404-not-found` or `out of shared memory`, you can follow this post: http://dhis2trainingland.com/eportal/?tutorial=dhis2-404-not-found-error
DHIS2 instillation in linux
https://docs.dhis2.org/2.28/en/implementer/html/install_server_setup.html https://github.com/adeelshahid/dhis2-core-ansible
DHIS2 instillation in Mac OSX
https://dhis2.github.io/guides/01-dhis2-basic-setup
Configure your domain and hosting in Digital Ocean Droplet
http://dhis2trainingland.com/eportal/?tutorial=domain-and-hosting-configuration-in-digital-ocean
Last updated: 2019-06-18