Configure the connection to the Content Store

The Scheduler must connect to the Content Store to synchronize the configuration locally.

If you do not configure the Content Store information, the Scheduler will not start. This information is provided in the <configuration> element, as shown below:
<!--  This section is required to synchronize CMS configuration locally -->
<configuration>
   <dita.cms url="hostname" port="2500" docbase="docbase" secure="false">
      <user domain="ixiasoft" username="testuser" password="password" synchdir="c:/temp/scheduler/"/>
   </dita.cms>
   <!--  TextMl, dita.out and smtp 
   If none are specified in job they fall back to this global TextMl connection -->
   <textml url="hostname" version="4" port="2500" docbase="docbase" secure="false">
      <user domain="ixiasoft" username="testuser" password="password"/>
   </textml>
   <dita.out url="localhost" port="1501" secure="false"/>
   <smtp url="smtp.ixiasoft.local" port="25" email="scheduler-noreply@ixiasoft.com" />
   <dumpQueue filename="SchedulerQueue.txt" />
</configuration>

The configuration element defines the default connection to the Content Store for all the Scheduler jobs. However, you can configure a connection that is specific to a Scheduler job by configuring the <textml>, <smtp>, or <dita.out> element inside the job. See the "Configure Scheduler jobs" section for more information.

To configure the connection to the Content Store:
  1. Open the %SchedulerDir%/conf/schedule.xml file.
    Note: If this is the first time that you are modifying the schedule.xml file, open the schedule.xml.empty file and save it as schedule.xml (remove the .empty suffix).
  2. In the <dita.cms> element, specify the following attributes:
    Attribute Description
    url IP address or name of the server hosting TEXTML Server.
    port TEXTML Server port (default is 2500). If you are using SSL security, specify the secure SSL port.
    docbase Name of the DITA CMS Content Store.
    secure

    If you are using SSL, set this parameter to "true".

    Note: To enable SSL, you may also need to install a CA certificate on the Scheduler. See Installing and Configuring TEXTML Server for DITA CMS for more information.
    For example:
    <dita.cms url="continuix" port="2500" docbase="d4dox" secure="false">
  3. In the <user> sub-element, specify the following attributes:
    Attribute Description
    domain, username, password
    Domain, username, and password used by the Scheduler to log in to the DITA CMS
    Note: You can also encrypt the password using the encrypt utility in the %SchedulerDir%/conf directory.
    synchdir Working directory of the Scheduler
    For example:
    <user domain="acme" username="CMSServiceUser" password="admin" 
    synchdir="C:\Ixiasoft\Scheduler\temp"/>
  4. In the <textml> element, specify the following attributes:
    Attribute Description
    id Currently not used. Leave this attribute as is.
    url IP address or name of the server hosting TEXTML Server.
    version TEXTML version.
    port TEXTML Server port (default is 2500). If you are using SSL security, specify the secure SSL port.
    docbase Name of the DITA CMS Content Store.
    secure

    If you are using SSL, set this parameter to "true".

    Note: To enable SSL, you may also need to install a CA certificate on the Scheduler. See Installing and Configuring TEXTML Server for DITA CMS for more information.

    In the <user> sub-element, specify the following attributes:

    Attribute Description
    domain, username, password
    Domain, username, and password used by the Scheduler to log in to the DITA CMS
    Note: You can also encrypt the password using the encrypt utility in the %SchedulerDir%/conf directory.
    For example:
    <textml url="Continuix" version="4" port="2500" docbase="d4dox" secure="false">
       <user domain="ixiasoft" username="CMSServiceUser" password="admin"/>
    </textml>
  5. In the <dita.out> element, specify the following attributes:
    Attribute Description
    url IP address or name of the Output Generator server.
    port Output Generator port (default is 1500).
    secure Currently not used. Leave the value to "false".
    For example:
    <dita.out url="hostname" port="1500" secure="false"/>
  6. In the <smtp> element, specify the following attributes:
    Attribute Description
    url Address of the SMTP server for sending the emails.
    port Port of the SMTP server.
    email Address that will be used as the From address when the email is sent (Optional).
    For example:
    <smtp url="smtp.ixiasoft.local" port="25"/> email="scheduler-noreply@ixiasoft.com" />
  7. Leave the <dumpQueue> element to filename="SchedulerQueue.txt".
    Note: The <dumpQueue> is a file that is created in the workspace each time a Scheduler job is processed. The file is located in the %SchedulerDir%/bin/ directory and lists all the Scheduler jobs currently in a queue.
  8. Save and close the schedule.xml file.