Edit online

Web Author Oxygen Data Directory

Oxygen XML Web Author configuration files are stored in a single folder that can be shared among multiple servers in a distributed deployment. It can also be reused when you update the server to a new version.

The default location of this folder depends on the distribution:
Windows, Linux, and All Platforms Distributions
[OXYGEN_WEBAUTHOR_INSTALL_DIR]/tomcat/work/Catalina/localhost/oxygen-xml-web-author.
Web Archive Distribution
Depends on the servlet container. For example, in Tomcat, it is located in work/Catalina/localhost/oxygen-xml-web-author.
Attention: If the Oxygen XML Web Author is started in security mode or if you want to change the location of the Oxygen XML Web Author Data Directory, you must set the oxygen.data.dir system property.
Important: WildFly and WebSphere will erase the folder with configuration files upon restart. For these servers, you must set the oxygen.data.dir system property to a folder that persists across restarts.

Oxygen Data Directory Contents

options Folder

This folder contains:

autocorrect Folder
Contains autocorrect configuration files (.dat).
spell Folder
Contains term list configuration files for the spell checker (.tdi).
dicts Folder
Contains custom dictionary files (.dic and .aff).
license.properties File
This file contains connection details for the license servlet.
options.xml File
This file contains various options for Oxygen XML Web Author.
plugins Folder
Contains the installed Web Author plugins and the auto-generated plugin.dtd schema file used for validating the plugin.xml descriptors for each plugin.
frameworks Folder
Contains the built-in frameworks that are integrated into Oxygen XML Web Author. These cannot be removed.
user-frameworks Folder
This folder is where you need to store any custom Web Author frameworks that you create. If you upgrade Oxygen XML Web Author to a newer version, your custom frameworks will automatically be moved to this directory in the new version's directory structure.
user-plugins Folder
This folder is where you need to store any Web Author plugins that you create. If you upgrade Oxygen XML Web Author to a newer version, your plugins will automatically be moved to this directory in the new version's directory structure.
.java
This folder contains settings that are automatically created by the application. If you copy the license.properties or options.xml from one deployment to another one, you should also copy this folder.
shiro-users.ini File
Contains the Web Author administrator user credentials.

Bundling a Web Author Configuration

You can create a WAR distribution of a web application based on the Web Author Component that bundles the configuration. The configuration files need to be placed in the WEB-INF folder with the following structure:
  • frameworks.zip - A zip archive with the frameworks that will be included in the application.
  • plugins.zip - A zip archive with the plugins that will be included in the application.
  • options.xml - A file that contains pre-configured options.
  • license.properties - A file that contains the details about the license server connection.

Result: The bundled configuration will be copied to the data directory when the application starts. When redeploying the application with a new configuration, it is recommended to clear the old configuration by deleting the contents of the data directory.