14. The "Install Add-ons" dialog box

[Note]

This dialog box is not available if XXE has been deployed using Java™ Web Start or as an applet.

The "Install Add-ons" dialog box is displayed by selecting menu item OptionsInstall Add-ons. It is used to install, uninstall or upgrade add-ons.

Figure 9.21. The "Install Add-ons" dialog box
The "Install Add-ons" dialog box
[Important]

XXE add-on manager assumes that proxy servers, if any, have been properly specified using the Proxies section of the Preferences dialog box.

[Tip]

If a problem occurs when listing the add-ons available for download and/or when uninstalling/installing the add-ons, use the "Show Message Log" button of the status bar, category "Install Add-ons", to see logged error messages.

Procedure 9.5. Install an add-on
  1. Select the Install tab.

  2. Click on the checkbox of the add-on to be installed (looks like this, when clicked looks like this).

    If an add-on is not listed in the the Install tab, it's either because this add-on is already installed[32] or because it is not available for the edition or version of XXE you are running or for your platform (e.g. not available for Linux).

  3. Click OK.

  4. Restart XXE as instructed by the dialog box.

Procedure 9.6. Uninstall an add-on
Figure 9.22. The Uninstall tab
The Uninstall tab
  1. Select the Uninstall tab.

  2. Click on the checkbox of the add-on to be uninstalled (looks like this, when clicked looks like this).

    [Note]
    • The rows of the Uninstall add-on table are given a light yellow background when the corresponding add-on is installed in the user preferences directory (XXE_user_preferences_dir/addon/), and a light cyan background when the corresponding add-on is installed in XXE installation directory (XXE_install_dir/addon/).

    • In order to make automatically upgrading add-ons each time you upgrade XXE a simple and reliable process, it is not possible to install, uninstall or upgrade any of the bundled add-ons found inside the XXE installation directory. That's why all light cyan rows are disabled (grayed).

    • If a light yellow row is disabled (grayed), it's either because you have insufficient privileges to uninstall the corresponding add-on, or on the Mac and Linux, because the subdirectory of XXE_user_preferences_dir/addon/ containing this add-on is a symlink.

  3. Click OK.

  4. Restart XXE as instructed by the dialog box.

Procedure 9.7. Upgrade an add-on
  1. Select the Install tab.

  2. Click on the checkbox of the add-on to be upgraded (looks like this ).

    [Note]
    • There is no need to also explicitly uninstall the corresponding add-on because this is done automatically for you. However it is harmless to do so.

    • If the row corresponding to the add-on to be upgraded is disabled (grayed), it's either because you have insufficient privileges to first uninstall this add-on, or on the Mac and Linux, because the subdirectory of XXE_user_preferences_dir/addon/ containing this add-on is a symlink.

  3. Click OK.

  4. Restart XXE as instructed by the dialog box.



[32] In such case, this add-on is listed in the Uninstall tab.