← Back to team overview

freeipa team mailing list archive

[Bug 1801198] Re: missing scripts, no documentation

 

that is not entirely true. Yes we shouldn't go into their project a
destroy their documentation for their use on redhat by changing
everything to match Ubuntu. However there are several ways to change the
documentation to match the debian/ubuntu context and the choice depends
on what the copyright steward for the documentation is comfortable with.
we could possibly add Ubuntu versions to their document store - if that
is what they are comfortable with. We could take their documentation and
morph it to match debian/ubuntu in the ubuntu help or community
documentation projects. At the very least we could update the useless
readme file currently shipped in the package to mention such useful
information as the above. All of which depends on what approach they are
comfortable with, but we can do more than we currently are. I will be
investigating porting their quick start guide which I think is probably
the most important document for most people. We will see where I get.

-- 
You received this bug notification because you are a member of FreeIPA,
which is subscribed to dogtag-pki in Ubuntu.
https://bugs.launchpad.net/bugs/1801198

Title:
  missing scripts, no documentation

Status in dogtag-pki package in Ubuntu:
  Invalid

Bug description:
  In an extensive search I only found documentation for red hat/fedora
  versions of linux. The documentation by the maintainers of the
  software is also red hat specific. It uses a series of scripts eg
  setup-ds.pl to configure the software that are not installed when the
  ubuntu packages: dogtag-pki and 389-ds-base are installed.

  So several possible cases:

  1) the scripts are not required because the package include their
  actions

  2) the scripts have been accidentally left out of the packages

  3) the scripts are incompatible with ubuntu - directory structure
  possible - and so were left out.

  Bottom line this is the only enterprise quality CA included in the
  repositories that I could find and there is no documentation so no
  easy way to use it. This is not something you want to hack at unless
  you know what you are doing.

  Expecting:

  install the packages, follow the red hat flavour documentation and
  translate into ubuntuese

  outcome:

  documentation impossible to follow after install because of missing
  scripts

  Ubuntu version:

  ubuntu 18.04.1 LTS

  Package:

  dogtag-pki 10.6.0-1ubuntu2
  389-ds-base 1.3.7.10-1ubuntu2

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/dogtag-pki/+bug/1801198/+subscriptions


References