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 , Mon, 27 Nov 2000 13:19:36 +0100