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

# Version Updates and Checking

> Check which version of Nextedy PLANNINGBOARD is installed and upgrade to a newer release to resolve known bugs and gain access to new features.

## Check your current version

Before upgrading, confirm what is currently installed.

1. Open Siemens Polarion ALM as an administrator.
2. Navigate to **Administration > Nextedy PLANNINGBOARD** (or the equivalent Nextedy plugin administration area in your Polarion instance).
3. Look for the version number displayed in the plugin status or about section.

<Note title="Version number format">
  Planningboard version numbers follow the `YY.M.patch` pattern — for example, `24.2.0` or `24.5.1`. The year and month indicate the release cycle; the patch component increments for bug-fix releases.
</Note>

## Check for available updates

Planningboard can check for new releases via the administration panel, which contacts `download.nextedy.com`.

1. In **Administration > Nextedy PLANNINGBOARD**, locate the **Check for updates** or version-check control.
2. If a newer version is available, the panel displays the latest version number alongside a download link.

<Warning title="Version check blocked by firewall">
  If the version-check panel shows no result, displays an error, or hangs indefinitely, your server's outbound traffic to `download.nextedy.com` may be blocked by a network filter or corporate firewall. This is a common deployment scenario and does not indicate a product defect.

  **Fallback:** Navigate directly to `https://download.nextedy.com` from a browser that has internet access, or contact [Nextedy support](https://www.nextedy.com) to obtain the latest release package and changelog.
</Warning>

## Upgrade Planningboard

Planningboard is installed as a standard Polarion third-party extension. The upgrade procedure mirrors the initial installation.

### Before you start

* Download the new plugin package (a `.zip` file or folder named `com.nextedy.planningboard`) from `download.nextedy.com` or from the link provided in the administration panel.
* Schedule a short Polarion downtime — the server must restart.
* Back up the existing plugin folder in case a rollback is needed.

### Upgrade steps

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/zUlmOSLBIQ0HyaAX/planningboard/diagrams/guides/troubleshooting/version-updates/diagram-1.svg?fit=max&auto=format&n=zUlmOSLBIQ0HyaAX&q=85&s=d491a3a5bfb55dbf762518558be07828" alt="Folder hierarchy showing the Polarion server plugins directory, with the com.nextedy.planningboard subfolder highlighted as the one to replace during an upgrade" width="660" height="220" data-path="planningboard/diagrams/guides/troubleshooting/version-updates/diagram-1.svg" />
</Frame>

1. **Stop the Polarion server.**
2. Navigate to the Polarion `plugins/` directory on your server.
3. Remove (or rename as a backup) the existing `com.nextedy.planningboard` folder.
4. Copy the new `com.nextedy.planningboard` folder from the downloaded package into `plugins/`.
5. Delete the `.config` folder (or cache directory) if present — this forces Polarion to re-read the updated plugin manifest on startup.
6. **Start the Polarion server.**
7. After startup, return to **Administration > Nextedy PLANNINGBOARD** and confirm the version number has advanced.

<Warning title="Do not skip the .config deletion step">
  Leaving the old `.config` directory in place can cause Polarion to load a cached version of the plugin, making it appear that the upgrade did not take effect even though the new files are present. Always delete `.config` after replacing the plugin folder.
</Warning>

<Tip title="Upgrade resolved item-movement errors">
  A known issue in `24.2.0` caused error messages when moving work items between Plans on the board. Upgrading to `24.5.1` or later resolved this behaviour. If you are experiencing item-movement errors, check whether your installed version predates `24.5.1`.
</Tip>

## Verify the upgrade

After the server restarts:

1. Open a Polarion page that contains a Planningboard widget.
2. Confirm the board renders without errors.
3. Test a drag-and-drop move of a card between swimlanes to verify write operations work correctly.
4. In **Administration > Nextedy PLANNINGBOARD**, confirm the displayed version matches the package you installed.

You should now see the new version number in the administration panel, and the board should load and respond to interactions without the errors that were present in the previous version.

## Troubleshoot version-check failures

| Symptom                                         | Likely cause                                             | Resolution                                                                                          |
| ----------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Version-check panel returns no result or hangs  | Outbound connection to `download.nextedy.com` is blocked | Check firewall rules; use the direct download URL as a fallback                                     |
| Board loads with infinite spinner after upgrade | Firewall or proxy blocking the board's client assets     | See [Network and Firewall Requirements](/planningboard/guides/troubleshooting/network-requirements) |
| Version number unchanged after upgrade          | `.config` folder not deleted before restart              | Stop server, delete `.config`, restart                                                              |
| Item-movement errors persist after upgrade      | Version still predates `24.5.1`                          | Confirm installed version; repeat upgrade steps                                                     |
| License warning appears after upgrade           | License file not compatible with new version             | See [License Count and Warnings](/planningboard/guides/troubleshooting/license-issues)              |

<Warning title="Infinite-loading board after upgrade">
  If the board becomes unresponsive with an infinite loading indicator immediately after an upgrade, this is more likely a network or firewall issue than a product defect. Open the browser developer tools (F12) and check the **Console** and **Network** tabs for blocked requests. Refer to [Network and Firewall Requirements](/planningboard/guides/troubleshooting/network-requirements) for a full checklist.
</Warning>

## See also

* [Installation](/planningboard/getting-started/installation) — full installation instructions for reference during upgrades
* [License Count and Warnings](/planningboard/guides/troubleshooting/license-issues) — resolve license errors that may surface after an upgrade
* [Network and Firewall Requirements](/planningboard/guides/troubleshooting/network-requirements) — diagnose connectivity issues that affect version checking and board loading
* [Common Errors](/planningboard/guides/troubleshooting/common-errors) — general error reference for post-upgrade issues

<Accordion title="Sources">
  **Support Tickets**

  * [#6659](https://support.nextedy.com/helpdesk/tickets/6659)
  * [#6072](https://support.nextedy.com/helpdesk/tickets/6072)

  **Source Code**

  * `PlanningBoardWidgetRenderer.java`
  * `PlanningBoardWidgetDependenciesProcessor.java`
  * `PlanningBoardDataService.java`
  * `licenseReadonly.cy.ts`
</Accordion>