What's this?

This page explains how to upgrade your LogDistiller files to stays up-to-date with latest software best practices.

Everything is done to maintain strict compatibility (you are not forced to change your files when upgrading to a new version), but you are encouraged to make some little changes with each new version.

0.6.1 to 0.7

update build.xml as follow:

<logdistiller conf="myconf.xml" mail="true">
  ...
  <logevent logtype="logtype-id"/>
  ...
  <logdistillation destdir="dest-dir" content="content description" skipgroups="groups to skip"/>
  ...

to

<logdistiller conf="myconf.xml" publish="all">
  ...

  ...

and update your rules configuration files:

<?xml version="1.0" ?>
<!DOCTYPE logdistiller SYSTEM "http://logdistiller.sourceforge.net/dtd/logdistiller-1_2.dtd">
<logdistiller id="test.wl">
  <description>my description</description>
  ...
  <param name="mail.to">...</param>
  <param name="mail.smtp.host">...</param>
  <param name="logs.url">...</param>

  <!-- logevent description (just to recall, not really needed) -->
  <param name="logevent.type">logtype-id</param>
  <param name="logevent.attributes">logtype-attributes</param>

  <group id="group-id">
    <description>group description</description>
    <param name="mail.to">admin@localhost</param>
    <condition>
      ...
    </condition>
    <plugin type="plugin-type"/>
  </group>
  ...

to

<?xml version="1.0" ?>
<!DOCTYPE logdistiller SYSTEM "http://logdistiller.sourceforge.net/dtd/logdistiller-1_3.dtd">
<logdistiller id="test.wl">
  <description>my description</description>
  <logtype id="logtype-id">
    <param name="attributes">logtype-attributes</param>
  </logtype>
  <output directory="dest-dir" content="content description" skip="groups to skip"
    url="...">
    <param name="mail.smtp.host">...</param>

    <report publisher="file"/>
    <report publisher="mail">
      <param name="to">...</param>
    </report>
  </output>
  ...

  <group id="group-id">
    <description>group description</description>
    <condition>
      ...
    </condition>
    <report publisher="file"/> (no more file report by default)
    <report publisher="mail">
      <param name="to">admin@localhost</param>
    </report>
    <plugin type="plugin-type"/>
  </group>
  ...

0.6 to 0.6.1

update build.xml as follow:

<logdistiller conf="myconf.xml" mail="true">
  ...
  <logevent factory="logtype"/>
  ...
 
<logdistiller conf="myconf.xml" mail="true">
  ...
  <logevent logtype="logtype"/>
  ...