ipa-server-certinstall_CLI_cleanup#

__NOTOC__

Overview#

Ticket 3869

The CLI options for ipa-server-certinstall are not ideal. Clean them up.

All changes are backwards compatible.

Use Cases#

Same as for ipa-server-certinstall

Design#

Before this change, ipa-replica-certinstall -h output was:

Usage: ipa-server-certinstall [options]

Options:
-h, --help            show this help message and exit
-d, --dirsrv          install certificate for the directory server
-w, --http            install certificate for the http server
--dirsrv_pin=DIRSRV_PIN
                        The password of the Directory Server PKCS#12 file
--http_pin=HTTP_PIN   The password of the Apache Server PKCS#12 file

The actual allowed usages were:

ipa-server-certinstall -h
ipa-server-certinstall -d --dirsrv_pin ``\ ``
ipa-server-certinstall -w --http_pin ``\ ``
ipa-server-certinstall -d --dirsrv_pin ``\ `` -w --http_pin ``\ ``

This change:

Adds a --pin option that replaces --dirsrv_pin and --http_pin. The old options will remain as deprecated aliases.
Adds a -p, --dirman-password option to specify the directory manager password (necessary for replacing the DS cert).
Mentions in the usage string that
- a PKCS#12 cert argument is required
- at least one of -d or -w is required

Implementation#

It’s possible that only a part of this proposal, namely adding the --pin option, will be be implemented in 3.3. In that case the rest will be atted later.

Feature Management#

N/A

CLI

See Design

Major configuration options and enablement#

N/A

Replication#

N/A

Updates and Upgrades#

N/A

Dependencies#

N/A

External Impact#

Docs and tests will need to be updated, although since the change is backwards compatible, there’s no rush.

Backup and Restore#

N/A

Test Plan#

Tests are to be included in the CA-less test plan, CA-less_install, and any future test cases that exercise ipa-server-certinstall.

RFE Author#

Petr Viktorin

ipa-server-certinstall_CLI_cleanup

Contents