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
Dynamic seed provisioning fails after replica promotion 109Number of Views Promotion of a RSA Authentication Manager 8.1 replica fails 532Number of Views RSA Silvertail - RSA WTD: how to capture support snapshot from command line 28Number of Views Promotion for Maintenance 110Number of Views RSA Authentication Manager 8.6 Azure Virtual Appliance Getting Started 12Number of Views
Trending Articles
Troubleshooting RSA SecurID Access Identity Router to RSA Authentication Manager test connection failures RSA SecurID Software Token 5.0.2 Downloads for Microsoft Windows RSA Authentication Manager 8.9 Release Notes (January 2026) RSA Governance & Lifecycle 8.0.0 Administrators Guide Quick Setup Guide - Passwordless Authentication in Windows MFA Agent for Active Directory