Configure access to the TEXTML Server and Output Generator

The next step is to configure the CMS Application Server to specify how to connect to the TEXTML Server and Output Generator.

To configure the CMS Application Server:
  1. Copy the glassfish/CMSAppServer.config file provided by IXIASOFT to your application server installation:
    For example:
    C:\glassfish3\glassfish\domains\cmsappserver\config (Windows)
    /opt/glassfish3/glassfish/domains/cmsappserver/config (Linux)
  2. Open the CMSAppServer.config file in an XML editor:
    <?xml version="1.0" encoding="UTF-8"?>
    <!-- This configuration file must be installed in glassfish. It is put in the 'config' folder inside the domain
    folder created for the domain in which the cms app server is running. -->
    <config>
        <textml-connection address='[textml-server-host]' port='[textml-port]' 
                           secure='false/true' docbase='docbase'/>
        <output-generator address='outputgen' port='outgen_port'/>
        <admin-login domain='userlogindomain' name='username' 
                     password='password'/>
        ...
        <session idle-time='time_in_minutes'/>
        ...
        <admin-tasks background-jobs='interval_in_minutes'/>
    </config>
  3. Update the fields in bold as follows:
    Field Value to enter
    [textml-server-host] Address of the TEXTML Server that contains the Content Store for the Web Author
    [textml-port] TEXTML Server port. If you are using SSL security, specify the secure SSL port.
    secure='false/true' If you are using SSL, set this parameter to "true". Otherwise, set to "false".
    Note: To enable SSL, you may also need to install a CA certificate on the Output Generator server. See Installing and Configuring the TEXTML Server for DITA CMS for more information.
    [docbase-name] Name of the Content Store on the TEXTML Server; this Content Store contains the documents for the Web Author
    [output-generator-host] Address of the Output Generator to connect to
    [outgen-port] Output Generator port to connect to
    userlogindomain, username, and password Domain, username, and password used by the CMS Application Server to log in to the TEXTML Server.
    Note: The username field cannot be empty.
    Important: IXIASOFT recommends that you use the service account dedicated to the DITA CMS components (for example, CMSServiceUser).
    time_in_minutes

    Maximum time (in minutes) that a session can be idle before the system cleans it up. Set a value greater than 7 minutes. If this value is set close to 5 minutes, the session may be lost before the document is actually saved. Also, this value must always be less than the ConnectionTimeOut value configured for the TEXTML Server. If this value is set to 0, the system automatically defaults it to 5 minutes, since constantly checking for idle sessions will cause a heavy load on the server. To disable this option, set this value to a negative number (e.g., -1); note that this is NOT recommended.

    interval_in_minutes Interval (in minutes) at which administrative tasks (such as configuration reloads, adding users, etc.) should run. If this value is set to 0, the system automatically defaults it to 10 minutes, since constantly doing administrative tasks will cause a heavy load on the server. To disable this option, set this value to a negative number (e.g., -1); note that this is NOT recommended.
    For example:
    <?xml version="1.0" encoding="UTF-8"?>
    <!-- ... -->
    <config>
        <textml-connection address='server.acme.local' port='2500' 
                           secure='false' docbase='production_docbase'/>
        <output-generator address='server.acme.local' port='1500'/>
        <admin-login domain="acme.local" name="CMSServiceUser" 
                     password="password"/>
        ...
       <session idle-time='480'/>
        ...
        <admin-tasks background-jobs='15'/>
    </config>
    Important:

    If your deployment uses version 4.3 of the TEXTML Server, the username used by the CMS Application Server to log in to the TEXTML Server must be assigned the Document Base Administrator role.

    Please contact IXIASOFT Support for more information.