Troubleshooting License Issues

Teradici includes a license validation utility that scans your local system and any connected physical or cloud-based license servers for active licenses, and informs you of when your license subscription expires. For more information, see FAQ - Licensing Cloud Access Software in our Knowledge Base.

To run the license validation tool, type:

pcoip-validate-license

For more detailed information on pcoip-validate-license, type:

man pcoip-validate-license

To list your licenses and their expiration status, type:

pcoip-list-licenses

For more detailed instructions on pcoip-list-licenses, type:

man pcoip-list-licenses

Tracking Usage Over Time

Teradici Local License Server users can use our open-source script, which displays the maximum Cloud Access Software license concurrent usage for a license server over time. For more information, refer to our Github page.

Teradici Cloud Licensing users can write a short script that runs pcoip-list-licenses periodically (for example, every 60 minutes) on any PCoIP agent machine to track license usage.

Persistent Licensing Errors

If you still see licensing errors after investigating the above possibilities, check that the permissions in the licensing folders are set correctly. To do this, open a terminal and run the following command:

ls -lR /var/lib/pcoip-agent/licensing/5

In the response, look for files that are not owned by _pcoip, or do not belong to the _pcoip group (most likely, these will be owned by root). If there are any present, run the following command to reset ownership:

sudo chown -R _pcoip:_pcoip /var/lib/pcoip-agent/licensing/5