Installation and configuration
This page explains key information such as system requirements and configuration to take into consideration when migrating to the Conversion Service from the 3-Heights® Document Converter.
Want to get started with installing the Conversion Service on a compatible operating system?
See Install Conversion Service.
System requirements
The system requirements for migrating to the Conversion Service from 3-Heights® Document Converter are as follows:
| Conversion Service | 3-Heights® Document Converter | |
|---|---|---|
| Microsoft Windows | Windows Server 2016, 2019, 2022 (all 64-Bit) | Windows Server 2008 R2, 2012, 2012 R2, 2016, 2019, 2022 (all 64-Bit) |
| Microsoft Windows Terminal Server role | Not required | Recommended |
| Microsoft Office versions | Office 2016 (64 Bit), 2019 (64 Bit), 2021 (64 Bit) and Office 365 (64 Bit) | Office 2010, 2013, 2016 and 2019 |
| Microsoft Office language setting | English (US) | English (recommended), German |
| Microsoft .NET Runtime | .NET Framework 4.7 + .NET Desktop Runtime 8.0 + ASP.NET Core Runtime 8.0 | .NET Framework 4.7 |
| Microsoft Universal CRT | Not required | Required |
| Microsoft Internet Explorer | Not required | Required for conversion of web archives and HTML bodies of emails (if configured) |
| Adobe Acrobat Reader | Not required (XFA forms in PDF are not supported) | 10 or higher (required for conversion of XFA forms in PDF) |
Default folder locations
There are several differences in the default folder locations used in the Conversion Service.
| Conversion Service | 3-Heights® Document Converter | |
|---|---|---|
Installation directory (%INSTALLATION_DIRECTORY%) | C:\Program Files\Pdftools\Conversion Service | C:\Program Files\PDF Tools AG\3-Heights(TM) Document Converter Enterprise |
Program data directory (%PROGRAMDATA_DIRECTORY%) | C:\ProgramData\Pdftools\Conversion Service | -- |
| Log directory | %PROGRAMDATA_DIRECTORY%\Logs | %INSTALLATION_DIRECTORY%\log %INSTALLATION_DIRECTORY% (Watched Folders only) |
| Temporary file directory | %PROGRAMDATA_DIRECTORY%\TemporaryWorkFiles %PROGRAMDATA_DIRECTORY%\TemporaryWorkFolders | %INSTALLATION_DIRECTORY%\Temp |
| Configuration file directory | %INSTALLATION_DIRECTORY%\bin | %INSTALLATION_DIRECTORY% |
| Documentation directory | Online documentation only | %INSTALLATION_DIRECTORY% |
For more information, see Install the Conversion Service.
Log files
All verbose information is written to the Service log files in the Conversion Service. The names of the log files are different when migrating to the Conversion Service from the 3-Heights® Document Converter.
| Conversion Service | 3-Heights® Document Converter | |
|---|---|---|
| Main service log file name | ConversionService-Service.log (current) ConversionService-Service-<date>.log (past) | o2psrv-<date>.log o2psrv-w-<date>.log |
| Worker log file name | ConversionService-Service.log (current) ConversionService-Service-<date>.log (past) | o2pwsc-1-<date>.logo2pwsc-2-<date>.log... |
| Watched Folder log file name | ConversionService-Connections.log (current)ConversionService-Connections-<date>.log (past) | O2PWFS-log-<date>.log |
| Mail Folder log file name | ConversionService-Connections.log (current)ConversionService-Connections-<date>.log (past) | O2PMFS.log (current) O2PMFS-<nnn>.log (past) |
| Configurator log file name | ConversionService-Configurator.log (current) ConversionService-Configurator-<date>.log (past) | O2PConfigure.log |
| Setup Wizard log file name | ConversionService-Configurator.log (current) ConversionService-Configurator-<date>.log (past) | DocConvInstallConfig-<date>.log |
Configuration files
You configure the Conversion Service using the Configurator.
Unlike the 3-Heights® Document Converter, the configuration files must not be edited manually. The configurator must be used to change any settings. Editing the Conversion Service configuration files may cause the service to fail. Do not make any changes to these files.
For more information on configuring the setup for your installation, see Configure the Conversion Service.
| Conversion Service | 3-Heights® Document Converter | |
|---|---|---|
| General service settings | O2PSRV.exe.config appsettings.json | |
| Worker settings | O2PWSC.exe.config | |
| Job/Document processing settings | Workflows.xml | O2PWSC.ini |
| Watched Folder settings | Connections.xml | O2PWFS.ini |
| Mail Folder settings | O2PMFS.ini |
Configuring Microsoft Office
Similar to the 3-Heights® Document Converter, the Conversion Service uses Microsoft Office applications to process jobs containing Word, Excel, and PowerPoint documents.
The Conversion Service cannot be installed on the same machine where the 3-Heights® Document Converter client or service is running due to conflicts between Microsoft Office configurations.
If you plan to run both services in parallel while migrating to the Conversion Service, then you need to install the Conversion Service on a separate machine.
You can convert Microsoft Office files using:
- a local Microsoft Office installation
- the Microsoft Office for the web service
To set up the Conversion Service, see Convert Microsoft Office files.