Skip to main content

Law2CM Installation Guide

Raise a support ticket

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​

  1. Navigate to the C:\Program Files\Micro Focus\Content Manager\Service_API folder

  2. Open the hptrim.config file.

  3. Ensure the following is set with the openIdConnect section:

    1. identityClaims is set to email upn preferred_username oid
    2. appIdURI is set to api://{clientID}

    2024-07-26_14-15-46.png

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​

  1. Create a folder to house the license file (.lic) on the IIS Server

  2. Place the license file in this folder

    Note

    Note down this location as it will be required later in the installation process.

PREREQUISITES INSTALLATION​

Warning

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:

  1. Install the latest .NET 8 SDK (x64) found here

    2024-06-21_15-04-14.png

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

    2024-06-21_15-05-11.png

  3. 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
    Note

    To check that the SDK has been attached to the hosting bundle, open Command Prompt and type dotnet --info

    2024-06-21_15-06-23.png

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:

  1. Run command prompt as an administrator and launch the Law2CM-100.msi

  2. Click Next

    2021-12-06_14-42-22.jpg

  3. On the Web Application Settings screen, select a Site to host the application and enter a name for the Virtual Directory

    Note

    The site the connector is being installed underneath must be https protected and able to communicate outside your network.

  4. Click Next

    image.png

  5. On the Application Pool Settings screen, enter the domain, username, and password for the Application Pool identity

  6. Click Next

    image.png

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

    2021-12-06_14-47-55.jpg

    NAMEDESCRIPTION
    Dataset IDThe two alphanumeric character dataset identifier.
    Service API URLThe URL of your Content Manager Service API.
    License PathThe local path to your license including the .lic file.
    Temp PathTemporary data storage location.
  8. On the Connection Settings screen enter the required settings. Please refer to the table below for configuration settings details.

    image.png

    NAMEDESCRIPTION
    Lawcadia InstanceThe URL of the Lawcadia Instance that Law2CM will connect to. For example https://www.lawcadia.com
    API End PointThe API Endpoint required to connect to the Lawcadia API. For example p1/api/v8
    The Lawcadia Instance URL

    The Lawcadia instance URL will always be https://www.lawcadia.com unless specified by Lawcadia when providing the instance.

  9. 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.

    image.png

    FIELDDESCRIPTION
    Open ID ProviderChoose an Open ID Provider.
    Client IDThe Client ID of the selected Open ID provider
    Authority URLThe Authority URL of the Open ID provider, in format https://login.microsoftonline.com/\{TENANT ID}
    Redirect URLThe FYB Law2CM URL
    Certificate Friendly NameThe friendly name of the nominated certificate (.pfx) installed on the machine.
    App Id URIapi:// {Client ID}
  10. On the Email Configuration Settings screen enter the required settings. Please refer to the table below for configuration settings details

    2021-12-06_14-49-18.jpg

    NAMEDESCRIPTION
    Send ToThe email address that receives all email notifications when exceptions and errors occur.
    From AddressThe email address that sends the email notifications.
    Mail HostThe hosting mail system that sends emails using the given From Address.
    Mail PortThe Simple Mail Transfer Protocol port number.
    License ContactsThe 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.
  11. On the Custom Setup screen select the install location and click Next

    2021-12-06_14-50-37.jpg

  12. From the Confirm Installation window click Install

    2021-12-06_14-51-10.jpg

  13. The installation process will commence

    2021-12-06_14-51-32.jpg

  14. Once the installation is complete click Finish

    2021-12-06_14-52-06.jpg

CONFIGURATION​

IIS CONFIGURATION​

After the installation process is complete, you will be able to locate the application installed within the site selected during installation.

2021-12-06_15-19-35.jpg

  1. From the Features View go to Authentication

    2021-12-06_15-15-19.jpg

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

    image.png

  3. Right click the application in IIS and select explore

    app.jpg

  4. Right click the app data folder and select properties

    prop.jpg

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

    permiss.jpg

  6. Click on Application Pools

    image.png

  7. Within the application pool listing screen, right click on the Law2CM application pool and select the Advanced Settings option from the drop-down menu

  8. 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

    2021-04-26_11-52-56.jpg

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

    2021-12-06_15-24-34.jpg

  10. Complete a restart of the app pool for the settings to take effect

SERVICE API CONFIGURATION​

Note

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:

  1. Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)
  2. Open the Web.config file as an Administrator
  3. 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.

2025-05-28_14-38-26.png

  1. In the requestLimits element add maxAllowedContentLength="51200"

    2025-05-21_11-39-01.png

  2. Save the changes.

MODIFY THE HPTRIM.CONFIG FILE​

  1. Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)

  2. Open the hptrim.config file as an Administrator

    2024-10-01_9-29-47.png

  3. Within the hptrim section, add ignorePropertyErrors = "true"

    2025-07-01_9-24-06.png

SERVICE API OPEN ID CONFIGURATION​

  1. Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)

  2. Open the hptrim.config file as an Administrator

    2024-10-01_9-29-47.png

  3. Navigate to the <add element within the <openidconnect> element

  4. Set the identityClaims attribute to email upn preferred_username oid

  5. Set the appIdURI value to api://{client Id value}. The value of the client Id is the same value provided to the clientID attribute

    2024-10-01_9-32-43.png

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'.

image.png

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

image.png

ADDITIONAL FIELDS​

Three additional fields must be added to Content Manager for the connector.

NameTypeApplies ToMaximum Length
Law IDstringMatter Folder255
Law Document IDstringLawcadia Document255
Matter IDstringMatter Folder255
Container TypestringMatter Sub Folder255
Document TypestringLawcadia Document255
  1. Navigate to Content Manager Context, Search for ‘Additional Fields’ > All

  2. Right click in the view pane and click New Additional Field

    image.png

  3. Select String as Data Format

    image.png

  4. Name the Additional Field Law ID

    Note

    This must match the image below exactly

    2021-12-06_17-56-51.jpg

  5. Click Next

  6. The maximum length should be 255

  7. Click Next, then click Finish

    field.jpg

  8. Add the additional field to any record types used by the connector

  9. Repeat the above process for the other additional fields.

UNINSTALLATION​

MANUAL UNINSTALL​

To uninstall the Law2CM manually please follow the steps below:

  1. Navigate to control panel

    controlpanel.jpg

  2. Click on Uninstall a program

    uninstall.jpg

  3. Locate FYB Law2CM in the list of Programs and feature

    2021-12-06_17-39-46.jpg

  4. Right click on FYB Law2CM and click on Uninstall

    2021-12-06_17-40-41.jpg

  5. If a warning Prompt appears, click on the continue button

    warning.jpg

  6. Click the Yes button

    2021-12-06_17-41-23.jpg

  7. The uninstallation process will commence

    2021-12-06_17-41-58.jpg

  8. Open IIS once the uninstallation process is completed

  9. Locate Law2CM in IIS, right click and click Remove button

    2021-12-06_17-42-43.jpg

  10. When the prompt appears click on the Yes button

    areyousure.jpg