Skip to main content

​
Prerequisites

Required permissions: Polarion administrator access to the server file system ⬇️ Download latest version: Obtain the newest RISKSHEET plugin ZIP file from the Nextedy download portal

​
Steps

​
1. Download the Latest Version

Visit the Nextedy customer portal and download the RISKSHEET version compatible with your Polarion installation.
Check the Polarion Version Compatibility reference to confirm which RISKSHEET version matches your Polarion release. Using an incompatible version can cause initialization failures.

​
2. Stop the Polarion Server

Shut down the Polarion application server before modifying plugin files: 
# Navigate to Polarion installation
cd /opt/polarion

# Stop the server
./polarion.sh stop
Wait until all Polarion processes have fully terminated before proceeding.

​
3. Remove the Existing RISKSHEET Plugin

You MUST completely delete the previous RISKSHEET folder from the Extensions directory before installing the new version. Copying over an existing installation leaves behind old files that cause initialization failures and menu disappearance.
Locate and remove the existing RISKSHEET plugin folder: 
# Navigate to Polarion extensions directory
cd <POLARION_HOME>/polarion/extensions

# List RISKSHEET folders to identify the plugin
ls -la | grep -i risksheet

# Example output:
drwxr-xr-x  5 polarion polarion 4096 Jan 15 10:30 nextedy-risksheet-25.5.0

# Delete the entire RISKSHEET folder
rm -rf nextedy-risksheet-*
Verify complete removal: 
# Confirm NO RISKSHEET folders remain
ls -la | grep -i risksheet

# Should return no results

​
4. Extract the New RISKSHEET Version

Extract the downloaded ZIP file into the Extensions directory: 
# Extract the new version
unzip nextedy-risksheet-<version>.zip -d <POLARION_HOME>/polarion/extensions/

# Set correct ownership
chown -R polarion:polarion <POLARION_HOME>/polarion/extensions/nextedy-risksheet-<version>

​
5. Verify Single Plugin Installation

Confirm that only ONE RISKSHEET folder exists in the Extensions directory: 
ls -la <POLARION_HOME>/polarion/extensions/ | grep -i risksheet

# Expected output (only ONE folder):
drwxr-xr-x  5 polarion polarion 4096 Feb 12 14:30 nextedy-risksheet-25.5.0
If you see multiple RISKSHEET folders, the plugin will fail to initialize and the RISKSHEET menu will disappear from the Polarion interface. Delete all but the newest version.

​
6. Restart Polarion

Start the Polarion server to load the updated plugin: 
cd /opt/polarion
./polarion.sh start
Monitor the startup log for RISKSHEET initialization: 
tail -f <POLARION_HOME>/data/logs/polarion.log | grep -i risksheet

​
7. Verify the Update

Log into Polarion and confirm the new version is active:
  1. Navigate to any RISKSHEET document
  2. Open Menu > About
  3. Verify the version number matches the downloaded release
Update Flow: diagram

​
Troubleshooting

If the RISKSHEET menu disappears after updating:
  1. Stop Polarion
  2. Check for multiple RISKSHEET folders: ls <POLARION_HOME>/polarion/extensions/ | grep risksheet
  3. Delete ALL RISKSHEET folders completely
  4. Extract the new version again
  5. Restart Polarion
See Menu Disappeared After Update for detailed resolution steps.

​
Configuration Compatibility

Most RISKSHEET updates preserve existing configuration files. However, major version upgrades may require configuration adjustments.
Check the Changelog for breaking changes between versions. Some releases introduce new configuration properties or deprecate old ones.

​
Post-Update Actions

Clear browser cache: After updating RISKSHEET, instruct all users to clear their browser cache or perform a hard refresh (Ctrl+Shift+R) to load the new JavaScript and CSS assets. Test configuration: Open existing RISKSHEET documents and verify that columns, formulas, and styling render correctly. Review new features: Check the Changelog for new features and configuration options available in the updated version.

​
Verification

You should now see the updated RISKSHEET version number in Menu > About, and all RISKSHEET documents should load without errors. The RISKSHEET menu item should be visible in the Polarion navigation bar for all projects with risk documents.

​
See Also

KB ArticlesSupport TicketsSource Code
  • RisksheetViewServlet.java
  • RisksheetProjectProperties.java
  • RefreshSheetCommand.ts
  • AppConfigParser.ts
  • AppConfig.ts