Red Hat Bugzilla – Bug 697009
ipa-replica-manage: man page and help pages do not match
Last modified: 2015-01-04 18:48:06 EST
Description of problem: MAN PAGE: pa-replica-manage(1) ipa-replica-manage(1) NAME ipa-replica-manage - Manage an IPA replica SYNOPSIS ipa-replica-manage [OPTION]... [connect|disconnect|del|list|re-initialize|force-sync] DESCRIPTION Manages the replication agreements of an IPA server. connect [SERVER_A] <SERVER_B> - Adds a new replication agreement between SERVER_A/localhost and SERVER_B disconnect [SERVER_A] <SERVER_B> - Removes a replication agreement between SERVER_A/localhost and SERVER_B del <SERVER> - Removes all replication agreements and data about SERVER list [SERVER] - Lists all the servers or the list of agreements of SERVER re-initialize - Forces a full re-initialization of the IPA server retrieving data from the server specified with the --from option force-sync - Immediately flush any data to be replicated from a server specified with the --from option OPTIONS -H HOST, --host=HOST The IPA server to manage. The default is the machine on which the command is run Not honoured by the re-initialize command. -p DM_PASSWORD, --password=DM_PASSWORD The Directory Manager password to use for authentication -v, --verbose Provide additional information --winsync Specifies to create/use a Windows Sync Agreement --binddn=ADMIN_DN Bind DN to use with remote server (default is cn=Directory Manager) - Be careful to quote this value on the command line --cacert=/path/to/cacertfile Full path and filename of CA certificate to use with TLS/SSL to the remote server - this CA certificate will be installed in the directory server’s certificate database --win-subtree=cn=Users,dc=example,dc=com DN of Windows subtree containing the users you want to sync (default cn=Users,<domain suffix> - this is typically what Windows AD uses as the default value) - Be careful to quote this value on the command line --passsync=PASSSYNC_PWD Password for the Windows PassSync user. --from=SERVER The server to pull the data from, used by the re-initialize and force-sync commands. EXAMPLES List all masters: # ipa-replica-manage list srv1.example.com srv2.example.com srv3.example.com srv4.example.com List a server’s replication agreements. # ipa-replica-manage list srv1.example.com srv2.example.com srv3.example.com Re-initialize a replica: # ipa-replica-manage re-initialize --from srv2.example.com This will re-initialize the data on the server where you execute the command, retrieving the data from the srv2.example.com replica Add a new replication agreement: # ipa replica-manage connect srv2.example.com srv4.example.com Remove an existing replication agreement: # ipa replica-manage disconnect srv1.example.com srv3.example.com Completely remove a replica: # ipa replica-manage del srv4.example.com Using connect/disconnect you can manage the replication topology. EXIT STATUS 0 if the command was successful 1 if an error occurred HELP: ]# ipa-replica-manage --help Usage: ipa-replica-manage [options] Options: --version show program's version number and exit -h, --help show this help message and exit -H HOST, --host=HOST starting host -p DIRMAN_PASSWD, --password=DIRMAN_PASSWD Directory Manager password -v, --verbose provide additional information -f, --force ignore some types of errors --binddn=BINDDN Bind DN to use with remote server --bindpw=BINDPW Password for Bind DN to use with remote server --winsync This is a Windows Sync Agreement --cacert=CACERT Full path and filename of CA certificate to use with TLS/SSL to the remote server --win-subtree=WIN_SUBTREE DN of Windows subtree containing the users you want to sync (default cn=Users,<domain suffix) --passsync=PASSSYNC Password for the Windows PassSync user --from=FROMHOST Host to get data from Which is correct? Version-Release number of selected component (if applicable): ipa-server-2.0.0-20.el6.x86_64 How reproducible: always Steps to Reproduce: 1. install ipa-server 2. man ipa-replica-manage 3. ipa-replica-manage --help Actual results: Big difference in output Expected results: At least the same (correct) options and flags should be listed in both Additional info:
https://fedorahosted.org/freeipa/ticket/1178
master: 9de10f3674078ef8c423522e30fe704a2d09a7c2 ipa-2-0: 9a3bf577f831d3595cef6013cd319e3a4db03d1e
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: Do not document
[root@qe-blade-12 ~]# ipa-replica-manage --help Usage: ipa-replica-manage [options] Options: --version show program's version number and exit -h, --help show this help message and exit -H HOST, --host=HOST starting host -p DIRMAN_PASSWD, --password=DIRMAN_PASSWD Directory Manager password -v, --verbose provide additional information -f, --force ignore some types of errors --binddn=BINDDN Bind DN to use with remote server --bindpw=BINDPW Password for Bind DN to use with remote server --winsync This is a Windows Sync Agreement --cacert=CACERT Full path and filename of CA certificate to use with TLS/SSL to the remote server --win-subtree=WIN_SUBTREE DN of Windows subtree containing the users you want to sync (default cn=Users,<domain suffix) --passsync=PASSSYNC Password for the Windows PassSync user --from=FROMHOST Host to get data from [root@qe-blade-12 ~]# from man: OPTIONS -H HOST, --host=HOST The IPA server to manage. The default is the machine on which the command is run Not honoured by the re-initialize command. -p DM_PASSWORD, --password=DM_PASSWORD The Directory Manager password to use for authentication -v, --verbose Provide additional information -f, --force Ignore some types of errors --binddn=ADMIN_DN Bind DN to use with remote server (default is cn=Directory Manager) - Be careful to quote this value on the command line --bindpw=ADMIN_PWD Password for Bind DN to use with remote server (default is the DM_PASSWORD above) --winsync Specifies to create/use a Windows Sync Agreement --cacert=/path/to/cacertfile Full path and filename of CA certificate to use with TLS/SSL to the remote server - this CA certificate will be installed in the directory server’s certificate database --win-subtree=cn=Users,dc=example,dc=com DN of Windows subtree containing the users you want to sync (default cn=Users,<domain suffix> - this is typically what Windows AD uses as the default value) - Be careful to quote this value on the command line --passsync=PASSSYNC_PWD Password for the Windows PassSync user. Required when using --winsync. This does not mean you have to use the PassSync service. --from=SERVER The server to pull the data from, used by the re-initialize and force-sync commands. Verified in version: Name : ipa-server Relocations: (not relocatable) Version : 2.1.3 Vendor: Red Hat, Inc. Release : 8.el6 Build Date: Wed 02 Nov 2011 03:21:27 AM IST Install Date: Thu 03 Nov 2011 10:13:53 AM IST Build Host: x86-012.build.bos.redhat.com Group : System Environment/Base Source RPM: ipa-2.1.3-8.el6.src.rpm Size : 3381421 License: GPLv3+ Signature : (none) Packager : Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla> URL : http://www.freeipa.org/ Summary : The IPA authentication server
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHSA-2011-1533.html