Metadact Installation Guide
Metadact Installation Guide
Metadact Installation Guide
Installation Guide
November 2023
Copyright © 2020–2023 Litera Corp. All rights reserved.
The information in this document is confidential and subject to change without notice and does not
represent a commitment by Litera. The software referred to in this document is furnished under a license
and may not be used or copied except in accordance with the terms of that license.
Metadact is a trademark of Litera. All other product names are trademarks of their respective companies.
Litera
550 West Jackson Blvd.
Suite 200
Chicago, IL 60661
US: +1 630 598 1100 UK: +44 (0)20 3890 2860
©2020–2024 Litera i
Introduction
Introduction
This document contains detailed information about installing all Metadact software
components. Software/hardware requirements and supported integration with other
software programs is described in the document Metadact System Requirements.
Further software configuration and system administration is described in the following
documents:
▪ Metadact Administration Guide
▪ Metadact AIP Configuration Guide
▪ Metadact Configuring Data Loss Prevention Policies
▪ Metadact Quarantine Server Configuration Guide
▪ Metadact Metadata Cleaning Types
▪ Metadact Analytics Server Configuration Guide
▪ Metadact Health Monitoring Configuration Guide
▪ Litera Metadact Outlook Add-in for Microsoft 365 Configuration Guide
▪ Metadact REST API Consumption Reference
Metadact comprises several components:
©2020–2024 Litera 1
Introduction
©2020–2024 Litera 2
Litera License Server
Note: Computers running Metadact Core Server, Node Server, Desktop Client and
Outlook that use Microsoft Azure Information Protection (AIP) must have Visual
C++ Redistributable x64 for Visual Studio 2022 or later installed. It can be
installed before or after the Metadact software is installed. Information and the
download can be found at https://learn.microsoft.com/en-
us/cpp/windows/latest-supported-vc-redist?view=msvc-170.
©2020–2024 Litera 3
Metadact Core Server installation prerequisites
3. In the Server Manager window, expand the Manage menu and select Add
Roles and Features.
4. In the Add Roles and Features Wizard window, read the information on the
Before You Begin tab, then select Next.
©2020–2024 Litera 4
Metadact Core Server installation prerequisites
6. In the Server Selection tab, select the appropriate server (the local server is
selected by default), as shown below, and click Next.
©2020–2024 Litera 5
Metadact Core Server installation prerequisites
8. In the resulting dialog, select Add Features to install the IIS Management
console.
9. Select Next.
10. Select the Features tab, then expand .NET Framework 4.6 Features and select
ASP.NET 4.6. Expand the WCF Services node and select HTTP Activation.
11. In the resulting dialog, select Add Features to install required features.
12. Select Next on the next two dialogs.
13. On the Web Server Role (IIS) > Role Services page, verify that all following
services are checked.
©2020–2024 Litera 6
Metadact Server software installation
14. On the same wizard page expand the Application Development node and
select the following services
15. In the dialog that results when you check ASP.NET 4.6, select Add Features.
16. In the following two dialogs, select Next to proceed to the Confirmation page.
17. Select Install.
©2020–2024 Litera 7
Metadact Server software installation
©2020–2024 Litera 8
Metadact Server software installation
3. On the Custom Setup dialog, select the component you wish to install, then
confirm the installation location.
©2020–2024 Litera 9
Metadact Server software installation
Caution: If the proper version of ASP.NET Core Hosting Bundle (version 3.1.16) has
not been installed (required for the Quarantine Server), the installer displays
a dialog box stating that ASP.NET Core Hosting Bundle version 3.1.3 or
higher is required. The ASP.NET Core Hosting Bundle version must be
3.1.16.
The link in this dialog also downloads an incorrect version. ASP.NET Core
Hosting Bundle version 3.1.16 can be downloaded here:
https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-aspnetcore-
3.1.16-windows-hosting-bundle-installer
Note: If the Quarantine Server or Analytic Server options have been installed, they
must be configured as described in their respective guides (Metadact
Quarantine Server Configuration Guide or Metadact Analytics Server
Configuration Guide).
©2020–2024 Litera 10
Metadact Transport Agent for Exchange installation
©2020–2024 Litera 11
Metadact client installation (Desktop, MS Outlook/Office Suite add-ins)
©2020–2024 Litera 12
Metadact client installation (Desktop, MS Outlook/Office Suite add-ins)
2. Enter or confirm the license key you received from Litera Support and click Next
to display the Destination Folder dialog:
4. If you wish to install all Metadact programs (Metadact Desktop client with all
Microsoft Office Suite add-ins and Metadact Outlook) select Complete, click
Next and follow the remaining dialog prompts to complete the installation. If you
wish to only install some Metadact programs, select Custom to display the
Custom Setup dialog:
©2020–2024 Litera 13
Metadact client installation (Desktop, MS Outlook/Office Suite add-ins)
5. You can choose which Microsoft Office Suite add-ins to install along with the
Metadact Desktop client and and/or to install Metadact for Outlook. When you
have made your choices click Next and follow the remaining dialog prompts to
complete the installation.
Note: You must choose Metadact to install the command line file cleaning
utility.
©2020–2024 Litera 14
Litera Administrator Panel installation
Both the /qn and /qb msiexec switches are supported. The following command installs
Metadact silently as part of a batch script:
msiexec.exe /i “Metadact.msi” LICENSEKEY=“LICENSE KEY“ /norestart /qn
ACCEPT_EULA_AND_TPLA=1
LICENSE KEY = Serial number provided by Litera Support
ADDLOCAL=“MD”
ADDLOCAL=“MD_OUTLOOK”
WORDADDIN=1
EXCELADDIN=1
PPTADDIN=1
Caution: If copying and pasting these commands from a source like the PDF version
of this document, make sure that the entire command is pasted as one string.
For example, if the above command is pasted as two strings, then each
string is executed separately and will generate an error.
By default, all components (Metadact Desktop, Metadact for Outlook add-in and all
Microsoft Office add-ins) are installed in silent setup mode. But you can change this
behavior by specifying the component to install using special command line parameter.
To install just Metadact only you must add the ADDLOCAL=“MD” command:
msiexec.exe /i “Metadact.msi” ADDLOCAL=“MD” LICENSEKEY=“LICENSE KEY”
/norestart /qn ACCEPT_EULA_AND_TPLA=1
©2020–2024 Litera 15
Upgrading from earlier versions of Metadact
Important:
▪ LAP is also used with other Litera programs. Do not run the installer if LAP is
already installed on the computer.
▪ You must be logged in with a user account that has full privileges on the local
computer to run the installation. For scripted/group policy installations, install at
computer startup rather than user login.
▪ LAP requires no licensing since it can only be used with other licensed Litera
products.
Follow the steps below to install LAP.
1. Stop all application processes by closing all Microsoft Office and Litera
applications.
Note: If you continue to get a message that an application is running after
closing it, use Windows Task Manager to close it and any of its
background processes.
2. Run the lcpcfg7.msi installer and follow all on-screen instructions to complete
the installation.
©2020–2024 Litera 16
Upgrading from earlier versions of Metadact
Note: If the database schema has been updated for an upgrade, you must first
update the Metadact database schema before starting the Metadact Core
server service. If you try to start this service, you will receive a code 6 error
message and the service will not start.
See the Updating the Database Schema section in the Server Configuration
Menu section of the Metadact Administration Guide for information on updating
the database schema using the Web Console.
©2020–2024 Litera 17
Upgrading from earlier versions of Metadact
Once you have confirmed the authentication method, upgrade the Metadact Core
Server as follows.
1. In the Windows Services app, stop the Metadact Core Service:
2. Run the MetadactServer.msi, and when you get to the Custom Setup dialog,
select Core and Web Console:
©2020–2024 Litera 18
Upgrading from earlier versions of Metadact
b. From the Windows Start menu click Litera Metadact Server | Metadact IIS
Utility to display the Metadact IIS Utility:
©2020–2024 Litera 19
Upgrading from earlier versions of Metadact
6. Click Test Connection, then click Create and Populate Database to update
the Metadact database schema.
7. Click Save.
8. In the Windows Services app, start the Metadact Core Service:
©2020–2024 Litera 20
Upgrading from earlier versions of Metadact
2. Run the MetadactServer.msi and when you get to the Custom Setup dialog,
select Node:
©2020–2024 Litera 21
Upgrading from earlier versions of Metadact
5. On the Metadact Core Server, log on to the Metadact Web Console and click
Server Configuration | Distributed Processing Nodes to display the
Distributed Processing Nodes page.
6. Confirm under Available machines that the Metadact Node Server is listed as
an available computer:
7. If the Node Server is not shown, use the Windows Services app to restart the
Metadact Core Service and force the Core and Node synchronization process.
©2020–2024 Litera 22
Upgrading from earlier versions of Metadact
©2020–2024 Litera 23
Upgrading from earlier versions of Metadact
1. Run the MetadactServer.msi and when you get to the Custom Setup dialog,
select Mobile Alerts:
©2020–2024 Litera 24
Upgrading from earlier versions of Metadact
c. In the Advanced Settings dialog, under Process Model, click the browse
button in the Identity row to display the Application Pool Identity dialog:
©2020–2024 Litera 25
Upgrading from earlier versions of Metadact
©2020–2024 Litera 26
Upgrading from earlier versions of Metadact
4. Use the Browse button to import the previously saved JSON file, then click
Next.
5. In the next dialog, check all the settings, then click the Validate button. If no
errors are found, you will be able to click Next to answer two final prompts and
finish the wizard. At the end you will have the option of saving the configuration
for future use.
©2020–2024 Litera 27
Upgrading from earlier versions of Metadact
3. Note the current Priority level of the Metadact Agent, as you need to set the
priority to the same level after the installation.
4. Open Windows PowerShell as Administrator.
5. In the Windows PowerShell window, use the cd command to change the
directory to where the MetadactTransportAgent.msi file is located. For
example, type cd “C:\Install\Metadact” and press Enter:
7. Once the installation is completed, open Exchange Management Shell and run
the command Get-TransportAgent and confirm that the Metadact Agent is still
on the list.
8. To move the Metadact Agent priority to its previous level, run the command
Set-TransportAgent -Identity “Metadact Agent” -priority 1.
9. In the Windows Services app, restart the Microsoft Exchange Transport
Service.
©2020–2024 Litera 28
Upgrading from earlier versions of Metadact
If there is no current inbound rule, create an Inbound Windows Firewall Allow rule for
the Program Path “C:\Program Files\Microsoft\Exchange
Server\V15\Bin\EdgeTransport.exe”.
©2020–2024 Litera 29