Configure the TEXTML Server connection settings

The Output Generator's outputgenerator.xml file defines the Output Generator's connection settings for the TEXTML Server.

To configure the Output Generator's connection settings:

  1. Open the %OutputGenDir%/conf/outputgenerator.xml file.
    Note: If this is the first time that you are installing the Output Generator, open the outputgenerator.xml.empty file and save it as outputgenerator.xml (remove the .empty suffix).
    The file looks as follows:
    <outputgenerator>
       <textml address="IP_ADDRESS_IS_NOT_USED_LEAVE_EMPTY" port="2500" forceupdate="false" version="4" secure="false">
          <docbase></docbase>
          <user domain="DOCBASE_NAME_IS_NOT_USED_LEAVE_EMPTY" name="outgen-username" password="pwd"/>
          <timeout>500000</timeout>
       </textml>
    </outputgenerator>
  2. In the <user> element, enter the domain, user name, and password used by the Output Generator to connect to the TEXTML Server.

    For example:

    <user domain="ixiasoft" name="OutputGenerator" password="ixiasoft"/> 
    Note: The name attribute cannot be empty.
    Note: You can also encrypt the password using the encrypt utility in the %OutputGenDir%/bin directory. See the "Encrypt a password" section for the procedure.
  3. The other parameters in the file can be left as is, unless you are using the branding feature or SSL authentication. In this case, you must specify the following information:
    1. In the port attribute, enter the TEXTML Server port.

      For example:

      port="2500"
      If you are using SSL security, specify the secure SSL port; for example:
      port="2551"
      Note: To enable SSL, you may also need to install a CA certificate on the Output Generator server. See Installing and Configuring TEXTML Server for DITA CMS for more information.
    2. Leave the forceupdate and version values unchanged.
    3. If you are using SSL, set the secure parameter to "true".
    4. Leave the timeout value as is.

      This value specifies the time limit for the Output Generator to connect to the TEXTML Server, in milliseconds.

      After your changes, the outputgenerator.xml file might look as follows:

      <outputgenerator>
         <textml address="IP_ADDRESS_IS_NOT_USED_LEAVE_EMPTY" port="2500" forceupdate="false" version="4" secure="false">
            <docbase>DOCBASE_NAME_IS_NOT_USED_LEAVE_EMPTY</docbase>
            <user domain="acme" name="outgen" password="outgenpass"/>
            <timeout>500000</timeout>
         </textml>
      </outputgenerator>
  4. Save and close outputgenerator.xml.