Missing package “fontconfig” on Linux systems

On Linux the package “fontconfig” must be installed and accessible according to Package dependency “fontconfig”. For example, on Red Hat Linux with Internet access you can install “fontconfig” by executing the yum package manager:

yum install fontconfig

As an alternative, download the package into a custom directory and set the path to this directory via the ImageMaster option: ima.aspose.custom.fonts.directory

If this font package is missing, this can have multiple effects in a running environment:

  • Attachments (e.g. of the MIME type text/plain) cannot be displayed with the WorkplaceClient because the internal rendition service fails. Either a constantly rotating circle (busy icon) is shown instead of a thumbnail preview, or a message like the following is displayed in the WorkplaceClient:

    “The attachment cannot be previewed: the conversion failed.”
  • In parallel, INFO, and SEVERE messages like the following are created in the ImageMaster log file:

    (#|2021-06-11T12:29:49.128+02:00|INFO|302|com.tsystems.ima.rendition.rendition.business.impl.RenditionServiceImpl|IMA9-CLS-{b42776c4-7502-48b2-9254-b2c66822f344}|unnamedTenant1|uli|RND-00101: Internal Error: Font Courier New was not found|#)
    
    (#|2021-06-11T12:29:49.138+02:00|INFO|302|com.tsystems.ima.rendition.rendition.business.impl.RenditionServiceImpl|IMA9-CLS-{b42776c4-7502-48b2-9254-b2c66822f344}|unnamedTenant1|uli|RND-00101: Internal Error: Font Andale Mono was not found|#)
    
    (#|2021-06-11T12:29:49.146+02:00|INFO|302|com.tsystems.ima.rendition.rendition.business.impl.RenditionServiceImpl|IMA9-CLS-{b42776c4-7502-48b2-9254-b2c66822f344}|unnamedTenant1|uli|RND-00101: Internal Error: Font Dejavu Sans Mono was not found|#)
    
    (#|2021-06-11T12:29:49.153+02:00|INFO|302|com.tsystems.ima.rendition.rendition.business.impl.RenditionServiceImpl|IMA9-CLS-{b42776c4-7502-48b2-9254-b2c66822f344}|unnamedTenant1|uli|RND-00101: Internal Error: Font Consolas was not found|#)
    
    (#|2021-06-11T12:29:49.168+02:00|SEVERE|302|com.tsystems.ima.client.presentation.core.view.jsf.pdfviewer.cache.ImaPdfCacheLoader|IMA9-CLS-{b42776c4-7502-48b2-9254-b2c66822f344}|unnamedTenant1|uli|CLS-00101: An internal error occurred: NullPointerException: .
            Caused by: RND-00101: Internal Error: null
            Caused by: java.lang.NullPointerException|#)
    
    (#|2021-06-11T12:29:49.173+02:00|SEVERE|302|com.tsystems.ima.client.presentation.core.view.jsf.pdfviewer.servlet.ImaPdfServlet|IMA9-CLS-{b42776c4-7502-48b2-9254-b2c66822f344}|unnamedTenant1|uli|CLS-00101: An internal error occurred: ConversionFailedException: .
            Caused by: com.tsystems.ima.client.presentation.core.view.jsf.pdfviewer.exceptions.ConversionFailedException|#)
    

Also see: