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
Promotion for Maintenance 107Number of Views Promotion of a RSA Authentication Manager 8.1 replica fails 530Number of Views How to connect an existing Web Tier to a newly promoted Primary 58Number of Views Dynamic seed provisioning fails after replica promotion 105Number of Views Real Time Rules not seen in Admin UI and-or Mitigator is not running in RSA Web Threat Detection 7Number of Views
Trending Articles
RSA Authentication Manager 8.9 Release Notes (January 2026) RSA MFA Agent 2.3.6 for Microsoft Windows Installation and Administration Guide Downloading RSA Authentication Manager license files or RSA Software token seed records RSA Release Notes for RSA Authentication Manager 8.8 Deploying RSA Authenticator 6.2.2 for Windows Using DISM