Installing Legal Hold

To use Relativity Legal Hold, you need to install the following Relativity applications:

  • Relativity Legal Hold - install this application to one or multiple workspaces.
  • Portal - you only need to install this application to one workspace. Once installed, the Portal creates prerequisites and global custom pages used by the Legal Hold application in other workspaces with Legal Hold installed.

Use the following procedures to install Legal Hold:

  1. Install Legal Hold and the Portal applications from either the Application Library or an external file. See Installing Legal Hold.
  2. Add the Legal Hold Agent. See Adding the Legal Hold agent.
  3. Configure Legal Hold. See Accessing and configuring Legal Hold.

This page contains the following information:

Installing Legal Hold

Relativity Legal Hold Server 2021 is only compatible with Relativity Server 2021. See the Relativity Server 2021 Pre-installation for requirements. For a Legal Hold-only installation, the Relativity Base Template is recommended as the following features are not required:

  • Analytics server setup
  • Database server for processing or native imaging
  • Worker server for processing or native imaging
  • Obtaining applications for native imaging and processing

Since Legal Hold uses the ADS framework, you have the following options available for installing Legal Hold and the Portal in your environment:

Note: Remember that you only need to install the Portal application to one workspace in your environment.

Install Legal Hold from the Application Library

If you add the Legal Hold application and the Portal application to the Application Library, you can install them to the current workspace from the Application Library. See Relativity applications.

  1. Navigate to a workspace where you want to install the application.
  2. Click the Application Admin tab.
  3. Click New Relativity Application to display an application form.
  4. Click the Select from Application Library radio button in the Application Type section.
  5. Click in the Choose from Application Library field.
  6. Select Relativity Legal Hold on the Select Library Application dialog. This dialog only displays applications added to the Application Library. If Relativity Legal Hold is not included in the list, see Installing applications.
  7. Click Ok to display the application in the Choose from Application Library field. The application form also displays the following fields:
    • Version - displays the version of the application that you are installing.
    • User-friendly URL - displays a user-friendly version of the application's URL. This field may be blank.
    • Application Artifacts - displays object types and other application components.
  8. Click Import to install Legal Hold into the workspace.
  9. Review the import status of the application. Verify that the install was successful or resolve errors. See Viewing import status and Troubleshooting application installation errors.

Adding the Legal Hold agent

After you install Legal Hold, add the Relativity Legal Hold Agent by going to the Agents tab in the Admin level and clicking New Agent. Add at least one Legal Hold agent and one Legal Hold Preservation agent, if using preservation holds, per environment. Add more as needed.

Verify the Enable column displays Yes for the Relativity Legal Hold Agent. See Relevant Relativity documentation.

Agent name Requirement information Function Agent type
Relativity Legal Hold Agent At least one per environment. Note: You can add more agents to allow simultaneous jobs to run. You may also need more agents if you frequently multitask several Legal Hold actions at once (project deletions, send emails). Sends emails (including reminder and escalation), pulls emails in from custodian responses and purges custodians from a project. Multiple-installation
Relativity Legal Hold Preservation Agent At least one per environment. Note: If multiple preservations are to be created, create more than one preservation agent.

Performs all Microsoft 365 Preservation-related work.

The agent creates an Microsoft 365 eDiscovery Case, holds and assigns mailboxes and OneDrive URLs of corresponding Custodians. The agent job removes corresponding Custodians from O365 Hold.

Agent job deletes corresponding O365 Case when Project is closed.

Agent job collects information about existing legal hold and O365 holds and updates state and property information in Legal Hold.

Agent job sends alert per settings if any modifications found on O365 site which does not correspond to RLH settings.

Agent job sends emails per settings if Custodian is placed/removed on/off Hold.

Agent job for preservation in place manager is created on application install or upgrade and refreshed when Preservation Case Environment RDO is saved to update Agent run interval.

Multiple-installation

Accessing and configuring Legal Hold

Once you've installed Legal Hold and the Portal, you should see the following Legal Hold application tabs in your workspace:

Note: Legal Hold 10 includes all tabs available with a base Relativity install.

  • Entities
  • Legal Hold
    • Projects
    • Communications
    • Reports
    • Question Responses
    • Mailbox
  • Libraries
    • Questionnaires
    • Questions
    • Attachments
    • Scheduled Reports
  • Hold Admin (Relativity tab)
    • Legal Hold Settings
    • Global Reminder
    • Roles

Legal Hold template

Legal Hold ships with a default template entitled, Legal Hold Template in the Legal Hold > Projects tab. You can create a new project from scratch or use this template to customize your new project.

When creating a project from a template, the following items carry over:

  • Project details - this includes all of the Project response level fields.
  • Associated communications with details - the template includes the following communications:
    • Acknowledge Email Template - an example communication that includes an acknowledge email merge field inside the body of the text for a custodian to acknowledge the legal hold without further navigation.
    • Alert Notice Template - an example communication that notifies anyone in the Alert Group that a custodian might have potential involvement in a legal hold or matter.
    • Legal Hold Notice Template - an example communication that notifies custodians of an anticipated (or actual) legal hold and contains a link to the custodian portal where the custodian can acknowledge their participation in the hold or that they've received the notice.
    • Legal Hold Release Notice - an example communication that notifies on-hold custodians that they have been released from the hold or project.
  • Associated questionnaires - the Legal Hold Notice Template communication contains the Legal Hold Questionnaire Template questionnaire that ships with the template. This questionnaire contains typical questions that a company might want to collect information from a custodian, such as whether they had prior knowledge of the hold, or if they have access to electronic documents that may pertain to the hold.

Note: Legal Hold preserves item-level security on the above items for the new project, including communication(s) and questionnaire(s). See Managing workspace security.

Note: In order for a user to create a project from a template they must have edit rights on the project object.

Configuring Legal Hold

To configure Legal Hold, access the Settings tab. For more information, see Hold Admin tab.

Managing workspace security

The Legal Hold application security is set at the workspace and item level. See Security and permissions on the documentation site.

We recommend configuring the security permissions on your Legal Hold workspace as soon as you install Legal Hold. See Projects for more information.

For a Relativity Legal Hold user to run and complete a project, certain permissions need to be set. See the table below for the security permissions to run a Legal Hold project.

Object Security Tab Visibility Other Settings
  • Attachments – View, Edit, Add
  • Communication – View, Edit, Delete, Add
  • Entity – View, Add
  • Custodian Role – View, Edit, Delete, Add
  • Custodian Status – View, Edit, Delete, Add
  • Field – View, Add
    • Add Field Choice By Link
  • Global Reminder – View, Add
  • Job Schedule - View, Edit, Delete, Add
  • Legal Hold Application Permissions – View
    • Select all check boxes
  • Preservation Case – View, Add
  • Preservation Case Source – View, Edit, Delete, Add
  • Preservation Custodian Hold – View, Edit, Delete, Add
  • Preservation Custodian Status – View, Edit, Delete, Add
  • Preservation Hold Settings – View, Edit, Delete, Add
  • Preservation Source – View, Edit, Delete, Add
  • Preserve Product – View, Edit, Delete, Add
  • Preserve Product Source – View, Edit, Delete, Add
  • Project – View, Edit, Delete, Add
  • Question – View, Edit, Delete, Add
  • Questionnaire – View, Edit, Delete, Add
  • Questionnaire Question – View, Edit, Delete, Add
  • Questionnaire Response – View, Edit, Delete, Add
  • Questionnaire Response Answer – View
  • Report – View, Edit, Delete, Add
  • Schedule Report – View, Add
  • Scheduled Communication - View, Edit, Delete, Add
  • Entities
  • Legal Hold
    • Projects
    • Communications
    • Reports
    • Question Responses
    • Mailbox
  • Libraries
    • Questionnaires
    • Questions
    • Attachments
    • Scheduled Reports
  • Hold Admin
    • Legal Hold Settings
    • Global Reminder
    • Preservation Hold Settings
    • Roles
  • Admin Operations
    • View All Audits

When you install Legal Hold into a workspace, Relativity creates a Legal Hold Security Admins group. This group will have all Legal Hold permissions enabled by default. You can add users into this group. You will also be able to create new groups, or give existing groups, Legal Hold permissions by selecting the custom Legal Hold permissions. For more information on the Legal Hold permissions, see Projects.

Post-installation verification test

As a best practice, you should confirm that your Legal Hold application is functioning properly after an initial installation or an upgrade. We provide step-by-step instructions in the following Word document for performing a post-installation verification test in your Relativity environment.

Click here or the following image to download the Relativity Legal Hold Post-Installation Verification Test document.