000037455 - Steps for reinstalling Access Fulfillment Express (AFX) in RSA Identity Governance & Lifecycle when troubleshooting AFX issues

Document created by RSA Customer Support Employee on May 9, 2019
Version 1Show Document
  • View in full screen mode

Article Content

Article Number000037455
Applies ToRSA Product Set: Identity Governance & Lifecycle
RSA Version/Condition: 7.x
IssueWhen troubleshooting AFX issues for existing AFX installations that were previously working, RSA Support may ask you to reinstall AFX. This article outlines the steps for reinstalling AFX.

Steps for reinstalling an AFX server in RSA Identity Governance & Lifecycle

  1. Log on to RSA Identity Governance & Lifecycle.
  2. In the User Interface, go to AFX > Servers and select the AFX Server name.
  3. On the AFX Server page, click on the Download Server Archive button to download the AFXServer.zip file.

User-added image

  1. Connect to the AFX server machine using the afxuser account.
  2. Stop the AFX server:

$ afx stop

  1. Change directory to the afxuser home directory.

$ cd /home/afxuser

  1. Rename the original AFX folder to AFX-backup or some other name of your choosing.

$ mv AFX AFX-backup

  1. Copy the AFX Server archive that was downloaded from the RSA Identity Governance & Lifecycle console to the afxuser home directory on the AFX server machine (/home/afxuser)
  2. Change directory to the afxuser home directory.

$ cd /home/afxuser

  1. Expand the AFX Server archive. 

$ unzip AFXServer.zip

  1. An AFX directory is created in the afxuser home directory (that is, /home/afxuser/AFX) containing the server files.
  2. Change to the AFX directory 

$ cd /home/afxuser/AFX

  1. Execute the setPerms.sh script located in /home/afxuser/AFX/bin to set file permissions. For example,

$ sh bin/setPerms.sh

  1. Start the AFX server.

$ afx start

  1. Launch the RSA Identity Governance & Lifecycle User Interface and check the status of the AFX Server and AFX Connectors and make sure they are in a Running state.