Skip to main content

​
Prerequisites

  • Administrator access to the Polarion server filesystem and web interface
  • The new Powersheet distribution package (nextedy_powersheet.zip) downloaded from the Nextedy POWERSHEET Download page
  • Release notes for the target version reviewed for breaking changes

​
Step 1: Back up the current installation

Before upgrading, create a backup of the existing extension directory: 
[POLARION_INSTALL]/polarion/extensions/com.nextedy.powersheet
Copy this entire folder to a safe location so you can restore the previous version if the upgrade causes unexpected issues. If your organization has multiple Polarion instances (e.g. staging and production), perform the upgrade on the staging instance first to verify compatibility before deploying to production.
Domain models and sheet configurations stored in the Polarion SVN repository are independent of the extension files. They are not affected by the upgrade process and do not need separate backup.

​
Step 2: Replace the extension files

Unpack the new nextedy_powersheet.zip. The archive contains a folder named com.nextedy.powersheet with the updated extension. Remove the existing extension folder and copy the new one into the Polarion extensions directory: 
[POLARION_INSTALL]/polarion/extensions/com.nextedy.powersheet
After replacing, delete the cached configuration folders to ensure the server picks up the new version cleanly: 
[POLARION_DATA]/workspace/.config
Deleting the .config cache folder only removes cached plugin data. This is safe and recommended by Siemens Polarion support to ensure extensions are recognized correctly after an update.

​
Step 3: Restart the Polarion server

Restart the Polarion server to load the updated extension. The server will detect the new extension version during its initialization sequence. Monitor the server log file during startup for any errors related to the Powersheet extension. Look for entries containing com.nextedy.powersheet to confirm the extension loaded successfully. If errors appear, check that:
  • The extension folder structure is intact (not nested inside an extra directory)
  • All JAR files from the distribution package are present
  • The Polarion server version meets the minimum requirements listed in the release notes

​
Step 4: Verify the upgrade

After the server restarts, navigate to Administration > Nextedy POWERSHEET > Setup and confirm that the displayed version matches the new release. Check the license status at Administration > Nextedy POWERSHEET > License. If the status shows WARNING or INVALID, contact Nextedy support for an updated license file. See Install and Manage License for license troubleshooting.
Domain model and sheet configuration YAML files stored in the Polarion SVN repository are not modified during an upgrade. The domain model $version field enables schema compatibility checking, so existing configurations continue to work in most cases. Review the release notes for any deprecated properties or schema changes.

​
Rollback

If the new version causes problems, stop the Polarion server, remove the updated com.nextedy.powersheet folder, restore the backup from Step 1, delete the .config cache again, and restart. Your configurations remain unchanged because they are stored in SVN independently of the extension.

​
See Also