Authentication Manager 8.x upgrade fails with error "Failed to launch the update installer to apply the update"
2 years ago
Originally Published: 2023-07-20
Article Number
000068231
Applies To
RSA Product Set:  SecurID
RSA Product/Service Type:  Authentication Manager
RSA Version/Condition:  8.x
Issue

An upgrade to Authentication Manager 8.x fails with the following error:

Configuration step UpdateInstaller:launch [FAILED]
Error: Failed to invoke update engine: Failed to execute config goal
[INFO] Unmounting device ISO from /tmp/rsa_update/iso.
[INFO]
Failed to launch the update installer to apply the update AM 8.7.


This message is seen if /opt/rsa/am/server/pending/config.xml is in the directory when the installer tries to create it.
 

Resolution
To get the upgrade to complete you must delete the /opt/rsa/am/server/pending/config.xml when it is created during the upgrade. With thousands of lines of code written during the install, it is easier to run a simple command to see when the file is created that to watch the progress of the install through the Operations Console GUI.

One option is to SSH to the server and run repeated ls commands. To simplify the process, use the Linux watch command to see when the config.xml file is written to the directory.  

To watch for the file and remove it,
  1. Open two SSH sessions to the server. Navigate to /opt/rsa/am/server/pending for both of them.
  2. Confirm that config.xml does not exist.
  3. On the first SSH session, run the command watch "ls config.xml" (with the double quotes) then press Enter. You will see:

     Every 2.0s: ls config.xml
     ls: cannot access 'config.xml': No such file or directory

 
image.png

4. Now open the Operations Console and start the install.
5. As the install progresses, the config.xml will be created. In the first SSH session you will see output change to list the file name.

 
image.png
6. In the second SSH session, delete the config.xml (rm config.xml).
7. In the first SSH session, use Ctl+C to end the watch command. Or leave it up and you can see the new config.xml is created.
8. Let the installer complete.