Polarity Admin Guide Version 5
Release Notes
  • Guides
    • Installing License
    • Authentication
      • LDAP Troubleshooting
      • SAML
        • Azure ADFS
        • Okta
        • SAML Troublshooting
    • Installing SSL Certificate
      • Configuring Certificate Signing Request (CSR)
    • Configuring a Proxy
    • Upgrade PostgreSQL to v15
    • Enabling SMTP
    • Server Environment Variables
    • File System Layout
    • Configuring a FQDN
    • Upgrade Polarity Server v4 to v5
    • Update Polarity V5
    • Troubleshooting V5
    • Fresh Installation Polarity Server v5
    • Enabling Source Analytics
      • Splunk
        • Sending Source Analytics to Splunk
        • Source Analytics Integration
      • Elasticsearch
        • Sending Source Analytics to Elasticsearch
        • Source Analytics Integration
  • Integrations
    • Installation
    • Install Multiple Copies of an Integration
    • Modifying Integration Name & Acronym
  • REST API
    • Authentication
    • Search Integrations
    • Integration Information
      • Integration Attributes
      • Updating Integrations
      • Updating Integration Permissions
      • Integration Options
Powered by GitBook
On this page
  • Install or Update your License
  • Troubleshooting
  • Solve CRLF Line endings on the polarity.lic file
  1. Guides

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/license on your Polarity server.

Start by copying your license file to license directory.

cp polarity.lic /app/license/polarity.lic

Finally restart the Polarity Server containers so the license is loaded

cd /app && ./down.sh && ./up.sh

Please contact Polarity customer success at customersuccess@polarity.io for questions about your license 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 by running docker ps you can tell if the poalrity_web or polarity_platform containers are running.

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

docker logs polarity_platform grep "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/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.

cd /app && ./down.sh && ./up.sh
NextAuthentication

Last updated 1 year ago