Prerequisites
Before you begin, ensure the following:
- Polarion ALM is installed and running (version 2304 or later recommended)
- You have administrator access to the Polarion server file system
- You have received a Powersheet license file (
.lic) or license key from Nextedy
- The Polarion service can be restarted during the installation window
Step 1: Install the Powersheet Extension
- Download the Powersheet distribution package (
.jar file) from the Nextedy customer portal
- Copy the
.jar file into the Polarion extensions directory:
<POLARION_HOME>/polarion/extensions/
- Restart the Polarion server service to load the extension
After restart, check the Polarion server log for a line confirming Powersheet initialization. If the extension does not appear, verify that the .jar file has the correct read permissions.
Step 2: Activate Your License
Powersheet requires a valid license to operate. You can activate it through the Polarion administration interface.
- Log in to Polarion as an administrator
- Navigate to Administration > Nextedy POWERSHEET > License
- Choose one of the activation methods below
Option A: Upload License File
- Click Upload License
- Select the
.lic file provided by Nextedy
- Click Activate
- The license details (type, expiration date, licensed user count) will appear on screen
Option B: Enter License Key
- Click Enter License Key
- Paste the license key string into the text field
- Click Activate
Step 3: Verify License Status
After activation, confirm the license is active:
- Navigate to Administration > Nextedy POWERSHEET > License
- Review the license information panel:
| Field | Description |
|---|
| License Type | Named-user or site license |
| Status | Active, Expired, or Trial |
| Expiration Date | Date the license expires |
| Licensed Users | Maximum concurrent users allowed |
| Product Version | Licensed Powersheet version range |
The exact fields displayed on the license panel may vary by Powersheet version. Check your administration panel for the current layout.
Renew an Expiring License
When your license approaches its expiration date, Powersheet displays a notification banner to administrators.
- Contact Nextedy support or your account manager to obtain a renewed license file
- Navigate to Administration > Nextedy POWERSHEET > License
- Click Update License and upload the new
.lic file
- The new expiration date should appear immediately — no server restart required
Once expired, Powersheet sheets will display in read-only mode. Users will not be able to save changes or create new work items through the sheet. Upload the renewed license before the expiration date to avoid disruption.
Manage License on Clustered Deployments
If your Polarion installation runs in a clustered (multi-node) configuration:
- Install the Powersheet
.jar on every cluster node in the same extensions directory path
- Activate the license on the primary node only — the license state is stored centrally in the Polarion repository
- Restart all cluster nodes after installation
- Verify the license status from any node’s administration panel
If your cluster nodes share a common file system for the extensions directory, you only need to copy the .jar file once. Each node will pick it up after its individual restart.
Switch Between License Types
To upgrade from a trial or named-user license to a site license:
- Navigate to Administration > Nextedy POWERSHEET > License
- Click Update License
- Upload the new license file — the new license type replaces the previous one
- Confirm the updated License Type and Licensed Users values in the panel
No uninstallation or removal of the previous license is necessary. The new license file overwrites the old activation.
Uninstall Powersheet
If you need to remove Powersheet from your Polarion server:
- Stop the Polarion server service
- Remove the Powersheet
.jar file from:
<POLARION_HOME>/polarion/extensions/
- Restart the Polarion server
Uninstalling the extension does not remove domain model or sheet configuration YAML files from your project repositories. These files remain in SVN and are harmless without the extension installed. If you reinstall later, your configurations will still be available.
Troubleshoot Common License Issues
| Symptom | Likely Cause | Resolution |
|---|
| ”License not found” after restart | .lic file not uploaded through Admin UI | Navigate to Administration > Nextedy POWERSHEET > License and upload the file |
| Sheet opens in read-only mode | License expired or user count exceeded | Check license status; renew or upgrade |
| License page not visible in Admin | Extension .jar not loaded | Verify the .jar is in the extensions directory and restart the server |
| ”Invalid license” error on upload | License file corrupted or for a different product | Re-download the .lic file from the customer portal or contact support |
Verification
You should now see:
- ✅ The Powersheet extension loaded in Administration > Extensions
- ✅ An active license with a valid expiration date on the Administration > Nextedy POWERSHEET > License page
- ✅ Powersheet sheets rendering and allowing edits in your project documents
See Also
