.. -*- coding: utf-8; -*-
.. include:: HEADER.rst

============
 LiquiBase.
============
.. contents::

Introducing LiquiBase to existing project.
==========================================

Official statement about introducing LiquiBase to existing project are:

  http://www.liquibase.org/documentation/existing_project.html
    Adding Liquibase on an Existing project

There are two approaches:

 * create full schema definition prior to introducing Liquibase
 * works only with current changes becase Liquibase basically work only with changesets and only
   special supplied instruments care about full schema definition

To create full schema debinition you may run::

  mvn liquibase:generateChangeLog -Dliquibase.outputChangeLogFile=...

on clean project without Liquibase. Or set name for changelog output file in ``pom.xml``.
(here reduced not fully worked declaration)::

  <plugin>
      <groupId>org.liquibase</groupId>
      <artifactId>liquibase-maven-plugin</artifactId>
      <version>${liquibase.version}</version>
      <configuration>
          <outputChangeLogFile>changelog.xml</outputChangeLogFile>
      </configuration>
  </plugin>

.. NOTE::

   ``pom.xml`` settings have precedence over ``-Dliquibase.outputChangeLogFile=...`` unless you
   define it as::

     <properties>
         <liquibase.outputChangeLogFile>${project.build.directory}/changelog.xml</liquibase.outputChangeLogFile>
     </properties>
     <plugins>
         <plugin>
             <configuration>
                 <outputChangeLogFile>${liquibase.outputChangeLogFile}</outputChangeLogFile>
             </configuration>
         </plugin>
     </plugins>