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
Authentication Manager Log Messages (26111-26150) 37Number of Views How to connect an existing Web Tier to a newly promoted Primary 58Number of Views Customer getting collected on every login to FI website 3Number of Views Dynamic seed provisioning fails after replica promotion 109Number of Views Promotion of a RSA Authentication Manager 8.1 replica fails 532Number of Views
Trending Articles
Downloading RSA Authentication Manager license files or RSA Software token seed records RSA MFA Agent 2.3.6 for Microsoft Windows Installation and Administration Guide Quick Setup Guide - Passwordless Authentication in Windows MFA Agent for Active Directory Mandatory Certificate Upgrade Required by 6th October 2025 for RSA MFA Agent for PAM, RSA MFA Agent for Apache, and Third … RSA Authentication Manager 8.9 Release Notes (January 2026)