Law2CM Installation Guide
DISCLAIMER
Any advice FYB provide in relation to setting up any FYB App, FYB Add-in, FYB Connector and or advice in relation to opening access to your on-premises or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not consider your network setup, network infrastructure or any security requirements that you may have or in fact need. It is highly advised that you seek advice from internal or external providers to ensure that they are comfortable with what is required prior to going ahead with any deployment, setup, or configuration for external access.
AUTHENTICATION
FYB Law2CM does not support Windows Authentication.
OpenID Connect Authentication must be used for both FYB Law2CM and the Content Manager ServiceAPI, with matching providers.
FYB Law2CM officially supports EntraID and has not been tested against any other Authentication provider.
LICENSE DETAILS
Please contact FYB for a valid license if you are yet to obtain one for your Connector.
CONTENT MANAGER SERVICE API CONFIGURATION
-
Navigate to the C:\Program Files\Micro Focus\Content Manager\Service_API folder
-
Open the hptrim.config file.
-
Ensure the following is set with the openIdConnect section:
- identityClaims is set to email upn preferred_username oid
- appIdURI is set to api://{clientID}

INSTALLATION COMPONENTS
The following installation components are required to ensure full functionality of FYB Law2CM:
- FYB Law2CM Connector transfers data from Lawcadia to Content Manager. This is a server-side installation.
INSTALLING FYB LAW2CM
LICENSE
-
Create a folder to house the license file (.lic) on the IIS Server
-
Place the license file in this folder
NoteNote down this location as it will be required later in the installation process.
PREREQUISITES INSTALLATION
Before running the MSI ensure that all prerequisites are complete. Including deploying the .NET 8 SDK and Hosting Bundle and installing IIS URL Rewrite.
.NET 8 SDK AND HOSTING BUNDLE
To deploy the Net Core SDK and Hosting Bundle to the server, follow these steps:
-
Install the latest .NET 8 SDK (x64) found here

-
Install the latest ASP.NET Core 8 Runtime Hosting Bundle found here

-
Once both executables have been installed, complete a full server restart to allow for .NET 8 to bind to IIS. If a server restart is not possible an IIS reset can be completed with the following commands from an elevated command prompt.
- net stop was /y
- net start w3svc
- iisreset
NoteTo check that the SDK has been attached to the hosting bundle, open Command Prompt and type dotnet --info

INSTALLATION
The FYB Law2CM MSI will:
- Deploy the installation files
- Setup the application pool and application in IIS
- Setup the temp folder
- Configure the application settings as specified by the user
To install Law2CM, follow these steps:
-
Run command prompt as an administrator and launch the Law2CM-100.msi
-
Click Next

-
On the Web Application Settings screen, select a Site to host the application and enter a name for the Virtual Directory
NoteThe site the connector is being installed underneath must be https protected and able to communicate outside your network.
-
Click Next

-
On the Application Pool Settings screen, enter the domain, username, and password for the Application Pool identity
-
Click Next

-
On the General Configuration Settings screen enter the required settings. Please refer to the table below for configuration settings details

NAME DESCRIPTION Dataset ID The two alphanumeric character dataset identifier. Service API URL The URL of your Content Manager Service API. License Path The local path to your license including the .lic file. Temp Path Temporary data storage location. -
On the Connection Settings screen enter the required settings. Please refer to the table below for configuration settings details.

NAME DESCRIPTION Lawcadia Instance The URL of the Lawcadia Instance that Law2CM will connect to. For example https://www.lawcadia.com API End Point The API Endpoint required to connect to the Lawcadia API. For example p1/api/v8 The Lawcadia Instance URLThe Lawcadia instance URL will always be https://www.lawcadia.com unless specified by Lawcadia when providing the instance.
-
Open ID Settings. The values of the required fields can be found in the respective Open ID guides. These can be found within the VALUES REQUIRED FOR INSTALLATION header of the respective Open ID guide.

FIELD DESCRIPTION Open ID Provider Choose an Open ID Provider. Client ID The Client ID of the selected Open ID provider Authority URL The Authority URL of the Open ID provider, in format https://login.microsoftonline.com/\{TENANT ID} Redirect URL The FYB Law2CM URL Certificate Friendly Name The friendly name of the nominated certificate (.pfx) installed on the machine. App Id URI api:// {Client ID} -
On the Email Configuration Settings screen enter the required settings. Please refer to the table below for configuration settings details

NAME DESCRIPTION Send To The email address that receives all email notifications when exceptions and errors occur. From Address The email address that sends the email notifications. Mail Host The hosting mail system that sends emails using the given From Address. Mail Port The Simple Mail Transfer Protocol port number. License Contacts The list of contacts that will receive an email notification when the Law2CM license is coming up to expiry. Multiple addresses can be inputted by placing a ';' between addresses. -
On the Custom Setup screen select the install location and click Next

-
From the Confirm Installation window click Install

-
The installation process will commence

-
Once the installation is complete click Finish

CONFIGURATION
IIS CONFIGURATION
After the installation process is complete, you will be able to locate the application installed within the site selected during installation.
-
From the Features View go to Authentication

-
Ensure that Anonymous Authentication is enabled and Windows Authentication and ASP.NET Impersonation are disabled.

-
Right click the application in IIS and select explore

-
Right click the app data folder and select properties

-
Navigate to the security tab and ensure users have read, write and modify permissions

-
Click on Application Pools
-
Within the application pool listing screen, right click on the Law2CM application pool and select the Advanced Settings option from the drop-down menu
-
Within the Advanced Settings window, set Idle Time-out Action to Suspend, Idle Time-out Action (minutes) to 0 and Start Mode to Always Running click the OK button

-
Select the Law2CM app in IIS and click on Basic Settings, and set Enable Preload to true

-
Complete a restart of the app pool for the settings to take effect
SERVICE API CONFIGURATION
The maximum size is 2 GB. See Uploading Large Files to IIS / NET. Core / ASP.NET for more information
The default document size that can be uploaded using the CM Service API is 4MB. To increase this:
- Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)
- Open the Web.config file as an Administrator
- In the httpRuntime element, add maxRequestLength="51200" and executionTimeout="7200" This value will allow for document uploads up to 50MB. Increase this value as required.
![]()
-
In the requestLimits element add maxAllowedContentLength="51200"

-
Save the changes.
MODIFY THE HPTRIM.CONFIG FILE
-
Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)
-
Open the hptrim.config file as an Administrator

-
Within the hptrim section, add ignorePropertyErrors = "true"
SERVICE API OPEN ID CONFIGURATION
-
Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)
-
Open the hptrim.config file as an Administrator

-
Navigate to the <add element within the <openidconnect> element
-
Set the identityClaims attribute to email upn preferred_username oid
-
Set the appIdURI value to api://{client Id value}. The value of the client Id is the same value provided to the clientID attribute

CONTENT MANAGER CONFIGURATION
DOCUMENT RECORD TYPE
The document record type for Law2CM will require for the document type to be contained on itself.
It is recommended to create a new record type 'Lawcadia Document'.

Ensure that the containment is set to allow for the containment of the Matter folder structure and the document record type

ADDITIONAL FIELDS
Three additional fields must be added to Content Manager for the connector.
| Name | Type | Applies To | Maximum Length |
|---|---|---|---|
| Law ID | string | Matter Folder | 255 |
| Law Document ID | string | Lawcadia Document | 255 |
| Matter ID | string | Matter Folder | 255 |
| Container Type | string | Matter Sub Folder | 255 |
| Document Type | string | Lawcadia Document | 255 |
-
Navigate to Content Manager Context, Search for ‘Additional Fields’ > All
-
Right click in the view pane and click New Additional Field

-
Select String as Data Format
-
Name the Additional Field Law ID
NoteThis must match the image below exactly

-
Click Next
-
The maximum length should be 255
-
Click Next, then click Finish

-
Add the additional field to any record types used by the connector
-
Repeat the above process for the other additional fields.
UNINSTALLATION
MANUAL UNINSTALL
To uninstall the Law2CM manually please follow the steps below:
-
Navigate to control panel
-
Click on Uninstall a program
-
Locate FYB Law2CM in the list of Programs and feature

-
Right click on FYB Law2CM and click on Uninstall
-
If a warning Prompt appears, click on the continue button

-
Click the Yes button

-
The uninstallation process will commence

-
Open IIS once the uninstallation process is completed
-
Locate Law2CM in IIS, right click and click Remove button

-
When the prompt appears click on the Yes button

