Edit online

Deploying Web Author in WebSphere Liberty

The following procedure is an example for a deployment ofOxygen XML Web Author in WebSphere Liberty:

  1. Download IBM WebSphere Liberty version 8.5.5.8. For information, see http://www-01.ibm.com/support/docview.wss?uid=swg24041178.
  2. Extract the contents of the downloaded archive into a folder.
  3. Open a command-line interface and go to that folder.
  4. Execute the following command:
    bin\server create
  5. Put the resulting .war file in: usr\servers\defaultServer\dropins.
  6. Modify usr\servers\defaultServer\server.xml with the following code:
    <?xml version="1.0" encoding="UTF-8"?>
    <server description="new server">
        <httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="5080" httpsPort="-1"/>
    
        <!-- Enable the required features -->
        <featureManager>
            <feature>localConnector-1.0</feature>
            <feature>servlet-3.1</feature>
        </featureManager>
    
        <!-- Automatically expand WAR files -->
        <applicationManager autoExpand="true"/>
    
        <!-- WebSphere does not like Shiro JSESSION-ID cookie format.
             Rename the default cookie. -->
        <httpSession cookieName="WEBSPHERE_JESSIONID"/>
    </server>
  7. Create a jvm.options file in [WEBSPHERE]\usr\servers\defaultServer\, with the following content:
    -Doxygen.data.dir=<path-to-wlp>\usr\servers\defaultServer\data
  8. The deployment will be made automatically by WebSphere (check [WEBSPHERE]\usr\servers\defaultServer\logs\console.log).
  9. In a command-line interface, execute the following command:
    server start --clean
Additional Information:
  • The application is deployed when the URL is first accessed (http://localhost:5080/oxygenxml-web-author/app/oxygen.html).
  • The Web Author log can be found in: data/logs/oxygen.log.
  • To view the status of the server, run: server status.
  • To stop the server, run: server stop.