Installation

The OKMMSOfficeConversionService is available at OpenKM Download Center

Configuration

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

    By default, the URL is: http://localhost:5400

  • 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

  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