Skip to content

Uninstalling the File Access Manager Services

To uninstall the File Access Manager services:

  • Uninstall all the remaining services
  • Cleanup the remaining folders and registry keys

Server Stop/Start Process

File Access Manager servers need to be shut down and restarted in a specific order to ensure proper connectivity between services after the restart.

Shutdown Process

These services may be running individually on their own dedicated File Access Manager servers or may be on servers with shared services. These services or servers must be shut down in the following order:

Note

Disregard services that are not found in your environment, and proceed to the next service in the order shown here.

  1. Activity Monitors
  2. Permission Collectors and Data Classification Collectors
  3. Central Permission Collection and Central Data Classification
  4. RabbitMQ
  5. Event Manager and IIS
  6. Core and UI Services
  7. Elasticsearch
  8. Agent Configuration Manager (ACM)
  9. Scheduled Task Handler
  10. Microsoft SQL Server Database

Startup Process

Services or servers that were shut down in the order shown above must be restarted in this order:

Note

Disregard services that are not found in your environment, and proceed to the next service in the order shown here.

  1. Microsoft SQL Server Database
  2. Scheduled Task Handler
  3. Agent Configuration Manager (ACM)
  4. Elasticsearch
  5. Core and UI Services
  6. Event Manager and IIS
  7. RabbitMQ
  8. Central Permission Collection and Central Data Classification
  9. Permission Collectors and Data Classification Collectors
  10. Activity Monitors

Validation Steps

Follow these steps after restarting the services/servers to ensure that your environment is active and running normally:

  1. Open the File Access Manager Administrative Client and click on the Health Center. The Health Center should show GREEN on all the tabs.
  2. Refer to the appropriate application logs to ensure that the services were started without any errors.
  3. If the logs show any errors related to connectivity, restart that service through the services.msc window.
  4. If you still have difficulty in bringing any services up, contact SailPoint for further assistance.

Uninstalling Elasticsearch

Elasticsearch could be installed either on a dedicated server or on the main File Access Manager server.

You must use the Installation Wizard if you want to move the Elasticsearch database from one server to another. If the Elasticsearch database must be moved after installation, contact the File Access Manager Support Center.

  1. Open an elevated command line in Windows and run the following commands. After running the commands, close the cmd window:

    • "%SAILPOINT_HOME%\elasticsearch-5.1.1\bin\elasticsearch-service.bat" remove
    • setx JAVA_HOME "" -m

    Note

    There is no need to stop the Elasticsearch service before removing it.

    Note

    In some instances, the service will still be listed in the WIndows services even though it has actually been removed. A refresh, waiting a few minutes, or a reboot (in extreme cases) will update the services list. We can trust that it has indeed been deleted.

  2. From windows Programs and Features, uninstall the Java 8. This program was installed by the installer to support the Elasticsearch.

  3. Delete the folder "%SAILPOINT_HOME%\elasticsearch-5.1.1". This folder stores the Elasticsearch program and configuration files, but not the actual stored data.

  4. Execute the following update in the DB, to mark that the Elasticsearch database is uninstalled:

     declare @server_name nvarchar(100) = N'ELASTICSEARCH SERVER FQDN'
 delete
 FROM   [whiteops].[installed_service]
 WHERE  install_service_id = 20
 and    server_id = (select id from [whiteops].[install_server] where name = @server_name)

    ELASTICSEARCH SERVER FQDN - This value must be replaced with the FQDN of the server from which we we wish to uninstall the Elasticsearch.

  5. Delete the Elasticsearch data folder. Deleting this folder will delete all the activities it stores, so make sure you want to delete it. If you wish to reinstall Elasticsearch at a later time and use these data, do not delete this folder.

  6. If this instance of the Elasticsearch is on a dedicated server - Uninstall the Watchdog service from this server

    • Open the Server Installer.
    • Select Next till the Action Select page.
    • Select Uninstall File Access Manager Features from the current server.

    Important

    This procedure removes all services from this server, including the Server Installer itself.

    This opens the configuration summary page. In this case, the list of services will be empty. This is normal, since no services besides the watchdog are to be uninstalled.

  7. Select Next to start the uninstall process.

To reinstall Elasticsearch:

  1. Install Elasticsearch using the Server Installer.
  2. Restart the Event Manager services.

Note

If you do not delete the Elasticsearch data folder (described below), reinstaling the Elasticsearch will maintain all the data in the website as it was before Uninstalling.

Uninstall All the Remaining Services

This procedure removes all services from the server, including the File Access Manager website and the Server Installer itself.

  1. Open the Server Installer.
  2. Proceed to the Action Select page.
  3. Select Uninstall File Access Manager Features from the current server.
  4. Select Next to start the uninstall process.

Important

The File Access Manager Agent Configuration Manager service must be the last service to be removed. It should be removed after the collectors are uninstalled.

If collectors or other services are still installed, the Server Installer will display an error message indicating that the services must be removed first.