Polarity v4 Admin Guide
Polarity v5 Admin Guide
  • Sever Requirements
    • Deployment Methods
      • Deploying Polarity Server on AWS with RDS and Elasticache
      • Deploying Polarity Server Virtual Machine on Azure
      • Deploying via OVA
      • Deploying via RPM
      • Polarity Server BYOL AMI
  • Guides
    • Installing License
    • Authentication
      • SAML
        • Azure ADFS
        • Okta
        • SAML Troublshooting
      • LDAP Troubleshooting
    • Installing Private Certificate Authority
    • Installing SSL Certificate
      • Installing LetsEncrypt SSL Certificate on Polarity Server
    • Configuring a Proxy
    • Migrating Polarity Servers
      • Upgrade PostgreSQL to v13
    • Enabling SMTP
    • Server Environment Variables
    • File System Layout
    • Configuring a FQDN
    • Enabling Source Analytics
      • Elasticsearch
        • Configuring Source Analytics on Elasticsearch
        • Source Analytics Integration with Elasticsearch
    • v5 Server Pre-Flight Upgrade Check
  • Integrations
    • Auto Subscribe CLI Tool
    • Installation
    • Install Multiple Copies of an Integration
    • Modifying Integration Name & Acronym
    • Add Custom Entity Types
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/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 CustomerSuccess@polarity.io 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
PreviousPolarity Server BYOL AMINextAuthentication

Last updated 1 year ago