4.4. Configuring an IPA Replica

After you have created the replica information file, you need to copy it to the replica server and run the required script to configure the replica.

Procedure 4.2. To configure an IPA replica:

Run the following command on the IPA master server to copy the replica information file to the replica server:
```
# scp /var/lib/ipa/replica-info-ipareplica.example.com \
	root@ipareplica:/var/lib/ipa/
```
On the replica server, run the replica installation script, passing it the replica information file you copied from the master:

# ipa-replica-install /var/lib/ipa/replica-info-ipareplica.example.com

The replica installation script runs a test to ensure that the replica file being installed matches the current hostname. If they do not match, the script returns a warning message and asks for confirmation. This could occur on a multi-homed machine, for example, where mismatched hostnames may not be an issue.
Enter the Directory Manager (DM) password when prompted.

The script then configures a Directory Server instance based on information in the replica information file, and initiates a replication process. When this has successfully completed, the script continues to set up a complete master replica of the IPA server.

Note

You can only have a single Directory Server instance on an IPA server, the one used by IPA itself. If the replica installation script detects an existing Directory Server instance, you will be prompted to remove it.