Promote a replica from the command line - RSA Authentication Manager 7.1
2 years ago
Originally Published: 2014-08-12
Article Number
000065044
Applies To
RSA Authentication Manager 7.1
Issue
How to promote a replica using rsautil from the command line.
A replica server has to be promoted due to failure of the primary server.
Resolution

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.


Notes

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$