
Installation of DHIS Release 5.4
================================

In order to install dhid (the dynamic host update daemon) please carry out 
the following steps:

1. Compiling


	If you want DHIS to operate in secure mode (QRC), install the GNU
	Multiprecision Library. You may download a version of gmp from the 
	DHIS FTP site on 
	ftp://ftp.dhis.org/pub/dhis/gmp-4.1.tar.gz

	The Installation of GNU MPL should only require 
		"configure;make;make install"

	Otherwise, i.e., if you wish DHIS to operate in password mode,
	edit the Makefile and replace CFLAGS, LFLAGS and LIBS by those
	commented without reference to gmp or QRC.

	If your OS is System V edit the Makefile and add -lnsl -lsocket 
	to the LIBS section.
	
	Type "make".

	You should have dhid in the source directory

2. Registration

	Register for a Dynamic DNS Hostname at the DHIS web site:

		http://www.dhis.org/

	You should receive a configuration template with
	the DHIS server, an identification number and a 
        password or a set of private keys by email.

	Paranoid Security:

	If you're really paranoid about security or simply wish to
	perform things in a secure way, are using QRC, 
	an alternative procedure is available. Instead of 
	receiving your private keys from DHIS you may wish to
        generate them yourself and only provide the public key.

        In order to generate a set of private and public keys for
        use with dhid in QRC mode:

	run genkeys and save the output in a file:

	./genkeys > mykeys

	mykeys should now have the public key necessary lines that 
	you should submit on registration.

        The lines starting with AuthP and AuthQ are your private keys.
        The lines starting with AuthN are your public key.

        Insert the private keys in dhid.conf and add the public key
        to your DHIS service account using. 

3. Installation

	Copy dhid.conf which should have been sent to you by email after 
	registration  to  /etc/dhid.conf

        or

        Create /etc/dhid.conf with at least one record. You need to
        have a valid HostID, ISAddr (server address) and password or
        set of keys.

	Protect it, i.e., chmod 600 /etc/dhid.conf

	Edit your system's startup script and add a single
	line calling dhid wherever it is (it runs in background so
	no & is needed).

4. Run

	And that's it. You may run the dhid daemon at once simply
	by executing it, or at boot time through your startup script.

	For a more detailed description of possible additional options
        please see dhid.conf.sample available in this distribution.

