Configure access to the DITA CMS, CMS Application Server, and oXygen License Servlet

The next step is to configure the Web Author Application to specify how to connect to the DITA CMS, CMS Application Server, and oXygen License Servlet.

To configure the Web Author Application:

  1. Open the following file in an XML editor:
    %TomcatDir%/conf/webauthor/webconfig.xml
    Note: The actual path may vary according to your deployment.
    This file specifies how to connect to the CMS Application Server and looks as follows:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
    <properties>
       <comment>Connection configuration for CMS Application Server</comment>
    <!--Configured admin user MUST be defined in the DITA CMS users.xml profiles. -->
       <entry key="administrator.domain">admin_domain</entry>
       <entry key="administrator.name">admin_name</entry>
       <entry key="administrator.password">admin_password</entry>
    
       <entry key="server.address">cms_app_server_address</entry>
       <entry key="server.port">3700</entry>
       <entry key="license.servlet.url">
              license_servlet_url/oxygenLicenseServlet/license-servlet
       </entry>
       <entry key="license.servlet.username">license_username</entry>
       <entry key="license.servlet.password">license_password</entry>
    
    <!-- 
       ...
     -->
       <entry key="default.login.domain">default_domain</entry>
       <entry key="web.author.application.cfg">web.author.roles.xml</entry>
    <!-- 
       ...
     -->
    
    	<entry key="cms.webauthor.frameworks.path"></entry>
    	<entry key="cms.webauthor.options.path"></entry>
    </properties>
    

    Update the fields in bold as follows:

    Field Enter this value
    admin_domain, admin_name, admin_password Domain, username, and password used by the Web Author Application to log in to the DITA CMS and retrieve files required to run the Web Author (for example, the online help). IXIASOFT recommends that you use CMSServiceUser as the username.
    Note: You must also add this user to the DITA CMS, as described in Create a service user in the DITA CMS.
    cms_app_server_address Address of the CMS Application Server.
    license_username, license_password If you are using the oXygen License Servlet, enter the username and password that you set for the License Servlet (for example, license and license).
    Note: Do not update these fields if you are using site licenses.
    license_servlet_url If you are using the oXygen License Servlet, enter the URL of the License Servlet; this is the URL that the Web Author Client will use to find the License Servlet.
    Note: Do not update this field if you are using site licenses.
    default_domain Default domain when users log in to the Web Author. This ensures that users only need to enter a username and password when logging in to the Web Author. If you do not use domains for user logins, leave this field empty. This field is optional.
    You can leave all the other fields as is.
    For example:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
    <properties>
       <comment>Connection configuration for CMS Application Server</comment>
       <!--  Configured admin user MUST be defined in the DITA CMS users.xml profiles. -->
       <entry key="administrator.domain">acme</entry>
       <entry key="administrator.name">CMSServiceUser</entry>
       <entry key="administrator.password">admin</entry>
    	
       <entry key="server.address">cmsappserver</entry>
       <entry key="server.port">3700</entry>
       <entry key="license.servlet.url">
              http://www.acme.com/oxygenLicenseServlet/license-servlet
       </entry>
       <entry key="license.servlet.username">license</entry>
       <entry key="license.servlet.password">license</entry>
    	<!-- 
    		...
    	-->
       <entry key="default.login.domain">acme</entry>
       <entry key="web.author.application.cfg">web.author.roles.xml</entry>
       <!-- 
    		...
    	-->
       <entry key="cms.webauthor.frameworks.path"></entry>
       <entry key="cms.webauthor.options.path"></entry>
    </properties>
  2. Save and close the file.