> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Powersheet

> This guide walks you through upgrading Nextedy POWERSHEET to a new version on your Siemens Polarion ALM server.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

## Prerequisites

* Administrator access to the Polarion server filesystem and web interface
* The new Powersheet distribution package (`nextedy_powersheet.zip`) downloaded from the [Powersheet Download](https://go.nextedy.com/powersheet-download-page) page
* Release notes for the target version reviewed for breaking changes

<Steps>
  <Step title="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.

    <Note title="Configuration files are safe">
      Data 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.
    </Note>
  </Step>

  <Step title="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
    ```

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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>

  <Step title="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](/powersheet/guides/administration/install-manage-license) for license troubleshooting.

    <Tip title="Configuration compatibility">
      Data model and sheet configuration YAML files stored in the Polarion SVN repository are not modified during an upgrade. The data 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.
    </Tip>
  </Step>
</Steps>

## 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

* [Installing Powersheet](/powersheet/getting-started/installation) -- full initial installation procedure
* [Migration FAQ](/powersheet/faq/migration) -- common upgrade and migration questions
* [Install and Manage License](/powersheet/guides/administration/install-manage-license) -- license activation and renewal

<LastReviewed date="2026-06-24" />