Thanks for the comments. Please find the attached revised patch.
I changed the man page name from pki-tps-connector to
pki-tps-connector-config to avoid a possible conflict with the man page
for pki-tps-connector CLI. Right now the CLI is called "pki
tps-connection" but I'm planning to change it to "pki tps-connector"
for
consistency.
Please see the comments below.
On 4/24/2014 11:18 AM, Christina Fu wrote:
1. Under CA connector,
"+This property contains the URI to contact TKS for the operation
<op>."
I think you meant "...contact CA..." not "...contact TKS..."
Fixed.
2. For CA connector, I should have provided instruction on how to
configure revocation routing.
a. add past signing CA's cert nickname as such (the CA's signing
cert should already be in the nss db and trusted):
tps.connector.ca<n>.caNickname=<signing ca nickname>
b. when the first revocation is triggered, you might notice a new
parameter added to the config, which is the automated generated Base64
encoded CA SKI. e.g.
tps.connector.ca1.caSKI=a/OJajZmIucFjKQa4rJxvvUZmBo=
Do you mind writing something that I can copy & paste it into the man
page? I don't think I'm familiar enough with it to write a proper
documentation. Or if you prefer you could send a separate patch on top
of this patch.
3. You probably want to remove the old conn stuff: conn.xxx
OK. I'll do that in patch #476 because that's where we remove the old
code that refers to conn.xxx.
4. Maybe create a separate ticket...per discussion on irc, we want
to
create a "main man page" that lists out all man page key words one can
man for our product. This is so that people know where to look for info
now that they are gone from CS.cfg. Once created, we should put a one
line that points them to the main man page to look for info, perhaps in
CS.cfg's, admin ui's, cli's etc.
I created these tickets:
https://fedorahosted.org/pki/ticket/976
https://fedorahosted.org/pki/ticket/975
Also, as mentioned over IRC I created a list of manual pages:
http://pki.fedoraproject.org/wiki/Dogtag_10_Manual_Pages
To avoid confusion I'm going to add the Dogtag versions in which the
pages were added.
thanks,
Christina
--
Endi S. Dewata