000016989 - Quick Setup of a Replica Instance fails the attach to the Primary Instance

Document created by RSA Customer Support Employee on Jun 14, 2016Last modified by RSA Customer Support Employee on Apr 21, 2017
Version 2Show Document
  • View in full screen mode

Article Content

Article Number000016989
Applies ToRSA Authentication Manager 8.1
Virtual Appliance
IssuePrimary instance cannot contact the Replica host
Attaching a replica host to a primary instance via Quick Setup generates an error
CauseRSA Authentication Manager 8.1 relies on name resolution from the configured DNS server(s) defined in the network settings of the deployemnt.

Where the DNS Servers are not providing the correct name resolution then use this workaround by updating the local hosts file (/etc/hosts) of the Primary Instance at the command line.


1. Ensure SSH is enabled on the Primary instance via the RSA Operations Console > Administration > Operating System Access > SSH Settings ? check Enable SSH.


2. Use a client (such as PuTTY) to open an SSH session and logon to the Primary instance using the ?rsaadmin? account. The password for this account was defined during the Primary instance Quick Setup.


3. Use the ?sudo su ? root? command to use the security privileges of the super user (root) to update the local hosts file.


4. Next, use an editor such as 'vi' to update the local hosts file /etc/hosts with the Replica instance IP address, fully qualified domain name and hostname (for an alias).








# hosts         This file describes a number of hostname-to-address


#               mappings for the TCP/IP subsystem.  It is mostly


#               used at boot time, when no name servers are running.


#               On small systems, this file can be used instead of a


#               "named" name server.


# Syntax:




# IP-Address  Full-Qualified-Hostname  Short-Hostname







# special IPv6 addresses


::1             localhost ipv6-localhost ipv6-loopback




fe00::0         ipv6-localnet




ff00::0         ipv6-mcastprefix


ff02::1         ipv6-allnodes


ff02::2         ipv6-allrouters


ff02::3         ipv6-allhosts




# BEGIN local address appv8p.csau.ap.rsa.net appv8p appv8r.csau.ap.rsa.net appv8r


# END local address





     NOTE: the Primary instance IP address, fully qualified domain name and host name will already exist as an entry in the hosts file


5. Now, use the Replica instance Quick Setup URL (e.g. in a supported web browser to continue with the Replica Quick Setup.


     NOTE: an access code is required for RSA Authentication Manager 8.1 Quick Setup which can be found on the local console of the deployment.


Please contact RSA Customer Support should you still require assistance with the Replica Quick Setup.

Legacy Article IDa64008