A replica server has to be promoted due to failure of the primary server.
If you must promote a replica but you do not have access to the Operations Console on the replica you can execute a promotion from the command line using the following command:
For AM 7.1 SP4 the command is rsautil manage-replication -a promote
For AM 7.1 pre SP4 the command is rsautil manage-replication -a promote --recovery-mode
****Note**** The promotion process pre SP4 even via the Operations Console often failed so it is quite possible the command line promotion will also have a high failure rate in pre SP4 systems.
Before running the promotion command it is recommended you restart the RSA services on the replica to be promoted. It will also be necessary to restart the services after the promotion completes successfully.
Here is a sample promotion done on an AM 7.1 SP4 Appliance.
-bash-3.00$ ./rsautil manage-replication -a promote
Enter password: *************
Manage Replication ims-2.0.4-build20120517160126
Copyright (C) 2010 RSA Security Inc. All rights reserved.
%% Running at: testserver:[u7fi6ckl] %%
=======================================
% Promoting a Replica Site %
=======================================
Type Instance name Hostname DBname
-------- ---------------- ----------------- ---------
Replica testserver.rsa.net testserver.rsa.net u7fi6ckl
FOR INTERNAL USE ONLY.
Do not use this utility for promotion without guidance from customer support. Please follow the documentation and use the Operations Console instead.
Are you sure you want to promote this replica (Y/N): Y
%% Starting configuration
-- Cleaning configuration data before starting promotion
-- Status: Cleaning up for promotion
%% Promoting a replica
-- Status: Deleting errors in the error queue at [u7fi6ckl]
-- Status: Configuring replica to a primary
Done...
-bash-3.00$
Related Articles
How to connect an existing Web Tier to a newly promoted Primary 58Number of Views Dynamic seed provisioning fails after replica promotion 109Number of Views Promotion for Maintenance 107Number of Views Promotion for Maintenance 2Number of Views Promotion of a RSA Authentication Manager 8.1 replica fails 532Number of Views
Trending Articles
Passwordless Authentication in Windows MFA Agent for Active Directory – Quick Setup Guide RSA Authentication Manager 8.9 Release Notes (January 2026) RSA Authentication Manager Upgrade Process RSA Authentication Manager 8.7 SP2 Setup and Configuration Guide An example of SSO using SAML and ADFS with RSA Identity Management and Governance 6.9.x