Install with MSI - Alfresco Document Transformation Engine - 2.4 - 2.4 - Ready - Alfresco - external - Alfresco/Alfresco-Document-Transformation-Engine/2.4/Alfresco-Document-Transformation-Engine/Install/Installation/Install-with-MSI - 2025-04-04

Alfresco Document Transformation Engine
Platform
Alfresco
Product
Alfresco Document Transformation Engine
Release
2.4
License

Note: When upgrading the Document Transformation Engine, the previous installation must be uninstalled first.
  • If your old version is earlier than 1.3.1, use the Uninstall a program option in Control Panel to remove the old version, and then manually remove the Document Transformation Engine directory. By default, the Document Transformation Engine directory is C:\Program Files (x86)\Transformation Engine\.
  • If your old version is 1.3.1 or later, the new Document Transformation Engine MSI prompts you to uninstall the previous version. When the uninstall is complete, you can run the MSI file again to install the new version. There is no need to manually remove anything.

You can download the release files from Hyland Community by navigating to Support > Software Downloads > Alfresco Downloads.

  1. Download the release file, alfresco-document-transformation-engine-server-x.x.x.msi:
    where x.x.x is the exact version provided in the release file.
  2. Log into the Microsoft Windows Server as an administrator.
  3. Double-click the MSI installer package, and then click Next.
  4. Review the supported software requirements, and then click Next.
  5. (Optional) Select the DTE T-Engine.
    Important: If you do not intend to use the DTE T-Engine Docker image, you must select this option for DTE to work correctly.
    Note: Since the Alfresco Content Services 7.0 release, you can only use the T-Engine approach. Installing the Alfresco Module Packages (AMP) files is no longer supported.
  6. Click Next and the license information screen displays.
  7. Click Next, select an installation folder or accept the default folder, and then click Next.
  8. Click Next to start the installation.
    You will see a progress bar and a command line window during the installation. The installer will show a confirmation when the installation is finished.
  9. Click Close to finish the installation.
  10. Verify that the installation has completed successfully.
    1. Check the Windows Services in the management console.
    2. Locate the new service called Document Transformation Engine, and check that it is Started.
    Note: Each time a file is transformed in Alfresco Content Services, the .NET program starts and Microsoft Office tries to check for a Certificate Revocation List (CRL). Depending on the access that the Document Transformation Engine has to the Internet when transforming a file, this check can delay the operation for up to two minutes, and will therefore, delay transformation of the file. To prevent this, use the Windows server firewall to block internet access for all office binaries.
  11. Add the following property to alfresco-global.properties: 
    localTransform.transform-dte.url=http://<dte-hostname>:8080/transform-dte