dhis-client for Debian:
======================

The dhis-client only works in conjunction with a dhis-server. You can set up
your own server using the dhis-server package, or you can use a public DHIS
service, such as http://www.dhis.org/services/. They will send an appropriate
dhid.conf file with the server's IP address, Host identification number and
password or private keys.

A sample file is also provided in examples/ for your convenience.

Paranoid Security:
-----------------

If you're really paranoid about security or simply wish to perform things in a
secure way, are using QRC, and your DHIS service provider allows you to, an
alternative procedure is available. Instead of receiving your private keys from
your provider by email (which is insecure) 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 dhis_genkeys and save the output in a file:

./dhis-genkeys > mykeys

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

 - the first 4, labeled AuthP and AuthQ, are your private keys (what you
   include in /etc/dhid.conf)

 - the last 4, labeled AuthN, are your public keys (what you send to the DHIS
   service provider)



Upgrading dhid.conf from a 3.x or 4.x dhid client:
-------------------------------------------------

If you are upgrading from a dhid from release 3.x or 4.x and wish to upgrade
to the latest DHIS client please read the following notes. The new client
(dhid 5) introduces multi-client and multi-server support.

As a consequence the /etc/dhid.conf file format has changed slightly. 

If you have an mxaddr line in your dhid.conf file (legacy from 3.x) remove it.
Mail relay messages are no longer supported. If you have a hostname line you
may remove it as well.  It will be ignored anyway. 

  A 4.x dhid.conf file should look like this: 

          hostid          
          hostpass        
          isaddr          



    or

          hostid          
          authp           
          authp           
          authq           
          authq           
          isaddr          



When converting to 5.x format, edit dhid.conf with your favorite text editor
and add record terminators (curly brackets) before and after these lines. The
new format allows dhid to operate with multiple clients. Thus, even if just
one client record is being updated, its parameters need to be delimited. Thus
it becomes: 

     {
             hostid          
             hostpass        
             isaddr          

     }


       or

     {
             hostid          
             authp           
             authp           
             authq           
             authq           
             isaddr          

     }


And that is all. dhid 5 client should work with the updated file. 

Do not delete dhid.conf when upgrading, just add the brackets as above. 

 -- Manuel Estrada <ranty@atdot.org>, Mon, 27 Nov 2000 13:19:36 +0100
