Skip to content

Installation

The OKMMSOfficeConversionService is available at OpenKM Download Center. 

Configuration

Section titled “Configuration”

  • In the appsettings.json file, set the IP and port of the service.

  • To start the conversion service, run the MSOfficeConversionService.exe file

  • From the OpenKM UI, go to Administration -> Configuration parameters and set the service URL in the remote.msoffice.conversion.service parameter.

    remote.msoffice.conversion.service = http://localhost:5400/rest/conversion/pdf  

  • Finally, from Administration -> Utilities -> Plugins, select the Converter plugins and:

    • Disable the OfficeToPdfConversion plugin
    • Enable the RemoteMsOfficeToPdfConversion plugin.

Configure to boot as a service

Section titled “Configure to boot as a service”
  1. Extract OKMMSOfficeConversionService.zip to the root of the C:\ drive and rename the publish folder to OKMOfficeConversionService
  2. Download NSSM
  3. Extract the downloaded ZIP file
  4. Rename the extracted folder (e.g. “nssm-2.24”) to NSSM and copy the NSSM folder to the root folder of drive C:\
  5. Open Command Prompt as Administrator and navigate to the NSSM folder by typing the following commands in order:
    1. Now, according to your Windows version (32- or 64-bit), navigate to one of the two contained subfolders by typing the corresponding command (and press Enter).
      • If you have 64-bit Windows, type: cd win64
      • If you have 32-bit Windows, type: cd win32
    2. Now type the following command: nssm install
    3. In the window that opens:
      • Application tab: Select the application path MSOfficeConversionService (e.g., C:\OKMOfficeConversionService**\MSOfficeConversionService.exe**) and enter the service name: OKMOfficeConversionService.
      • In the Details tab, select Automatic (Delayed Start) startup type**.**
      • Check the option in the Log on tab**: Allow service to interact with desktop.**
    4. When done**, click Install Service.** (Click OK on the message “Service installed successfully” and you’re done!)

To remove the service, you must execute the command:

C:\NSSM\nssm remove OKMOfficeConversionService