Installation of DHIS Release 5.4
In order to install dhid (the dynamic host update daemon) please carry out
the following steps:
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
The Installation of GNU MPL should only require
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.
You should have dhid in the source directory
Register for a Dynamic DNS Hostname at the DHIS web site:
You should receive a configuration template with
the DHIS server, an identification number and a
password or a set of private keys by email.
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.
Copy dhid.conf which should have been sent to you by email after
registration to /etc/dhid.conf
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).
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.