First-time installation

Download Quick Guide

Requirements

  • Important! - Blackout 5.0 supports only Server 2022 and Server 2023
    • Relativity Server 2024 support pending final Relativity Server 2024 release.
  • All browsers supported by Relativity Server 2022 and Server 2023
  • Must be installed from the Relativity system admin application library

What to expect

What you'll see

  1. Installation should only take a few minutes
  2. A new tab named "Blackout" has been added to the Relativity admin section
  3. A new schema will be added to EDDS called Blackout
    • Blackout tables will be created using this schema in EDDS
  4. Several configurations will be added to the Relativity configuration table under the section Milyli.Blackout

SQL version support

Note: Blackout 4.8 and above, requires SQL Server 2016 with compatibility mode set to at least 130. To check the compatibility mode level of your SQL Server, you can run the following query:

SELECT name, compatibility_level FROM sys.databases WHERE [name] = 'EDDS';

To update the compatibility mode level, please follow these steps:

  1. Connect to your SQL Server using SQL Server Management Studio.
  2. Right-click on the EDDS database and select Properties.
  3. In the Select a page pane, click Options.
  4. In the Compatibility level drop-down list, select the desired compatibility level.
  5. Click OK to save the changes.

Alternatively, the compatibility mode can be updated using the following SQL script:

ALTER DATABASE [EDDS] SET COMPATIBILITY_LEVEL = 130;

Installing Blackout

Before you begin

  1. Ensure that you have received the Blackout RAP file shared with you from Milyli’s secure file sharing platform.
    • If you have not received the RAP, please contact support@milyli.com.
    • The file will be delivered by Milyli’s instance of Citrix ShareFile.
  2. Blackout must be installed through the admin level Relativity application library.
    • Ensure that you have access before beginning

How to install Blackout

  1. Navigate to the Application & Scripts | Application Library tab in the Relativity Admin section.
  2. Click Upload Application.
  3. Click Choose File.
  4. Select the Blackout RAP and click the Open button.
  5. After the file uploads, click the Save button.
  6. Next to Workspaces installed click the Install button.
  7. Click the ... button next to Workspaces.
  8. Check any workspaces where Blackout may need to be installed.
  9. Click Ok.
  10. Click the Save button.

Submitting a license request

After successfully installing Blackout, a license request must be generated to retrieve a valid license from Milyli.

  1. Navigate to the Blackout | Configuration tab in the Relativity admin section.
  2. Click on Generate License Request.
  3. Click Copy License Request.
  4. Submit the license request body to support@milyli.com.
  5. Milyli will supply a license key in response.
  6. Click on Apply License.
  7. Paste the license key in the box.
  8. Click Apply Blackout License.

Pushing Blackout to a workspace

After applying the license Blackout can be installed into any workspace that you require.

Note: It is required to push Blackout to workspaces via the Application Library.

  1. Navigate to the Application & Scripts | Application Library tab in the Relativity Admin section.
  2. Filter for the Blackout Application and select it.
  3. Next to Workspaces installed click the Install button.
  4. Click the ... button next to Workspaces.
  5. Check any workspaces that Blackout needs to be installed on.
  6. Click Ok.
  7. Click the Save button.

How to Install Blackout Agents

  1. Navigate to the Blackout tab then choose Agent Configuration.
  2. Identify the desired agent server and select the Enabled checkbox.
  3. Specify worker allocation:
    • Assign the number of Project Workers and Viewer Workers for that server.
    • By default, both work types are enabled.
  4. Click Save Configurations.

Blackout will automatically deploy the agents with the configured worker counts.

Blackout Resource Pool Aware Screenshot

Verifying Agent Installation

The status of the agent can be verified by:

  1. Go to Server & Agent Management tab then choose Agents.
  2. Filter the Application column to Blackout.
  3. The Enabled column should read Yes. The Message column displays active worker counts.
← Version support policyUpgrading Blackout →