

You can control the applications that workspaces contain by exporting, uninstalling, and deleting them. When you export an application, you have a file that you can use to import it into other workspaces. You can also uninstall or delete applications that you no longer want in a workspace.
This page contains the following information:
You can remove an application and all of its components from a workspace by uninstalling it. When you uninstall an application, Relativity deletes all child objects and associative objects, unless other applications or dependencies restrict their removal. Relativity also deletes any saved searches your application includes, but it doesn't remove the associated indexes from the workspace. This is because the indexes aren't part of the application. You must have the appropriate system admin permissions to lock or unlock an application. For more information, see Workspace security.
For example, you might need to uninstall an application that you accidentally deployed to a template case. If you want to remove only the application instance, or if you created an application that you haven't pushed to the library, you may want to delete it, rather than uninstall it. See Deleting applications.
Note: Applications installed via the Application Library can only be removed by System Administrators.
Use the following steps to uninstall an application.
To ensure optimum performance of Relativity, uninstall applications only during off-hours when users aren't actively reviewing documents in any workspaces.
The process of uninstalling an application deletes the same components that you would delete manually through the Relativity UI. When you delete components manually, Relativity provides you with the option to view a dependencies report. You can also view reports that provide information about object dependencies, and modifications to existing objects, that occur when you uninstall an application:
To view these reports, click Validate Components to Uninstall on the Component Summary page. See Uninstalling an application.
Relativity displays the view for the Relativity Applications tab after you click Uninstall Application on the Component Summary page. When an application fails to uninstall properly, Relativity locks the application and generates a list of errors that occurred during the uninstall process. The application also continues to appear in the list view of the Relativity Applications tab.
To view uninstall errors, click the application name in the list view to display the details page, and then click Show Errors.
When you uninstall an application, Relativity audits deleted and updated components. You can view this audit information from the History tab in a workspace by selecting the All History view and filtering on a specific action. In addition, you can view changes to specific objects by clicking View Audit on their details page.
If you want to disable auditing for update or delete actions during the uninstall process, set the AuditApplicationUninstallEnabled enabled instance setting to False.
You can uninstall custom pages that you develop for an application by manually deleting them from the IIS where the application is. You can only uninstall custom pages associated with applications that you push to the application library or that you install on a workspace.
To complete this task, you need permissions to the following machines:
Note: You should only uninstall custom pages when you don't want any workspace in your Relativity environment to use the application associated with them.
You need to know the GUID for the application to uninstall its custom pages deployed on the IIS. To determine the GUID, open Microsoft SQL Server Management Studio. Run this query on the ApplicationServer table in the EDDS. Replace YourApplicationName with the name of your application.
select Name, [GUID] from EDDS.eddsdbo.LibraryApplication where Name = 'YourApplicationName'
update edds.eddsdbo.ApplicationServer set State = 3 where AppGuid = 'YourApplicationGUID'
This statement sets the state of the custom pages to 3, which indicates that the custom pages should be ignored.
If you need to deploy the uninstalled custom pages, you can update their state to make them active. Run the following update statement on the ApplicationServer table in the EDDS. Replace YourApplicationGUID with the GUID assigned to your application.
update edds.eddsdbo.ApplicationServer set State = 0 where AppGuid = 'YourApplicationGUID'
This statement sets the state of the custom pages to 0, which redeploys them.
You can remove an application instance from a workspace by deleting it. When you delete an application instance, Relativity deletes child objects and unlinks associative objects. However, it doesn't delete the associative objects from the workspace. If you want to delete these objects referenced by the application, uninstall it. Deleting instead of uninstalling an application may be useful when building and testing an application that hasn’t been pushed to the application library. For complete details on uninstalling applications, see Uninstalling applications.
Use these steps to delete an application:
Why was this not helpful?
Check one that applies.
Thank you for your feedback.
Want to tell us more?
Great!