Changeset 3713

Timestamp:

Sep 7, 2007, 11:23:47 AM (16 years ago)

Author:

Jari Häkkinen

Message:

Addresses #744. Added information about migration restart do documentation.

File:

• branches/2.4-stable/doc/src/docbook/admindoc/installation_upgrade.xml (modified) (4 diffs)

branches/2.4-stable/doc/src/docbook/admindoc/installation_upgrade.xml

@@ -48 +48 @@
   <para>
     The first time installation is only to be performed once,
-    optionally followed by a migration. The migration can only be
-    done to a pristine (empty) BASE 2 server, and migration from
-    several BASE 1 installations to one BASE 2 server is not
-    supported.
+    optionally followed by a migration. The migration can only be done
+    to a pristine (empty) BASE 2 server with one exception; The
+    migration can be restarted if it fails during the RawBioAssaysData
+    transfer, for all other failure points the migration has to be
+    restarted with an empty database. Migration from several BASE 1
+    installations to one BASE 2 server is not supported.
   </para>
 
@@ -1008 +1010 @@
             <xref linkend="user_administration"/>.
           </para>
+          <para>
+            If you are planning to perform a migration of data from
+            BASE 1.2.x please perform the steps in
+            <xref linkend="installation_upgrade.migration"/> before
+            doing anything else with your new BASE installation.
+          </para>
         </listitem>
       </varlistentry>
@@ -1059 +1067 @@
 
     <para>
-      There is currently no way to restart a migration. The behaviour
-      of migration is controlled
-      through <filename>migration.properties</filename> file (see <xref linkend="appendix.migrate.properties"/>), but you
-      should know what you do when you change parameters in this file.
+      The behaviour of migration is controlled
+      through <filename>migration.properties</filename> file (see
+      <xref linkend="appendix.migrate.properties"/>), but you should
+      know what you do when you change parameters in this file.
+    </para>
+
+    <para>
+      Migration can be restarted in one specific case only; If the
+      migration fails during the RawBioAssaysData transfer simply
+      restart the migration and the script will ask you to verify that
+      a restart should be attempted. For all other failure points the
+      migration has to be restarted with an empty database.
     </para>
 
@@ -1138 +1154 @@
 ./migrate_from_1.2.sh</programlisting>
           </para>
+          <para>
+            If the migration fails during the RawBioAssaysData
+            transfer you can restart the migration at the point of
+            failure. Simply restart the migration and the script will
+            ask you to verify that a restart should be attempted. For
+            all other failure points the migration has to be restarted
+            with an empty database.
+          </para>
         </listitem>