Setting Up DHIS2 Live on Windows Machines: Step-by-Step Guide

Detailed guide on setting up DHIS2 Live on Windows laptops or desktops, including installation of Java and PostgreSQL, configuration steps like adding PostgreSQL to the system path, setting up databases, loading demo data, and configuring the DHIS2 Live package for use. Follow these instructions carefully to get your DHIS2 system up and running smoothly.

• DHIS2
• Windows
• Installation
• PostgreSQL
• Java

bay_sol Follow

Uploaded on Sep 10, 2024 | 5 Views

Download Presentation

Please find below an Image/Link to download the presentation.

The content on the website is provided AS IS for your information and personal use only. It may not be sold, licensed, or shared on other websites without obtaining consent from the author. Download presentation by click this link. If you encounter any issues during the download, it is possible that the publisher has removed the file from their server.

Presentation Transcript

1. DHIS2 Live on Windows laptops/desktops (NOT for production servers!!) Knut Staring January 2016

2. Preparation Java 8 (JRE): http://java.com/en/download/manual.jsp PostgreSQL 9.5 (or later):http://www.enterprisedb.com/products- services-training/pgdownload#windows dhis2-live.zip http://www.dhis2.org/downloads Notepad++ https://notepad-plus- plus.org/download/v6.9.html

3. Java and Postgres installation Install Java 8 with defaults Install PostgreSQL 9.5 and be sure to remember the password. In the final prompt, UNTICK the Stack Builder option

4. Add Postgres to Windows Path Start button -> Right click Computer ->Properties > Advanced System Settings-> Advanced -> Environment Variables Select Path and Edit. Go to the end and add a semicolon After the new semicolon, add C:\Program Files\PostgreSQL\9.5\bin Click OK, OK, OK

5. PgAdmin Open PgAdmin and log in Right-click Login Roles and enter dhis for Role name. In the Definition tab, enter dhis for the password (twice) Right-click on Databases and select New Database Enter dhis2 for Name and dhis for Role

6. Demo database Skip this slide if you want an empty database Download sample data from https://www.dhis2.org/downloads Unzip the download Open a Command Prompt window and navigate to the new unzipped folder Type the following on the command line: psql U dhis dhis2 < default.sql

7. DHIS2 Live Unzip the downloaded DHIS2 Live package In subfolder conf open dhis.conf in Notepad++ or WordPad (not NotePad) Remove all the # characters Add a # character in front of the top 5 lines

8. dhis.conf should look like this hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect hibernate.connection.driver_class = org.postgresql.Driver hibernate.connection.url = jdbc:postgresql:dhis2 hibernate.connection.username = dhis hibernate.connection.password = dhis hibernate.hbm2ddl.auto = update

9. Start up Put a shortcut to dhis2-live.exe on your dashboard and click on it DHIS2 will start and open your browser to http://localhost:8082 with and empty database If this does not work, try http://127.0.0.1:8082

10. Updating the version of DHIS Download a new version of DHIS2 from http://dhis2.org/downloads Stop DHIS2 Live Go to the folder webapps/dhis and delete everything Copy the new dhis2.war to the same folder Rename to dhis2.zip and unzip

11. Backup and restore Startbutton -> command Use cd to navigate to where you want to have your backups Backup pg_dump U dhis f dhis2sl_2016.sql -d dhis2 Restore Create a new empty database in PgAdmin, eg. dhis2_sl3 psql U dhis f dhis2sl_2016.sql d dhis2_sl3

12. Optional: Multiple DHIS2 Live More than one DHIS2 Live can run simultaneously They must be on different ports In subfolder conf open jetty.port Change the port number (stay above 8000) Change database name in dhis.conf