Edit online

Deploying Web Author in WebSphere (Traditional)

Oxygen XML Web Author should be deployed on its own server so that it does not share the same JVM with other web applications.

Configuring the JVM

  1. In the WebSphere web console, select Servers > Server Types > WebSphere application servers and choose the server that will run Web Author.
  2. Under Server Infrastructure, expand Java and Process Management and click Process definition.
  3. Under the Additional Properties section (right), select Java Virtual Machine.
  4. In the General Properties section, enter 256 for Initial heap size and 1536 for Maximum heap size.
  5. In Generic JVM arguments, add: -Dcom.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true. This will disable the built-in JAX-RS support ( https://www-01.ibm.com/support/knowledgecenter/SSAW57_8.0.0/com.ibm.websphere.nd.doc/info/ae/ae/twbs_jaxrs_disable_runtime.html).
  6. Click the Apply button and then the Save link that appears on the top of the page.

Configuring the Cookie Handling

You can use the v0CookieDateRFC1123compat property to allow cookie expiry dates to be specified in the four-digit year format instead of the two-digit year format. By default, they have the millennium problem. For example, 2084 is represented as '84, which is the same as 1984. More details about the configuration can be found here: https://www-01.ibm.com/support/knowledgecenter/SS7K4U_8.5.5/com.ibm.websphere.nd.doc/ae/rrun_chain_httpcustom.html

  1. Select the server as in the previous section.
  2. Under the Container Settings section (right), expand Web Container Settings and select Web container transport chains.
  3. Select the HttpQueueInboundDefaultSecure entry and then HTTP inbound channel (HTTP_4).
  4. Under the Additional Properties section (right), select Custom properties and click the New button.
  5. Add the v0CookieDateRFC1123compat property name with the value true.
  6. Click the Save link that appears at the top of the page.
  7. Restart Oxygen XML Web Author.

Installing Web Author

Now the application can be deployed:

  1. In the WebSphere web console, expand the Applications section and Application Types under it.
  2. Select Websphere enterprise applications and uninstall any previous Web Author installations.
  3. Under the Applications section, select New Application.
  4. Click on New Enterprise Application.
  5. Choose the .war file, click Next, and wait until the next screen appears.
  6. Choose Fast Path and click Next until the 4th step.
  7. Set the Context Root to /oxygenxml-web-author/.
  8. Click Next at every step and then Finish.
  9. After the processing is done, click the Save link that appears at the bottom of the page.

Configuring Web Author

Set the application class-loader to be parent-last:
  1. Go to Applications > Application Types > WebSphere enterprise applications.
  2. Choose the Web Author application.
  3. Under the Modules section (right), click Manage Modules.
  4. Click on the oxygenxml-web-author module.
  5. Set the Class loader order option to classes loaded with the local class-loader first (parent-last).
  6. Click Apply and then the Save link when it appears.
  7. Restart Oxygen XML Web Author.