License Installation

​

What you will achieve

• Placed your production license file in the correct Polarion directory
• Verified the license status in the Planningboard administration interface
• Confirmed that licensed users can drag cards, use the sidebar, and create Plans

​

Prerequisites

• Planningboard is already installed on your Polarion server (see Installation)
• You have access to the Polarion server file system (or can ask your system administrator)
• You have received a license file named <PREFIX>-planningboard_lic.json from Nextedy

1

Locate your license file

Your license file was delivered by Nextedy when you purchased Planningboard. Its name follows the pattern:

<YOURPREFIX>-planningboard_lic.json

For example: acme-planningboard_lic.json.If you cannot find your license file, contact support@nextedy.com.

---

2

Copy the license file to the Polarion license directory

Place the license file inside the Polarion installation’s license folder:

[POLARION_INSTALL]/polarion/license/<YOURPREFIX>-planningboard_lic.json

Replace [POLARION_INSTALL] with your actual Polarion installation path (for example /opt/polarion on Linux).

The file name must remain exactly as delivered. Renaming the file can prevent the license from being recognized.

---

3

Delete the `.config` cache directory

Polarion caches plugin state in a .config directory. You must remove it so Polarion picks up the new license on the next start.

Delete: [POLARION_INSTALL]/data/workspace/.config

The .config directory holds only plugin discovery caches — no project data. Deleting it does not slow Polarion down and is recommended by Polarion support whenever a plugin changes.

---

4

Restart the Polarion server

Restart your Polarion server using your organization’s standard procedure. The server must fully start before you proceed.What you should see: Polarion starts normally with no errors related to Planningboard in the server log.

---

5

Verify the license in the administration interface

1. Log in to Polarion as an administrator.
2. Navigate to Administration > Nextedy PLANNINGBOARD.
3. Open the Setup (or license) page.

You will see a color-coded status panel:

The panel also shows the full license details. The signature field is automatically redacted from the display — this is intentional and does not affect validation.What you should see: A green panel confirming the license is valid.

The license signature is hidden in the UI for security. The server validates it server-side — you do not need to see it.

---

6

Confirm editing is available

Open a Planningboard page in any project. Verify the following are now visible and functional for licensed users:

Element	Expected state when licensed
Show Unplanned button	Visible in the toolbar
Create New Plan button	Visible
Sidebar panel	Opens when a card is clicked
Drag and drop	Cards can be dragged between swimlanes; changes persist

Planningboard enforces license-based access control per user. Users who do not hold a Planningboard license will still see the board in read-only mode — they can view cards and swimlanes but cannot drag, edit, or plan. This is by design to support collaboration and transparency.

---

​

License states reference

​

Next steps

• Setup into New Projects — install Planningboard into a brand-new Polarion project
• Setup into Existing Projects — add Planningboard to a project already in use
• Create Your First Planningboard — add the widget to a LiveDoc page and run your first planning session