License Validation Errors

​

Identify the License Issue Type

License validation errors manifest in different ways depending on the underlying cause:

​

Step 1: Check Current License Status

Verify the license installation and status.

​

Access License Information

1. Log in to Polarion as an administrator
2. Navigate to Administration → License Management
3. Locate the Nextedy RISKSHEET license entry
4. Note the following details:
   • License type (Evaluation, Production)
   • Expiration date (if evaluation)
   • Licensed user count (named users or concurrent users)
   • Current active user count

​

Check License Validity

• RISKSHEET license exists?
  • No — Step 2: Install license
  • Yes — Check expiration date
    • Expired — Step 3: Renew license
    • Valid — Check user count
      • Exceeded — Step 4: Manage users
      • OK — Step 5: Check feature access

​

Step 2: Install or Reinstall License

If no valid license is found, install the license file.

​

Obtain License File

1. Contact Nextedy support or your account manager
2. Provide your Polarion server ID (found in Administration → License Management)
3. Receive license file via email (typically risksheet.license or nextedy-risksheet-<id>.xml)

​

Install License

1. In Polarion, navigate to Administration → License Management
2. Click Upload License or Add License
3. Select the received license file
4. Click Upload or Install
5. Verify the license appears in the list with status Valid

​

Restart Polarion Service

After license installation:

1. Stop Polarion service: sudo systemctl stop polarion
2. Wait 30 seconds
3. Start Polarion service: sudo systemctl start polarion
4. Verify RISKSHEET loads without license errors

​

Step 3: Renew Expired License

Evaluation licenses expire after the trial period. Production licenses expire if maintenance lapses.

​

Evaluation License Expired

If your evaluation period has ended:

1. Contact Nextedy sales to discuss production license purchase
2. Provide feedback on evaluation experience
3. Receive production license file upon purchase
4. Install using Step 2 instructions

​

Production License Maintenance Lapsed

If your production license shows expired:

1. Verify maintenance contract status with Nextedy
2. Renew maintenance if lapsed
3. Request updated license file
4. Install updated license using Step 2

​

Step 4: Manage User License Limits

If you’ve exceeded licensed user count, adjust active users or upgrade license.

​

Check Active User Count

1. Navigate to Administration → License Management
2. Locate Nextedy RISKSHEET license
3. Compare:
   • Licensed users: Total users allowed
   • Active users: Current users consuming licenses

​

Named User Licenses

For named user licenses, active users are explicitly assigned:

1. Navigate to Administration → Users
2. Review users with RISKSHEET role or permissions
3. Remove RISKSHEET access from inactive users:
   • Edit user profile
   • Remove RISKSHEET-related roles
   • Save changes

​

Concurrent User Licenses

For concurrent licenses, active users are currently logged in:

1. Check current active sessions in Administration → Active Sessions
2. If limit is frequently hit, consider:
   • Upgrading to more concurrent users
   • Switching to named user licensing
   • Implementing user groups to control access

​

Step 5: Verify Feature Access and License Tier

Some features require specific license tiers or additional products.

​

RISKSHEET License Tiers

RISKSHEET licenses come in multiple tiers with different feature sets: Check your license tier in Administration → License Management. If a feature is unavailable, verify it’s included in your tier.

​

POWERSHEET Integration Features

Certain advanced features require POWERSHEET production license in addition to RISKSHEET:

1. Navigate to Administration → License Management
2. Check if Nextedy POWERSHEET license exists
3. Verify it’s a production license (not evaluation)
4. If missing, contact Nextedy about POWERSHEET licensing

​

License Revalidation

RISKSHEET periodically revalidates licenses. If you recently installed or upgraded a license:

1. Wait 5-10 minutes for automatic revalidation
2. Or restart Polarion service to force immediate validation
3. Clear browser cache: Ctrl+Shift+Delete
4. Reload RISKSHEET page

​

Step 6: Troubleshoot License Detection Issues

If a valid license exists but RISKSHEET doesn’t recognize it:

​

Verify License File Integrity

1. Access Polarion’s license directory: /opt/polarion/data/licenses/
2. Check that risksheet.license or nextedy-risksheet-*.xml exists
3. Verify file permissions are readable: chmod 644 risksheet.license
4. Check file is not corrupted: Open in text editor and verify XML structure

​

Check Polarion Logs

1. Access Polarion logs: /opt/polarion/data/logs/
2. Search for license-related errors:
   Copy

   Ask AI

   grep -i "license" polarion.log | grep -i "risksheet"
   
3. Look for messages like:
   • “License validation failed”
   • “License file corrupted”
   • “Server ID mismatch”

​

Server ID Mismatch

If logs show “Server ID mismatch”:

1. License was generated for a different Polarion server
2. Verify you’re using the correct license file
3. If Polarion server was migrated or cloned, request new license from Nextedy

​

Step 7: Bypass Admin Permission Check (Development Only)

For development or testing environments, you can temporarily disable admin permission checks.

​

Enable Development Mode

1. Edit Polarion configuration: /opt/polarion/polarion/configuration/polarion.properties
2. Add this line:
   Copy

   Ask AI

   nextedy.risksheet.disable_admin_check=true
   
3. Save file
4. Restart Polarion service

​

Verification

After resolving license issues, you should see:

• No license error messages when loading RISKSHEET
• License shows Valid status in Administration → License Management
• All licensed features are accessible
• User count within licensed limits
• No license-related errors in Polarion logs

If license validation continues to fail after these steps, contact Nextedy support with:

• Polarion version number
• RISKSHEET plugin version
• License file (attach to support ticket)
• Server ID from License Management page
• Relevant log excerpts showing validation errors

​

See Also

• Concepts: Licensing Model - How RISKSHEET licensing works
• Understand License Types - License tier comparison
• Choose License Tier - Select appropriate license
• Manage User Groups - Control user access with groups
• Reference: Polarion License Types - Polarion license compatibility

Sources

Support Tickets

• #6105

Source Code

• RisksheetProduct.java
• RisksheetViewServlet.java
• AppConfig.ts