

Note: Workspace Portal application no longer needs to be manually installed for RelativityOne instances. In RelativityOne instances, you will access workspaces in other connected instances from the Workspaces tab.
In Relativity, a workspace provides a secure data repository for documents used in cases or for applications developed with Dynamic Objects. Workspace portal refers to a Relativity application that enables you to view all your workspaces from a single tab that exists in both your primary Relativity Server instance and a satellite RelativityOne instance in the cloud. You can navigate between the instances seamlessly using single sign-on, and easily create and edit new workspaces in either environment.
Configuring a firewall or other network and security changes may be required if you have a non-standard connection for making your Server instance publicly visible.
For the workspaces tab feature to function correctly, your primary instance needs to establish communication with the duplicate instance using port 443.
To successfully use the workspace portal, ensure that each of your instances is configured to use the HTTPS protocol. We recommend setting up an authentication provider in both the primary and duplicate instances for a seamless experience with single sign-on (SSO) capability. Without SSO, you will need to log in each time you switch between the primary and satellite instances.
To ensure the User Group Synchronization feature works correctly, your primary instance needs to communicate with the duplicate instance using port 443.
This functionality is available only for customers running supported Relativity versions and having at least one RelativityOne instance.
Supported versions include:
Note: Workspace Portal application no longer needs to be manually installed for your RelativityOne instances. In RelativityOne instances, you will access workspaces for connected instances from the Workspaces tab.
The Workspace portal application must be installed in both the primary and duplicate instances. You can find the Workspace portal application files in the Application Library. Install Workspace Portal (Master) to your primary instance and Workspace Portal (Duplicate) to your duplicate instance.
Once you install the application, you will see a new Workspace Portal tab in your instance.
Note: If you install the RelativityOne Activity Dashboard, the Workspace Portal tab will become a child tab nested under the RelativityOne Home tab.
If Workspace Portal was previously installed and you need to upgrade the application, follow the steps of the scenario that best matches your circumstances.
When upgrading from Relativity 9.7 or above, the Workspace Portal application automatically upgrades. No manual steps are required.
To upgrade Workspace Portal from Relativity 9.6 or below:
If you are not able to disconnect duplicate instances from the Connected Instances list and an error displays, delete the instance through SQL.
To upgrade Workspace Portal while you are on Relativity 9.7 or higher:
To upgrade Workspace Portal while you are on Relativity 9.6 or below:
<script> <name>WP Toggle Secret Manager</name> <description>Workspace Portal Toggle Secret Manager App</description> <category>Workspace Portal</category> <input orientation="horizontal"> <constant id="_enabled" name="Is Enabled" type="text"> <option>1</option> <option>0</option> </constant> </input> <display type="itemlist" /> <action returns="table"><![CDATA[ UPDATE eddsdbo.Toggle SET IsEnabled = #_enabled# WHERE [Name] = 'kCura.FederatedWorkspaceList.Core.Toggles.WorkspacePortalDecryptClientId' SELECT * FROM #MasterDatabasePrepend#Toggle WHERE [Name] = 'kCura.FederatedWorkspaceList.Core.Toggles.WorkspacePortalDecryptClientId' ]]></action> </script>
Follow the steps in this section if
To set up workspace portal:
Please have the following actions completed before proceeding with configuration steps:
This scenario has the following requirements:
Note: Please ensure that you complete the steps in the order listed.
Note: If you have already set up an OAuth2 Client for User and Group Synchronization, and have the Client ID and Client Secret generated for that, you can use the existing OAuth2 client, and skip to step 2.
Note: This will be the only point at which you can copy the generated Client Id and Client Secret.
Note: RelativityOne admins should contact Support to have them create this instance setting in their duplicate instance.
Note: Once you install the application, you will see a new Workspace Portal tab in your primary instance.
This scenario has the following requirements:
Note: Please ensure that you complete the steps in the order listed.
Note: Once you install the application, you will see a new Workspace Portal tab in your primary instance.
Note: If you have already set up an OAuth2 Client for User and Group Synchronization, and have the Client ID and Client Secret generated for that, you can use the existing OAuth2 client, and skip to step 3.
Note: This will be the only point at which you can copy the generated Client Id and Client Secret.
Create the instance connection referencing the Relativity Server duplicate instance and the OAuthClient that was set up in your duplicate instance.
The following minimum instance-level security permissions are required to use the Workspace Portal. Users must be part of a group that is added at the instance level.
Object security | Tab visibility | Admin operations |
---|---|---|
|
|
|
For new groups that you want to grant access to Workspace Portal, add item-level security permission to the SMTPPassword instance setting.
Note: Workspace portal will only display the workspaces that you have View permissions for.
Workspace portal gives you access to all workspaces between your Relativity Server and your RelativityOne instances from a single tab. The available list of workspaces displays in the grid below the search, and you can access favorited or recently used workspaces via the Pinned and Recent workspaces links in the heading of the table.
Note: Only users who have access to both the primary and duplicate instance will be able to view workspaces from both instances.
For Pinned workspaces, you can drag and drop the workspace thumbnails to reorder them in the ribbon at the top and you also have the ability to display pinned workspaces from a specific instance in a certain color by setting an Instance Color for the instance. This can help users tell which instance a workspace is from at a glance.
You can easily navigate back to your primary instance at any time by clicking on the icon that displays to the right of the Relativity logo at the top left corner of your screen (this button is only available for RelativityOne and Relativity 9.5.219.30and above).
Clicking into the menu to the right of the New Workspace menu lets you access the Relativity workspace views that you have access to within your local instance.
To search for a specific workspace in your list, you can enter matching keywords in the Search textbox at the top. Matching workspaces display as you type in the pop-up list below. Click on a workspace in the list to navigate to it or tap Enter to navigate to the currently selected workspace at the top of the list.
Note: The Workspace Portal search bar displays the same results as the QuickNav menu (e.g., matching Favorites, Workspaces, and Admin tabs).
You can also sort and filter the list of workspaces below by using standard Relativity item list functionality.
You can perform the following additional actions from the Workspace Portal tab:
Note: The Manage Instance Connections icon ( ) is only available to Relativity system admins.
Click the Connect an Instance icon ( ) to link a new instance to the current instance. See Setting up Workspace Portal in Relativity Server instances for more information on how to connect a new satellite instance.
Note: Only users who have access to both the primary and duplicate instance will be able to connect a new instance.
Click the () icon to edit or delete instances. Click the (
) icon to edit an existing registered instance connection or the (
) icon to delete a registered instance connection. When editing the current instance, you can select a Custom Name to display for workspaces associated with that instance instead of the Instance Name.
Note: If you are using the User and Group Synchronization application, we only recommend 1 satellite instance for every primary instance.
On this page
Why was this not helpful?
Check one that applies.
Thank you for your feedback.
Want to tell us more?
Great!