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:

TypeError: scheduler.schedule is not a function

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.

file /app/polarity-server/license/polarity.lic
polarity.lic: ASCII text, with very long lines, with CRLF line terminators

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

vi polarity.lic -c "set ff=unix" -c ":wq"

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

yum install dos2unix
dos2unix /app/polarity-server/license/polarity.lic

Restart the server process after running the above commands.

systemctl restart polarityd