Web Author Oxygen Data Directory
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
- /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 is started in
security mode or if you want to change the location of the Oxygen XML Data
Directory, you must set the
oxygen.data.dir system property.
Important:
WebSphere will erase the folder with
configuration files upon restart. For this server, 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.
- plugins Folder
- Contains the installed 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. These cannot be removed.
- user-frameworks Folder
- This folder is where you need to store any custom that you create. If you upgrade Oxygen XML 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 that you create. If you upgrade Oxygen XML 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.Important:This .java folder contains important settings. If you do not copy this folder, you will lose license server connection information.
- 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.