Configure access to CMS Application Server

The next step is to configure the Web Author Application to specify how to connect to the CMS Application Server.

To configure access to the CMS Application Server:

  1. Open the following file in an XML editor:
    %TomcatDir%/conf/webauthor/webconfig.xml
    Note: The actual path may vary according to your deployment. The folder name MUST match the name of the .war file installed for this Web Author 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>
    	
    </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.
    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>
    </properties>
  2. Save and close the file.