Skip to main content

Verify the Issue

After updating Nextedy RISKSHEET, check if the RISKSHEET menu is missing from the Polarion navigation bar. This indicates a plugin initialization failure caused by multiple versions in the Extensions directory.

Locate the Extensions Directory

Navigate to your Polarion installation’s Extensions directory:
<POLARION_HOME>/polarion/extensions/
List all folders in this directory to identify RISKSHEET installations. Look for folders with names like:
  • nextedy_risksheet
  • nextedy_risksheet_24.5.0
  • nextedy_risksheet_old
  • Any folder containing “risksheet” in the name
If you see more than one RISKSHEET-related folder in the Extensions directory, Polarion cannot determine which version to load. This causes the plugin to fail initialization silently, and the menu will not appear.

Remove All RISKSHEET Folders

Stop the Polarion server before making changes:
# Stop Polarion service
sudo systemctl stop polarion
# or
<POLARION_HOME>/polarion/bin/polarion stop
Delete all RISKSHEET folders from the Extensions directory:
cd <POLARION_HOME>/polarion/extensions/
rm -rf nextedy_risksheet*
Before deleting, copy the folders to a backup location outside the Extensions directory. This preserves any custom configuration files you may have modified.

Install the New Version

Copy only the new RISKSHEET version to the Extensions directory. Extract the plugin archive and verify you have a single folder:
<POLARION_HOME>/polarion/extensions/nextedy_risksheet/
Verify the folder structure contains:

Clear Server Cache

Delete the Polarion cache to force reinitialization:
rm -rf <POLARION_HOME>/data/workspace/.config/

Restart Polarion

Start the Polarion server and wait for full initialization:
sudo systemctl start polarion
# or
<POLARION_HOME>/polarion/bin/polarion start
Monitor the logs for RISKSHEET initialization messages:
tail -f <POLARION_HOME>/data/logs/polarion.log | grep -i risksheet

Verification Process

Update Confirmation Checklist:
  • Only ONE nextedy_risksheet folder exists
  • Polarion server restarted successfully
  • No initialization errors in polarion.log
  • RISKSHEET menu appears in navigation
  • Existing risksheets load without errors
Log in to Polarion and verify:
  1. The Risksheet menu appears in the main navigation bar
  2. Opening an existing RISKSHEET widget displays the grid correctly
  3. The version number shown in the RISKSHEET interface matches the installed version
Open any RISKSHEET and check the bottom-right corner or About dialog to confirm the correct version is running. This ensures the new version loaded successfully.

Troubleshooting Persistent Issues

If the menu still does not appear after following these steps: Check file permissions:
chown -R polarion:polarion <POLARION_HOME>/polarion/extensions/nextedy_risksheet/
chmod -R 755 <POLARION_HOME>/polarion/extensions/nextedy_risksheet/
Verify the plugin archive: Re-download the RISKSHEET installation package from the Nextedy support portal to ensure the archive is not corrupted. Check license validity: Navigate to AdministrationNextedy ExtensionsLicenses and verify the RISKSHEET license is active and not expired. Review Polarion logs: Search for initialization errors or exceptions related to RISKSHEET in polarion.log:
grep -i "risksheet\|nextedy" <POLARION_HOME>/data/logs/polarion.log | grep -i error

Prevention for Future Updates

When updating Nextedy RISKSHEET in the future:
  1. Always delete the existing nextedy_risksheet folder completely
  2. Never copy the new version over the existing installation
  3. Never rename the old folder to something like nextedy_risksheet_old
  4. Always restart Polarion after updating
  5. Always verify only one RISKSHEET folder exists before restarting
You should now see the RISKSHEET menu in the Polarion navigation bar and be able to open existing widgets without errors.

See Also

Support TicketsSource Code
  • RiskSheetContextMenu.ts