Knowledgebase:
Uninstall Process for Various FileCatalyst Direct and Workflow Products
Posted by Aly Essa, Last modified by Aly Essa on 04 August 2016 11:08 AM

Overview

This article will give you a brief summary on how to uninstall various FileCatalyst Products in Linux, Mac OSX, and Windows Environments.

 

Environment

FileCatalyst Server v3.4 and later.

FileCatalyst HotFolder v3.4 and later.

FileCatalyst TransferAgent v3.5 and later.

FileCatalyst  Central v3.5 and later.

FileCatalyst Workflow v4.9 and later.

FileCatalyst Webmail v4.9 and later.
 

Resolution

Note: You may need elevated access to perform some of these commands

FileCatalyst Server

  1. Windows:
    1. Shutdown all the standalone FileCatalyst Server Remote Admin Application.
    2. Open the Services Manager by clicking on Start, search for Services.msc, and then running the application.
    3. Locate the FileCatalyst Server Service and click Stop.
    4. Open Control Panel from the Start menu then navigate to Programs and Features.
    5. Click on the FileCatalyst Server and hit Uninstall.
    6. Check the box to Force Deletion of C:\path\to\FileCatalyst Server\ when prompted.
    7. Hit Uninstall.

  2. Linux:
    1. If you are running the FileCatalyst Server stand-alone, such as ./fc_server.sh or ./fc_server_console.sh, FileCatalyst Server Admin (running stand-alone) will need to closed.
    2. Close the FileCatalyst Server Remote Admin Application, if it is open.
    3. Open a new Terminal window.
    4. Navigate to the folder where your server is installed. Typically the path used is /opt/utechsoft/server/.
    5. Execute the command:

      ./fc_server_shutdown.sh

    6. Verify the Service is stopped by running the command:

      ps -ef | grep -i "filecatalystserver"

    7. If you are running the FileCatalyst Server as a Service, stop the service by using the appropriate command needed for your version of Linux in the terminal window. For our example we use:

      service fcserver stop

    8. Remove the Service by navigating to the service_wrapper folder located within the Server installation folder. A sample path would look like /opt/utechsoft/server/service_wrapper/.
    9. Run the command ./uninstall.sh.
    10. You can now remove the folder structure by using the following command:

      rm -rf /opt/utechsoft/server/

  3. Mac OSX:
    1. Exit the FileCatalyst Server Remote Admin Application.
    2. Click to open the FileCatalyst Server in System Preferences located under the Apple menu.
    3. To stop the currently running service, click Stop Filecatalyst Server Service. You may be prompted to enter elevated user account credentials.
    4. To uninstall the FileCatalyst Server Service, uncheck the box labeled Start FileCatalyst Server on Start Up.
    5. Return to System Preferences and right-click on the FileCatalyst Server icon. Click remove from panel.
    6. From the Finder window and click on Applications.
    7. Find FileCatalystServer.app, right-click on it and delete it.
    8. Find FileCatalystServerAdmin.app and delete it as well.
    9. Use Finder to access the Library folder and open Application Support.
    10. Delete the Filecatalyst folder. A sample path would be /Library/Application Support/FileCatalyst/.

FileCatalyst  Hotfolder

  1. Windows:
    1. If you are running FileCatalyst HotFolder stand-alone, from File menu select the Exit FileCatalyst HotFolder option.
    2. If you are running FileCatalyst HotFolder as a service, click on Start, search for Services.msc, and run that application.
    3. Find the Hotfolder Service and stop it.
    4. Open Control Panel from the start menu and navigate to Programs and Features.
    5. Locate FileCatalyst Hotfolder and click uninstall
    6. Check the box to Force Deletion of C:\path\to\FileCatalyst HotFolder\ when prompted.
    7. Hit Uninstall.

  2. Linux:
    1. If you are running the FileCatalyst HotFolder stand-alone, such as ./fc_hotfolder.sh or ./fc_hotfolder_console.sh, FileCatalyst HotFolder Admin (running stand-alone) will need to closed.
    2. Close the FileCatalyst HotFolder Remote Admin Application, if it is open.
    3. Open a new Terminal window.
    4. Navigate to the folder where your FileCatalyst HotFolder is installed. Typically the path used is /opt/utechsoft/hotfolder/.
    5. Execute the command:

      ./fc_hotfolder_shutdown.sh

    6. Verify the Service is stopped by running the command:

      ps -ef | grep -i "filecatalyst"

    7. If you are running the FileCatalyst HotFolder as a Service, stop the service by using the appropriate command needed for your version of Linux in the Terminal window. For our example we use:

      service fchotfolder stop

    8. Remove the Service by navigating to the service_wrapper folder located within the FileCatalyst HotFolder installation folder. A sample path would look like /opt/utechsoft/hotfolder/service_wrapper/.
    9. Run the command ./uninstall.sh.
    10. You can now remove the folder structure by using the following command:

      rm -rf /opt/utechsoft/hotfolder/

  3. Mac OSX:
    1. Exit the FileCatalyst HotFolder Remote Admin Application.
    2. Click to open the FileCatalyst HotFolder in System Preferences located under the Apple menu.
    3. To stop the currently running service, click Stop Filecatalyst HotFolder Service. You may be prompted to enter elevated user account credentials.
    4. To uninstall the FileCatalyst HotFolder Service, uncheck the box labeled Start FileCatalyst HotFolder on Start Up.
    5. Return to System Preferences and right-click on the FileCatalyst HotFolder icon. Click remove from panel.
    6. From the Finder window and click on Applications.
    7. Find FileCatalystHotFolder.app, right-click on it and delete it.
    8. Find FileCatalystHotFolderAdmin.app and delete it as well.
    9. Use Finder to access the Library folder and open Application Support.
    10. Delete the Filecatalyst folder. A sample path would be /Library/Application Support/FileCatalyst/.

FileCatalyst TransferAgent

  1. Windows:
    1. Close FileCatalyst TransferAgent by right-clicking the tray icon and exiting the application.
    2. Open Control Panel from the start menu and navigate to Programs and Features.
    3. Locate FileCatalyst TransferAgent and click uninstall
    4. Check the box to Force Deletion of C:\path\to\FileCatalyst TransferAgent\ when prompted.
    5. Hit Uninstall.

  2. Linux:
    1. Close the FileCatalyst TransferAgent if it is open.
    2. Open a new Terminal window.
    3. Navigate to the folder where your FileCatalyst TransferAgent is installed. Typically the path used is /opt/utechsoft/trasnferagent/.
    4. Verify that there are not other instances of TransferAgent running by executing the command:

      ps -ef | grep -i "filecatalyst"

    5. You can now remove the folder structure by using the following command:

      rm -rf /opt/utechsoft/transferagent/

  3. Mac OSX:
    1. Quit the FileCatalyst TransferAgent Application.
    2. From the Finder windows and click on Applications.
    3. Find FileCatalystTransferAgent.app, right-click on it and delete it.
    4. Use Finder to access the Library folder and open Application Support.
    5. Delete the Filecatalyst folder. A sample path would be /Users/Admin/Library/Application Support/FileCatalyst/.

FileCatalyst Central

  1. Windows:
    1. Open the Services Manager by clicking on Start, search for Services.msc, and then running the application.
    2. Locate the FileCatalyst Central Service and click Stop.
    3. Open Control Panel from the Start menu then navigate to Programs and Features.
    4. Click on the FileCatalyst Central and hit Uninstall.
    5. Check the box to Force Deletion of C:\path\to\FileCatalyst Central\ when prompted.
    6. Hit Uninstall.

  2. Linux:
    1. Open a new Terminal window.
    2. Navigate to the folder where your FileCatalyst Central is installed. Typically the path used is /opt/utechsoft/central/.
    3. Execute the command:

      ./fc_central_stop.sh

    4. Verify the Service is stopped by running the command:

      ps -ef | grep -i "filecatalyst"

    5. If you are running the FileCatalyst HotFolder as a Service, stop the service by using the appropriate command needed for your version of Linux in the Terminal window. For our example we use:

      service fc_central stop

    6. Remove the Service by navigating to the service_wrapper folder located within the FileCatalyst Central installation folder. A sample path would look like /opt/utechsoft/central/service_wrapper/.
    7. Run the command ./uninstall.sh.
    8. You can now remove the folder structure by using the following command:

      rm -rf /opt/utechsoft/central/

FileCatalyst Workflow/Webmail

  1. Windows:
    1. Open the Services Manager by clicking on Start, search for Services.msc, and then running the application.
    2. Locate your Web Server (Tomcat, IIS, etc.) and stop the respective service.
    3. Using Windows Explorer, navigate to the Web Root location. A sample path would be C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\.
    4. Delete the workflow or webmail folder that was published to the Web Server.
    5. Delete the workflow.war or fcweb.war file in the Web Root location.
    6. Navigate to your workflow-config (or fcweb-config) folder and delete it. A sample path of this location is C:\workflow-config\.

  2. Linux:
    1. Open a new Terminal window.
    2. Stop the service that controls your Web Server (Tomcat).
    3. Verify the Service is stopped by running the command:

      ps -ef | grep -i "java"

    4. Navigate to your Web Server Root directory, we have used /opt/tomcat/webapps/ for this example.
    5. Delete the workflow or webmail folder that was published to the Web Server by running:

      rm -rf /opt/tomcat/webapps/workflow/ or rm -rf /opt/tomcat/webapps/webmail/ 

    6. Remove the workflow.war and webmail.war from /opt/tomcat/webapps/ directory.
    7. Navigate to your workflow-config (or fcweb-config) folder and delete it. A sample command would be:

      rm -rf /opt/tomcat/workflow-config/ or rm -rf /opt/tomcat/webmail-config/
       
  3. Mac OSX:
    1. Shutdown your Web Server by using System Preferences.
    2. Locate the Web Server you are using and shutdown the service.
    3. Use Finder to search for your workflow or webmail deployment folder. It will be located in your Web Server Root location.
    4. Delete the workflow or webmail folder once it is located.
    5. Search for fcweb.war or workflow.war in Finder and delete those files.
    6. Located your workflow-config or fcweb-config folder in Finder and delete it.