Issue with LibreOffice PDF Generation

Applies to: All versions of Ephesoft Transact

Issue

A document conversion error may occur if the current profile in OpenOffice is corrupt. This causes the font capture in the converted documents to be inaccurate.

Solution

Refer to your version of Ephesoft Transact:

Ephesoft Transact 2020.1.03 and Above

Note: The following steps are only available for Windows.

To resolve this issue, you will need to enable the cron job that automatically resets OpenOffice user profiles. Perform the following steps:

  1. Open the open-office.properties file located at [Ephesoft_Directory]\Application\WEB-INF\classes\META-INF\dcma-open-office.
  2. Set the openoffice.userProfileResetEnabled property to “true”.

Figure 1. openoffice.userProfileResetEnabled

  1. Set the openoffice.userProfilePath property to the full path where the OpenOffice user profile is located.


Figure 2. openoffice.userProfilePath

  1. Set the openoffice.userProfileBackupPath property to the full path where the user profile should be backed up.


Figure 3. openoffice.userProfileBackupPath

  1. Set the openoffice.userProfileCronJob property to when the user profile reset should occur. By default it is set to run every day at 2AM. For more information, refer to CronJob Expressions.


Figure 4. openoffice.userProfileCronJob

  1. Save and close the file.

Ephesoft Transact 2020.1.02 and Below

To resolve this issue, you will need to manually correct the OpenOffice or LibreOffice profile. Perform the following steps depending on your operating system:

Windows

  1. Stop the Ephesoft Transact server.
  2. Open Task Manager.
  3. Select soffice.bin and soffice.exe.
  4. Click End task > End process.
  5. Navigate to the following location: C:\Users\<username>\AppData\Roaming\LibreOffice\4\user

Note: If Open Office 3 is installed, navigate to the following location: C:\Users\<username>\AppData\Roaming\OpenOffice.org\3\user

  1. Rename the user folder as a backup.
  2. Restart the Ephesoft Transact server.

This will refresh the user profile. Any corrupt data will be reset.

Linux

  1. Stop the Ephesoft Transact server.
  2. Run the following command to kill LibreOffice:
pkill soffice.bin
  1. Navigate to the following location:
home/<USERNAME>/.config/libreoffice/4/user
  1. Use the following command to display the content of the folder:
Is
  1. Locate the user folder
  2. Create a backup of the user folder.
  3. Use the following command to delete the original user folder and its contents:
rm -rf user
  1. Start the Ephesoft Transact service. This will create a new user profile.