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 21.0.0.3. For information, see https://www.ibm.com/support/pages/21003-websphere-application-server-liberty-21003.
  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 Oxygen XML Web Author .war file in: usr\servers\defaultServer\dropins.
  6. Modify usr\servers\defaultServer\server.xml with the following code:
    <server description="new server">
    
        <!-- Enable features -->
        <featureManager>
            <feature>javaee-8.0</feature>
            <feature>localConnector-1.0</feature>
            <feature>servlet-3.1</feature>
            <feature>websocket-1.1</feature>
        </featureManager>
        <!-- To access this server from a remote client add a host attribute to 
             the following element, e.g. host="*" -->
        <httpEndpoint httpPort="9080" httpsPort="9443" id="defaultHttpEndpoint"/>
    
        <!-- Automatically expand WAR files and EAR files -->
        <applicationManager autoExpand="true"/>
        <classloading useJarUrls="true"/>
        <httpSession cookieName="WEBSPHERE_JESSIONID"/>
    
        <webContainer
           com.ibm.ws.webcontainer.initFilterBeforeInitServlet="true"
           com.ibm.ws.webcontainer.invokeFilterInitAtStartup="true"  />
    
        <applicationMonitor updateTrigger="mbean"/>
    
        <keyStore id="defaultKeyStore" password="[keystore password]"/>
    
        <basicRegistry id="basic" realm="BasicRealm">
        </basicRegistry>
    </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. Run the following command to install all the required components
    bin\installUtility install defaultServer
  9. The deployment will be made automatically by WebSphere (check [WEBSPHERE]\usr\servers\defaultServer\logs\console.log).
  10. In a command-line interface, execute the following command:
    bin\server start --clean
Additional Information:
  • The application is deployed when the URL is first accessed (http://localhost:9080/oxygenxml-web-author/app/oxygen.html).
  • The Web Author log can be found in: <path-to-wlp>\usr\servers\defaultServer\data\logs\oxygen.log.
  • To view the status of the server, run: bin\server status.
  • To stop the server, run: bin\server stop.