/usr/share/doc/dhis-client/README.Debian is in dhis-client 5.5-5+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | 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
|