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

# Troubleshoot Administration Issues

> Resolve common Nextedy RISKSHEET administration problems including empty setup pages, server log errors, and configuration failures.

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>;
};

## Common Issues and Solutions

### Empty Setup or License Pages

**Symptom:** After installing or updating Risksheet, the Setup and License pages in Administration are empty or fail to load.

**Cause:** Plugin caches were not cleared after the update.

**Fix:**

1. Stop the Polarion server.
2. Delete the `[POLARION_INSTALL]/data/workspace/.config` directory.
3. Restart the Polarion server.
4. Navigate to **Administration** > **Nextedy Risksheet** > **Setup** to verify.

<Warning title="Always Clear Caches After Updates">
  This is the most common post-installation issue. Delete `[POLARION_INSTALL]/data/workspace/.config` after every Risksheet installation or update.
</Warning>

### Risksheet Menu Not Appearing

**Symptom:** The Risksheet entry does not appear in the project navigation after installation or update.

**Cause:** Either two plugin versions exist in the extensions folder, or the Risksheet topic is not configured for the user's view/role.

**Fix:**

1. Check `[POLARION_INSTALL]/polarion/extensions/` for duplicate Risksheet folders. Delete the old version.
2. Verify **Administration** > **Topics** includes the Risksheet topic for all relevant views and roles.
3. If the `.metadata` folder exists in the extensions directory, delete it.

### UnsupportedOperationException in Server Logs

**Symptom:** Server logs show `UnsupportedOperationException` related to document field rendering (for example, `renderingLayouts`) when opening a Risksheet.

**Cause:** A known document field rendering issue, particularly after upgrading to Polarion 2310.

**Fix:** This error has **no functional impact** on Risksheet. The system skips failed fields and continues normally. Update to Risksheet 24.7.0+ to suppress these log entries.

| Symptom                           | Cause                                        | Resolution                                                      |
| --------------------------------- | -------------------------------------------- | --------------------------------------------------------------- |
| **Empty Admin Pages**             | Corrupted workspace config                   | Delete `data/workspace/.config`, restart Polarion               |
| **Menu Missing**                  | Duplicate extensions or missing topic config | Check `extensions/` for duplicates, verify Topics configuration |
| **UnsupportedOperationException** | Known document field rendering issue         | Non-harmful -- update to Risksheet 24.7.0+ to suppress          |
| **StringIndexOutOfBounds**        | Misconfigured sheet configuration            | Check sheet configuration syntax with JSON linter               |
| **Query Parse Errors**            | Invalid Polarion configuration               | Check Polarion config settings                                  |
| **License Shows 0 Users**         | Missing user group                           | Create `nextedy_powersheet_users` group or restart Polarion     |

### Velocity Template Errors

**Symptom:** `StringIndexOutOfBoundsException` appears in server logs, possibly related to `risksheetTopPanel.vm` or other Velocity templates.

**Cause:** Misconfigured sheet configuration or custom Velocity template files.

**Fix:**

1. Review your sheet configuration for syntax errors.
2. Check any custom `risksheetTopPanel.vm` template for malformed Velocity expressions.
3. Validate JSON syntax using a JSON linter.

### License Shows 0 Named Users

**Symptom:** The License page shows 0 named users despite users being in the `nextedy_risksheet_users` group.

**Cause:** Either the license needs to be refreshed, a service restart is required, or the user group name is wrong after a version upgrade.

**Fix:**

1. Reopen the **Administration** > **Nextedy Risksheet** > **License** page.
2. If still 0, restart the Polarion service.
3. If both Risksheet and Powersheet are installed (v25.11.0+), create a `nextedy_powersheet_users` group and add users to it.

<Tip title="Custom Help URL">
  If your team needs access to internal documentation, configure the `settings.global.help` property in your sheet configuration to point to your organization's documentation URL. The default points to the official Nextedy support portal.
</Tip>

## Verification

After resolving any of the above issues, you should now see the Risksheet administration pages loading correctly, the navigation menu appearing for all configured user roles, and the License page displaying the correct version and user counts.

## See Also

* [Update Risksheet](/risksheet/guides/administration/update) -- correct update procedures to avoid common issues
* [Configure Permissions](/risksheet/guides/administration/permissions) -- resolve permission-related access problems
* [Add Risksheet to Existing Project](/risksheet/guides/administration/project-setup) -- verify project setup is complete

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