Changeset 3355


Ignore:
Timestamp:
May 21, 2007, 4:40:49 PM (14 years ago)
Author:
Jari Häkkinen
Message:

Addresses #516. Migration instructions done.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/src/docbook/admindoc/installation_upgrade.xml

    r3350 r3355  
    6666
    6767    <important>
    68       Note to PostgreSQL users: Upgrading BASE to versions earlier
     68      <title>Note to PostgreSQL users</title>
     69      Upgrading BASE to versions earlier
    6970      than v2.2 is not be safe with an PostgreSQL database engine due
    7071      to a bug in Hibernate. The problem is reported to Hibernate
     
    252253
    253254  </sect1>      <!-- Upgrade instructions -->
    254 
    255 
    256255
    257256
     
    685684  <sect1 id="installation_upgrade.migration">
    686685    <title>Migration instructions</title>
    687     <para></para>
     686
     687    <caution>
     688      <title>The disclaimer section</title>
     689      <para>
     690        We have made extensive testing of the migration from BASE1.2
     691        to BASE2. To our knowledge the migration works but we cannot
     692        guarantee perfect functionality. The migration tool is
     693        supplied as is and usage is done at your risk. We are
     694        committed to solve migration problems at the level of
     695        transferring data from BASE 1.2 to 2.2.x, but cannot resolve
     696        data loss issues in a running BASE 2 server due to imperfect
     697        migration. When you start the migration tool you are required
     698        to pass parameter <emphasis>"disclaimer_understood"</emphasis>
     699        to the <filename>migrate_from_1.2.sh</filename>
     700        script. Remember to check that the migration performed well
     701        before you decide to delete your 1.2 installation.
     702      </para>
     703      <para>
     704        Migration from the latest BASE 1.2.x release to the latest is
     705        supported.
     706      </para>
     707    </caution>
     708
     709    <para>
     710      Verify that your BASE 2 installation is up and running before
     711      attempting migration. Preferably try to log in using the root
     712      user through the web interface.
     713    </para>
     714
     715    <para>
     716      Make sure your BASE 1.2 runs with the latest
     717      (<emphasis>pristine</emphasis>) schema
     718      version, <emphasis>i.e.,</emphasis> the migration will only
     719      support an unmodified BASE 1.2 installation. If you have an out
     720      of date schema version, please upgrade to the latest schema
     721      using BASE 1.2 tools before migrating. If you have made local
     722      changes to the BASE 1.2 schema you need to patch the BASE 2
     723      schema as well as make proper changes to the migration program.
     724    </para>
     725
     726    <para>
     727      There is currently no way to restart a migration. The behaviour
     728      of migration is controlled
     729      through <filename>migration.properties</filename> file, but you
     730      should know what you do when you change parameters in this file.
     731    </para>
     732
     733    <para>
     734      Migration is performed with the following steps:
     735      <orderedlist>
     736
     737        <listitem>
     738          <para>
     739            To transfer files from BASE 1.2 (default migration
     740            behaviour), you must have file system access to BASE 1.2
     741            files, <emphasis>i.e.,</emphasis> the <filename
     742            class="directory">/path/to/base1.2/data</filename>
     743            directory containing directories
     744            <filename class="direcotry">rawdata</filename>,
     745            <filename class="direcotry">uploads</filename>,
     746            <filename class="direcotry">protocols</filename>, ...
     747          </para>
     748        </listitem>
     749
     750        <listitem>
     751          <para>
     752            Change settings in the file
     753            <filename>/path/to/base/dist/www/WEB-INF/classes/migrate.properties</filename>.
     754            The available options are commented:
     755            <itemizedlist>
     756              <listitem>
     757                <para>
     758                  Modify <emphasis>db1.*</emphasis> parameters to
     759                  match your BASE 1.2 installation.
     760                </para>
     761              </listitem>
     762              <listitem>
     763                <para>
     764                  Set <emphasis>userfiles</emphasis> (note, this is
     765                  not the same parameter as
     766                  in <filename>base.config</filename>) to point to the
     767                  directory containing the BASE 1.2 files (defined in a
     768                  previous step above).
     769                </para>
     770              </listitem>
     771              <listitem>
     772                <para>
     773                  Set the <emphasis>pluginDir</emphasis> to point to
     774                  the directory where your BASE 1.2 plug-ins are
     775                  installed. The default is
     776                  <filename
     777                  class="direcotry">/usr/local/base/plugins</filename>.
     778                </para>
     779              </listitem>
     780              <listitem>
     781                <para>
     782                  Modify <emphasis>root.password</emphasis>.
     783                </para>
     784              </listitem>
     785              <listitem>
     786                <para>
     787                  Change the <emphasis>deletefiles</emphasis> setting
     788                  wisely. If you
     789                  set <emphasis>deletefiles=yes</emphasis> all BASE
     790                  1.2 files will be physically removed when copied to
     791                  BASE 2. Leave this options
     792                  as <emphasis>deletefiles=no</emphasis> unless you
     793                  are absolutely sure of what you are doing.
     794                </para>
     795              </listitem>
     796            </itemizedlist>
     797          </para>
     798        </listitem>
     799
     800        <listitem>
     801          <para>
     802            Run migration utility: <programlisting>
     803cd /path_to_base/dist/bin
     804./migrate_from_1.2.sh
     805</programlisting>
     806          </para>
     807        </listitem>
     808
     809        <listitem>
     810          <para>
     811            Migration done! Happy BASEing.
     812          </para>
     813        </listitem>
     814
     815      </orderedlist>
     816
     817    </para>
     818
    688819  </sect1>      <!-- Migration instructions -->
     820
     821
    689822
    690823  <sect1 id="installation_upgrade.jobagents">
Note: See TracChangeset for help on using the changeset viewer.