1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84
|
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.
|