PrizmDoc v12.4 - Updated
Linux
Administrator Guide > Troubleshoot > Linux

This topic covers troubleshooting tips for PrizmDoc. Note that this topic does not cover issues related to custom web tier implementations.

The PrizmDoc Viewer isn’t Working (PrizmDoc Server Checks)

The following section contains basic troubleshooting steps limited to the PrizmDoc Server itself.

  1. Verify that the PrizmDoc Server is running. Check the health of the PrizmDoc Server:
    1. If you are using PCC v10.x or later, this can be found at: http://localhost:18681/admin
      Your license status will be displayed at the top:

    1. If you are using PCC v9.x, this can be found at: http://localhost:18681/PCCIS/V1/Service/Current/Info (which will display the same data in JSON format).   

Note that the "License Status" and "PCC Version" may differ on your system from the example above.

Note that "OS" will be your version of Linux.

The health of the services will be displayed.

  1. Test a file outside of the Samples. Open a browser and navigate to: http://localhost:18681/PCCIS/V1/Static/Viewer/Test
    Where localhost is a hostname that points to the PrizmDoc Server. Attempt to open a known good file using the Viewer. If the file works, then PrizmDoc is currently functioning. If not, continue troubleshooting..
  2. If you find that some of the services are unhealthy (and you have checked permissions, login password of the service user, and are using a known valid license), there are two primary reasons for this:

System has limited resources:
The system resources for a machine running PrizmDoc are described in Sizing Servers > PrizmDoc Server. Please note that PrizmDoc will require at least a few gigabytes free while running and no conversions are taking place. If your system has PrizmDoc installed and idles with 1-2GB free RAM, then the services will run into stability issues.

The cache is corrupted or inaccessible
A common problem is not running or installing PrizmDoc Server as the root user, which is a requirement for running PrizmDoc on a Linux server. Correcting this will solve permission related issues while accessing the cache. To clear a potentially corrupted cache manually, use the following steps:

  1. Another common issue is that either PrizmDoc Application Services (PAS) or PrizmDoc Server isn't running.

To check that PAS is running:

 To check that the PrizmDoc Server is running:

  1. If Steps 1 through 4 above have been checked and the Admin page shows that PrizmDoc is unlicensed, then the license key will need to be verified by Accusoft Support at support@accusoft.com. You can find the current license key in /usr/share/prizm/prizm-services-config.yml:

 

In the example above, the license key is "2.0.E6Aorkh8..." To locate your license key, copy everything after "license.key:" and send your full license key to Accusoft Support.

Note that your solutionName and license key may differ from the example above.
  1. If everything seems to be functioning, however a file still cannot be shown in the Viewer, there may be an issue with the conversion of the specific file. If this is the case, send the file to support@accusoft.com for evaluation and submission to our engineering team.