
Installation of DHIS Release 5.1
================================

In order to install dhid (the dynamic host update daemon) please perform
the following stages:

1. Compilation Stage


	If you want DHIS to operate in secure mode (QRC), install the GNU
	Multiprecision Library. You may download it from
	ftp://ftp.dhis.org/pub/dhis/gmp-2.0.2.tar.gz

	Installation of GNU MPL requires "configure;make;make install"
	only.

	Otherwise, i.e., if you wish DHIS to operate in insecure 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 Stage

	Contact your DHIS service provider in order to subscribe to
        a server implemented with DHIS. You will need at least the 
        IP address of the server, an identification number and a
        password or a set of private keys.

	Paranoid Security:

	If you're really paranoid about security or simply wish to
	perform things in a secure way, are using QRC, and your provider 
	allows you to, an alternative procedure is available. Instead of 
	receiving your private keys from your provider 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.

        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 send the public key
        to the DHIS service provider.

3. Installation Stage

	
	Copy dhid.conf which should have been sent to you by your
        DHIS service provider 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 Stage

	And that's it. You may run the dhid daemon at once simply
	by executing 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.
