Polarity v5 Admin Guide

Installing License

Learn how to update or install the Polarity license

Install or Update your License

You can update or install the license on your Polarity server by adding the license file to the correct location on the Polarity Server. The license file will be named polarity.lic and should be located in the directory /app/polarity-server/license on your Polarity server.

Start by copying your license file to license directory:

cp polarity.lic /app/polarity-server/license/polarity.lic

Ensure the license file is owned by the polarityd user and group:

chown polarityd:polarityd /app/polarity-server/license/polarity.lic

Finally restart your server so the license is loaded:

systemctl restart polarityd

Please contact Polarity Customer Success at [email protected] for questions about your file.

Troubleshooting

Solve CRLF Line endings on the polarity.lic file

If the Polarity Server license file has Window line endings in it, the server will throw errors but will not crash. If you check the server status using the /app/polarity-server/scripts/polarity-status.sh script the server will appear to be running but the Polarity web interface will redirect you to the the Server Error page.

To diagnose the issue, you can run the following grep on the server log file.

grep /app/polarity-server/logs/polarity-server.log "scheduler.schedule"

If you get back the error message:

Then you likely have a license with window line endings. You can also confirm that there are window line endings by running the file command on the license file. The output will show CRLF line terminators.

To remove the line endings you can use the following command which will rewrite the existing license file.

If the user has access to yum you can also install dos2unix

Restart the server process after running the above commands.

PreviousPolarity Server BYOL AMINextAuthentication

Last updated