Edit online

Protocol Handlers Cannot Be Installed

Problem

You receive an error saying that "Protocol handlers could not be installed".

Cause

This is a possible error when using the WAR distribution of Oxygen XML Web Author because the WAR must be put in Tomcat and run with Java 17.

Solution

Add the following arguments to the JVM that runs Web Author:
--add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED

To do so, follow the procedure below for the type of installer you used.

Windows Installer

To add the above arguments in Oxygen XML Web Author (in the Solution section), follow these steps:
  1. Go to the installation directory of Oxygen XML Web Author.
  2. Launch Manage Web Author.
  3. Go to the Java tab.
  4. In the Maximum memory pool option, enter the arguments above.
  5. Restart the application.

Linux Installer or All Platforms Kit

To add the above arguments in Oxygen XML Web Author (in the Solution section), follow these steps:
  1. Go to the installation directory of Oxygen XML Web Author.
  2. Edit the oXygenXmlWebAuthor.vmoptions file.
  3. Add the arguments presented in the Solution section.
  4. Restart the application.