Downloading the source code
Anyone can check out the code anonymously (i.e. without a server account), simply using HTTP. This will give access to the latest (and not extensively tested) source code. For innstalling the software, we recommend the prepackaged releases Download page. Also, the source of each release is available as zip files there.
Checking out the main DHIS 2 code
- Install a Subversion (svn) client.
- Decide on a directory for all the source code, e.g. "dhis2src".
- Create another directory inside dhis2src, called trunk, and another inside that one, called dhis-2.
- The main code is around 70 MB. It is available using this URL: http://www.hisp.info/svn/trunk/dhis-2
.
- For Tortoise, right click on the folder <PATH>\dhis2src\trunk\dhis-2, and select "SVN Checkout ...". In the popup-window, paste the above URL in the top input field, and click OK.
- For command line, cd into dhis2src/trunk/dhis-2 and type
More info
What to check out?
Depending on what you wish to do, you may later want to follow a similar procedure other modules. You should then browse the source code structure
Below is a quick guide - please ask further questions on the dhis-dev@hisp.info list.
| branches |
for testing various alternatives to the current build |
| deprecated |
old stuff |
| incubator |
new projects to be included |
| sandbox |
test and play |
| tags |
the releases |
| tools |
internal tools related to the application |
| trunk |
the current developer version |
Here is a small discussion on when to use branches, incubator and sandbox.
Commit rights - SSH account
If you are becoming familiar with the source code and have made improvements that you would like to commit to the global repository, please contact Ola
,Knut or Torgeir to get access. Please let us know who you are and what improvements you have made, and attach your code modifications for us to review before creating an account.
Command line SSH
To save typing your password over and over again, try using a SSH key.
TortoiseSVN
Checkout using HTTP
(For those with firewall issues)
- Download this JAR file (5 MB)
- run: java -jar Digest.jar username Subversion password
where username is your username and password is the password you would like to use.
- send the complete output of the Digest program to Torgeir or Hans
This way you keep your password secret.
Use the command:
The username is inferred from the login name you've used to log into your computer.
