Haruno Knowledge base

When a plugin page has a problem

What the messages on a plugin page such as the Portfolio mean, and what to do about each one, from a Reload page button to a drive that is not connected.

  • Mac appIn developmentA developer preview, switched off for every customer. The Portfolio is built into the Mac app, not an add-on.
  • Windows appAvailableAdd-ons are made and signed by Haruno, and install and update on their own. The Portfolio add-on is always on.
In development in the Mac app. It is not available to customers yet. Do not promise it.

A plugin page, such as the Portfolio, draws inside the app but is run by its own add-on. When that add-on has trouble, the page says so in plain words and, where it can, offers a button. Plugins themselves are explained on Plugins.

What you may see

What you seeWhat it meansWhat to do
Setting up… in the menu where Portfolio will beA new PC is installing the Portfolio.Wait. It appears when it is done.
Couldn’t install — retryingThe first install did not finish, for example because the PC was offline.Nothing. Haruno retries on its own.
This page could not load. with Reload pageThe page's code failed to load, or the page hit an error.Press Reload page.
This page needs an update of Haruno. The menu entry is greyed out.This version of Haruno is too old for the plugin's page. The page does not run.Update Haruno. See Automatic updates.
This page stopped after repeated errors. with RestartThe plugin stopped several times in a short while, so Haruno stopped it. Nothing restarts it by itself.Press Restart. The page then reads afresh.
The plugin stopped while working on this. Try again.The plugin stopped part way through your request.Try the action again. The plugin starts again by itself.
The plugin could not do this.The request failed.Try again. If it keeps happening, tell us what you were doing.
This page is not available.The plugin was removed or has been switched off.For an optional plugin such as Stellar wallets, turn it on again in Settings ▸ Connectors.
A new version is ready. with ReloadAn update arrived while the page was open.Press Reload when you are ready.

A plugin that stopped

The bar across the top of a stopped plugin's page. Pointing at its menu entry shows the same words.
A warning bar that says This page stopped after repeated errors, with a Restart button.A warning bar that says This page stopped after repeated errors, with a Restart button.

While a plugin is stopped, the page still opens so you can reach its own controls, but its actions are refused. Pressing Restart brings it back.

A plugin update that waits for you

If a new version of the plugin arrives while its page is open, the page keeps the old version so it does not change under you, and shows A new version is ready. Press Reload to switch. If the plugin is in the middle of a job, such as a long close of the month, Reload is refused with "The plugin is still working. Reload once it finishes." The job is not cut short. When nothing is running, the update installs by itself.

The Portfolio's books are on a drive that is not connected

If the books were moved to another drive and that drive is not there, the Portfolio cannot work. Haruno says: "The folder the books were moved to isn’t available. Connect the drive it is on and try again, or open Books from the Portfolio toolbar to move them back to Haruno’s own folder." Connect the drive, or move the books back to Haruno's own folder.

What to tell a customer

  • Try Reload page or Restart first. Both are safe.
  • If a page asks for an update of Haruno, the fix is to update the app, not the plugin.
  • If a plugin stops again and again, note the Haruno version and when it happened. See What Haruno keeps to find problems.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,45 @@
    +---
    +title: When a plugin page has a problem
    +summary: What the messages on a plugin page such as the Portfolio mean, and what to do about each one, from a Reload page button to a drive that is not connected.
    +feature: plugins
    +covers:
    +  - windows-client/haruno-webview/web/src/plugins/PluginPage.tsx
    +  - windows-client/haruno-webview/web/src/plugins/PluginWorkspace.tsx
    +  - windows-client/Haruno.Desktop.Services/Plugins/PluginHost.cs
    +---
    +
    +A plugin page, such as the Portfolio, draws inside the app but is run by its own add-on. When that add-on has trouble, the page says so in plain words and, where it can, offers a button. Plugins themselves are explained on [Plugins](/windows/app/plugins/).
    +
    +## What you may see
    +
    +| What you see | What it means | What to do |
    +|---|---|---|
    +| **Setting up…** in the menu where Portfolio will be | A new PC is installing the Portfolio. | Wait. It appears when it is done. |
    +| **Couldn’t install — retrying** | The first install did not finish, for example because the PC was offline. | Nothing. Haruno retries on its own. |
    +| **This page could not load.** with <Ui>Reload page</Ui> | The page's code failed to load, or the page hit an error. | Press <Ui>Reload page</Ui>. |
    +| **This page needs an update of Haruno.** The menu entry is greyed out. | This version of Haruno is too old for the plugin's page. The page does not run. | Update Haruno. See [Automatic updates](/windows/app/updates/). |
    +| **This page stopped after repeated errors.** with <Ui>Restart</Ui> | The plugin stopped several times in a short while, so Haruno stopped it. Nothing restarts it by itself. | Press <Ui>Restart</Ui>. The page then reads afresh. |
    +| **The plugin stopped while working on this. Try again.** | The plugin stopped part way through your request. | Try the action again. The plugin starts again by itself. |
    +| **The plugin could not do this.** | The request failed. | Try again. If it keeps happening, tell us what you were doing. |
    +| **This page is not available.** | The plugin was removed or has been switched off. | For an optional plugin such as Stellar wallets, turn it on again in <Ui>Settings ▸ Connectors</Ui>. |
    +| **A new version is ready.** with <Ui>Reload</Ui> | An update arrived while the page was open. | Press <Ui>Reload</Ui> when you are ready. |
    +
    +## A plugin that stopped
    +
    +<Shot src="/m/7849707201d5-windows-plugins-faulted-light.png" dark="/m/f9ed50aa0a03-windows-plugins-faulted-dark.png" alt="A warning bar that says This page stopped after repeated errors, with a Restart button." caption="The bar across the top of a stopped plugin's page. Pointing at its menu entry shows the same words." />
    +
    +While a plugin is stopped, the page still opens so you can reach its own controls, but its actions are refused. Pressing <Ui>Restart</Ui> brings it back.
    +
    +## A plugin update that waits for you
    +
    +If a new version of the plugin arrives while its page is open, the page keeps the old version so it does not change under you, and shows **A new version is ready.** Press <Ui>Reload</Ui> to switch. If the plugin is in the middle of a job, such as a long close of the month, Reload is refused with "The plugin is still working. Reload once it finishes." The job is not cut short. When nothing is running, the update installs by itself.
    +
    +## The Portfolio's books are on a drive that is not connected
    +
    +If the books were moved to another drive and that drive is not there, the Portfolio cannot work. Haruno says: "The folder the books were moved to isn’t available. Connect the drive it is on and try again, or open Books from the Portfolio toolbar to move them back to Haruno’s own folder." Connect the drive, or move the books back to Haruno's own folder.
    +
    +## What to tell a customer
    +
    +- Try <Ui>Reload page</Ui> or <Ui>Restart</Ui> first. Both are safe.
    +- If a page asks for an update of Haruno, the fix is to update the app, not the plugin.
    +- If a plugin stops again and again, note the Haruno version and when it happened. See [What Haruno keeps to find problems](/windows/app/diagnostics/).