ipa-replica-install(1) [centos man page]
ipa-replica-install(1) IPA Manual Pages ipa-replica-install(1) NAME
ipa-replica-install - Create an IPA replica SYNOPSIS
ipa-replica-install [OPTION]... replica_file DESCRIPTION
Configures a new IPA server that is a replica of the server that generated it. Once it has been created it is an exact copy of the original IPA server and is an equal master. Changes made to any master are automatically replicated to other masters. The replica_file is created using the ipa-replica-prepare utility. If the installation fails you may need to run ipa-server-install --uninstall before running ipa-replica-install again. The installation will fail if the host you are installing the replica on exists as a host in IPA or an existing replication agreement exists (for example, from a previously failed installation). A replica should only be installed on the same or higher version of IPA on the remote system. OPTIONS
BASIC OPTIONS --setup-ca Install and configure a CA on this replica. If a CA is not configured then certificate operations will be forwarded to a master with a CA installed. --ip-address=IP_ADDRESS The IP address of this server. If this address does not match the address the host resolves to and --setup-dns is not selected the installation will fail. If the server hostname is not resolvable, a record for the hostname and IP_ADDRESS is added to /etc/hosts. -p DM_PASSWORD, --password=DM_PASSWORD Directory Manager (existing master) password -w ADMIN_PASSWORD, --admin-password=ADMIN_PASSWORD Admin user Kerberos password used for connection check --mkhomedir Create home directories for users on their first login -N, --no-ntp Do not configure NTP --no-ui-redirect Do not automatically redirect to the Web UI. --ssh-trust-dns Configure OpenSSH client to trust DNS SSHFP records. --no-ssh Do not configure OpenSSH client. --no-sshd Do not configure OpenSSH server. --skip-conncheck Skip connection check to remote master -d, --debug Enable debug logging when more verbose output is needed -U, --unattended An unattended installation that will never prompt for user input CERTIFICATE SYSTEM OPTIONS --skip-schema-check Skip check for updated CA DS schema on the remote master DNS OPTIONS --setup-dns Generate a DNS zone if it does not exist already and configure the DNS server. This option requires that you either specify at least one DNS forwarder through the --forwarder option or use the --no-forwarders option. --forwarder=IP_ADDRESS Add a DNS forwarder to the DNS configuration. You can use this option multiple times to specify more forwarders, but at least one must be provided, unless the --no-forwarders option is specified. --no-forwarders Do not add any DNS forwarders. Root DNS servers will be used instead. --reverse-zone=REVERSE_ZONE The reverse DNS zone to use --no-reverse Do not create new reverse DNS zone. If a reverse DNS zone already exists for the subnet, it will be used. --no-host-dns Do not use DNS for hostname lookup during installation --no-dns-sshfp Do not automatically create DNS SSHFP records. EXIT STATUS
0 if the command was successful 1 if an error occurred 3 if the host exists in the IPA server or a replication agreement to the remote master already exists IPA
May 16 2012 ipa-replica-install(1)
Check Out this Related Man Page
ipa-replica-conncheck(1) IPA Manual Pages ipa-replica-conncheck(1) NAME
ipa-replica-conncheck - Check a replica-master network connection before installation SYNOPSIS
ipa-replica-conncheck [OPTION]... DESCRIPTION
When an IPA replica is being installed a network connection between a replica machine and a replicated IPA master machine has to be pre- pared for master-replica communication. In case of a flawed connection the installation may fail with inconvenient error messages. A common connection problem is a misconfigured firewall with closed required port on a replica or master machine. The connection is checked by running a set of tests from both master and replica machines. The program is incorporated to ipa-replica-install(1) but can be also run separately. OPTIONS
REPLICA MACHINE OPTIONS This set of options is used when the connection check is run on a prepared IPA replica machine. -m MASTER, --master=MASTER Remote master machine address -a, --auto-master-check Automatically log in to master machine and execute the master machine part of the connection check. The following options for replica part are only evaluated when this option is set -r REALM, --realm=REALM The Kerberos realm name for the IPA server -k KDC, --kdc=KDC KDC server address. Defaults t MASTER -p PRINCIPAL, --principal=PRINCIPAL Authorized Kerberos principal to use to log in to master machine. Defaults to admin -w PASSWORD, --password=PASSWORD Password for given principal. The password will be prompted interactively when this option is missing MASTER MACHINE OPTIONS This set of options is used when the connection check is run on a master machine against a running ipa-replica-conncheck(1) on a replica machine. -R REPLICA, --replica=REPLICA Remote replica machine address COMMON OPTIONS -c, --check-ca Include in a check also a set of dogtag connection requirements. Only needed when the master was installed with Dogtag 9 or lower. -h HOSTNAME, --hostname=HOSTNAME The hostname of this server (FQDN). By default a nodename from uname(2) is used -d, --debug Print debugging information -q, --quiet Output only errors EXAMPLES
ipa-replica-conncheck -m master.example.com Run a replica machine connection check against a remote master master.example.com. If the connection to the remote master machine is successful the program will switch to listening mode and prompt for running the master machine part. The second part check the con- nection from master to replica. ipa-replica-conncheck -R replica.example.com Run a master machine connection check part. This is either run automatically by replica part of the connection check program (when -a option is set) or manually by the user. A running ipa-replica-conncheck(1) in a listening mode must be already running on a replica machine. ipa-replica-conncheck -m master.example.com -a -r EXAMPLE.COM -w password Run a replica-master connection check. In case of a success switch to listening mode, automatically log to master.example.com in a realm EXAMPLE.COM with a password password and run the second part of the connection check. EXIT STATUS
0 if the connection check was successful 1 if an error occurred SEE ALSO
ipa-replica-install(1) IPA
Jun 2 2011 ipa-replica-conncheck(1)